X / Twitter Profile

Public X (Twitter) profile for one handle: bio, follower and post counts, verification, links and pinned posts.

1 credit/ call

Never more than 2 credits a call.

You only pay when data comes back.

curl -X POST "https://api.primaryapi.com/v1/run/twitter.profile" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"nasa"}'

const res = await fetch('https://api.primaryapi.com/v1/run/twitter.profile', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PRIMARYAPI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ handle: 'nasa' }),
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.code}: ${body.error}`);

// found: false means "does not exist" and is still a success.
console.log(body.output.data, body.credits);

import os
import requests

res = requests.post(
    "https://api.primaryapi.com/v1/run/twitter.profile",
    headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"},
    json={"handle": "nasa"},
    timeout=60,
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['code']}: {body['error']}")

print(body["output"]["data"], body["credits"])

// MCP server: https://api.primaryapi.com/mcp (Streamable HTTP)
// Auth header: Authorization: Bearer $PRIMARYAPI_API_KEY
// The tool call your agent makes:
{
  "name": "run_api",
  "arguments": {
    "sku": "twitter.profile",
    "input": {
      "handle": "nasa"
    }
  }
}

Response · field types200 · 1 credit

{
  "output": {
    "found": true,
    "data": {
      "handle": "<string>",
      "displayName": "<string | null>",
      "followers": "<integer | null>",
      "verified": "<boolean | null>", …
    }
  },
  "credits": 1
}

Input and output

One handle in. One profile out.

Input. What you send.

1 field

handleRequired: X (Twitter) username, with or without the leading @. For example nasa.

Output. What comes back.

16 fields

handle: Screen name without @
displayName: Text.
bio: Text.
followers: A whole number.
verified: Blue check (X Premium) or legacy verification
pinnedPostIds: A list of ids.

All 16 fields in the API reference

Good to know

Two things to know before you call.

Suspended or missing accounts return found: false. A miss is an answer, not an error.
Private accounts are still found. Protected accounts are found with private: true.

More from X / Twitter. Same key, same credits.

All 10 X / Twitter APIs

Get X / Twitter data with one key.

Get an API key Try it in the Playground

The same key and credits work for every API.

import os import requests res = requests.post( "https://api.primaryapi.com/v1/run/twitter.profile", headers={"Authorization": f"Bearer {os.environ['PRIMARYAPI_API_KEY']}"}, json={"handle": "nasa"}, timeout=60, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['code']}: {body['error']}") print(body["output"]["data"], body["credits"])

// MCP server: https://api.primaryapi.com/mcp (Streamable HTTP) // Auth header: Authorization: Bearer $PRIMARYAPI_API_KEY // The tool call your agent makes: { "name": "run_api", "arguments": { "sku": "twitter.profile", "input": { "handle": "nasa" } } }

{ "output": { "found": true, "data": { "handle": "<string>", "displayName": "<string | null>", "followers": "<integer | null>", "verified": "<boolean | null>", … } }, "credits": 1 }