Changelog
2026-10-19
- New:
get_username_historyreturns the previous usernames (handles) of an account, newest first, each with the time the rename was detected (accounts TwitterScore tracks: since 2025-03-13). - New:
get_account_locationreturns the country or region X shows for an account in "About this account", its ISO 3166-1 alpha-2 code, X's accuracy flag, "Connected via" and the free-text profile location.
2026-10-04
- Keys accepted in the
X-API-Keyheader and asAuthorization: Bearer;?api_key=unchanged. - Authentication, account-lookup, rate-limit and unexpected errors carry
error.code/error.message/error.docs_urlnext to the legacymessage(see Errors for what does not yet). - Per-minute limits are now counted per account (previously clients of a plan could share one counter).
429responses for the per-minute limit includeRetry-After: 60.- OpenAPI 3.1 description published at
/openapi.json; this documentation at/developers/; API section in/llms.txt.
Planned
- Real HTTP statuses for errors (
401/403/404/400/405/500; the two rate limits already answer429) after a 30-day notice here and by email to API customers. Deprecationheader on responses to the?api_key=form (the form itself stays).- Remote MCP server.
This page as Markdown.