Skip to main content
POST
X Account Location API

X Account Location

Read the “About this account” panel X shows on profiles. For each username you get the country or region X lists as where the account is based, how the account connects to X (for example United States App Store or Web), the date it joined, how many times it has changed its username and the organization it is affiliated with. These details come from X’s own account records, which makes them useful for vetting influencers, spotting coordinated accounts and checking where an audience really comes from.
Provide X usernames in usernames, with or without @. Each account returns one row with the country it is based in, how it connects to X, its join date and username change count. Some accounts, such as many government and public-interest accounts, have no country on X; they still return a row with country set to null.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide X usernames in usernames, with or without @. Each account returns one row with the country it is based in, how it connects to X, its join date and username change count.

usernames
string[]
required

Public account usernames.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object