Instant Access

Need social media data? You’re two HTTP calls away from real results. Generate a free token, then start pulling structured data — profiles, posts, comments, and communities across Twitter/X, Instagram, Reddit, and TikTok. No signup, no credit card, no OAuth, no approval process.

Why start here

This is the fastest way to see what Xpoz returns. You’ll have a working API key in under a second — every read tool works immediately across all four platforms: user lookups, post searches, comment threads, and community discovery. Same structured data, same API shape as a full access key.

Get started

cURL
CLI
MCP (Claude Code)

Generate a free token, then use it as your API key:

# 1. Generate a free token (valid 5 days)
TOKEN=$(curl -s -X POST https://api.xpoz.ai/api/trial/token -H "Content-Type: application/json" -d '{"source":"docs"}' | jq -r .data.accessKey)

# 2. Use it like any access key
curl -X POST https://mcp.xpoz.ai/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"getTwitterUser","arguments":{"identifier":"elonmusk","identifierType":"username"}},"id":1}'

export XPOZ_API_KEY=$(curl -s -X POST https://api.xpoz.ai/api/trial/token -H "Content-Type: application/json" -d '{"source":"docs"}' | jq -r .data.accessKey)
xpoz-cli twitter get_user --identifier elonmusk

TOKEN=$(curl -s -X POST https://api.xpoz.ai/api/trial/token -H "Content-Type: application/json" -d '{"source":"docs"}' | jq -r .data.accessKey)
claude mcp add xpoz-mcp https://mcp.xpoz.ai/mcp \
  -t http \
  -H "Authorization: Bearer $TOKEN"

The request requires a source field identifying where the token was requested from (e.g. skills, a specific page, sdk, cli). The token endpoint needs no auth and hands back a key that starts with TRIAL:

{
  "success": true,
  "data": { "accessKey": "TRIAL...", "expiresInSeconds": 432000 },
  "message": "Trial access token created."
}

Drop the TRIAL... token in wherever an access key goes — the SDK apiKey, the XPOZ_API_KEY env var, or a Bearer header.

Zero-change upgrade

The response format is identical to a full access key — same fields, same shape, same structure. When you’re ready to upgrade, swap the token and keep everything else. Your code doesn’t change.

What you get

All read tools work instantly across every platform. The only differences from a full access key are result volume and advanced features:

	Instant access	Full access key
Data tools (read)	✅ All 4 platforms	✅ All 4 platforms
Results per call	Up to 5	Full, paginated
Pagination	—	✅
CSV export	—	✅
Live crawling	—	✅
Validity	5 days	Ongoing

Ready for full access

Need larger result sets, pagination, or CSV export? Get a free access key — still no credit card. The request and response shapes are unchanged, so there’s nothing to rewrite.

Quickstart

Start querying with your token

Authentication

Access keys, Google sign-in, bearer tokens

Getting Started

Guides

Instant Access

Why start here

Get started

Zero-change upgrade

What you get

Ready for full access

Quickstart

Authentication

​Why start here

​Get started

​Zero-change upgrade

​What you get

​Ready for full access

Quickstart

Authentication

Why start here

Get started

Zero-change upgrade

What you get

Ready for full access