# Changelog

## 2026-10-19

- New: [`get_username_history`](/developers/endpoints/get_username_history/) returns 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_location`](/developers/endpoints/get_account_location/) returns 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-Key` header and as `Authorization: Bearer`; `?api_key=` unchanged.
- Authentication, account-lookup, rate-limit and unexpected errors carry `error.code` / `error.message` / `error.docs_url` next to the legacy `message` (see [Errors](/developers/errors/) for what does not yet).
- Per-minute limits are now counted per account (previously clients of a plan could share one counter).
- `429` responses for the per-minute limit include `Retry-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 answer `429`) after a 30-day notice here and by email to API customers.
- `Deprecation` header on responses to the `?api_key=` form (the form itself stays).
- Remote MCP server.