Users

Get users by ids

GET /v1/users/batch reads 1 per id credits

Profiles for up to 50 accounts by numeric id in one call. Costs 1 credit per id requested.

Query parameters

Query parameterTypeMeaning
ids *string (1–50 ids)Comma-separated numeric account ids, 1–50

response

items holds the profiles found, in the order of the request; missing lists the ids that resolved to no account.

Status: 200, 400, 429, 502

request
curl https://api.xsignalfeed.com/v1/users/batch?ids=1652541,11348282,999999999999999999 \
  -H "Authorization: Bearer xsf_your_key"
response · 200 / 400
{
  "items": [
    {
      "id": "1652541",
      "name": "Reuters",
      "screen_name": "Reuters",
      "bio": "Top and breaking news, pictures and videos from Reuters…",
      "location": "Around the world",
      "url": "https://t.co/…",
      "avatar": "https://pbs.twimg.com/profile_images/…",
      "banner": "https://pbs.twimg.com/profile_banners/1652541/…",
      "pinned": null,
      "verified": true,
      "protected": false,
      "followers": 26367695,
      "following": 1195,
      "tweets": 1395836
    },
    {
      "id": "11348282",
      "name": "NASA",
      "screen_name": "NASA",
      "bio": "Making the seemingly impossible, possible. ✨",
      "location": "Pale Blue Dot",
      "…": "…"
    }
  ],
  "missing": [
    "999999999999999999"
  ]
}