X API - Profile

X profile API

Get any public X profile as JSON: followers, following, posts, verified flag. One call by handle or user ID, $0.003.

By the Social Data API team · November 8, 2026 · 1 min read

Live now

Get any public X profile as JSON with one call: handle, display name, follower and following counts, post count, verified flag and bio. Pass a handle or a numeric user id, no X developer account needed.

The official X API charges $0.010 per user read, which is $10.00 per 1,000 profiles. Here one profile costs $0.003.

The call

One API key works for every endpoint below. Send your key in the x-api-key header.

curl -X POST https://social-data-api.chideraezeudu2.workers.dev/v1/x/profile \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "example_handle"}'

Profile takes username (handle, without @) or user_id (numeric X user id). One call costs 1 credit.

What you get back

{
  "platform": "x",
  "endpoint": "x.profile",
  "credits_used": 1,
  "upstream_cost_usd_per_call": 0.001,
  "key_id": "...",
  "plan_type": "monthly_29",
  "result": { "...": "upstream profile data" }
}

Response shape, example values only, not real data. Every response uses this wrapper. The result field holds the upstream provider's data, in its own shape. credits_used tells you what the call cost.

How it compares

Single-platform X vendors can be cheaper per call. Our edge is one key for TikTok and X, one bill, monthly or pay as you go, and a price per 1,000 profiles in plain dollars.

How it works

1. Get one API key from the Social Data API dashboard. The same key works for TikTok, X, Instagram and Reddit.
2. Send the call above with your key in the x-api-key header.
3. Use the JSON. List endpoints take count (default 20 results per call, max 50) and cursor for the next page.

Frequently asked questions

Can I get any public profile?

Yes. Pass any public handle as username and you get that profile back. Private accounts return nothing, the same as on X itself.

What fields come back?

Handle, display name, follower and following counts, post count, verified flag and bio, in the upstream profile data.

Handle or user ID, which should I use?

Either. Use the handle if that is what you have, use user_id if you already have the numeric id. Same price, 1 credit.

How much do 1,000 profiles cost?

1,000 calls at $0.003, which is $3.00 on pay as you go, $2.90 on Basic, or $1.98 on Pro. The official X API charges $10.00 for the same 1,000 user reads.

Prices checked on 2026-11-08. Instagram is next after X, then Reddit, all on the same single API key.