API Documentation

Real-time access to Twitter and Threads data. All endpoints use POST with JSON body.

Full interactive documentation with Try It is available when you sign up for free.

0.1–1.2s

Per post. Live parsing, not cached data.

No limits

No max result caps. Fetch as many posts as exist.

Dedup billing

Same post fetched twice? Billed once.

Quick Start

Create an account and get your API key
Add X-API-Key: your_key header
Send POST requests with JSON body

curl -X POST https://query-data-api.notpeople.ai/v1/twitter/search \
  -H "X-API-Key: your_key" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["AI agents"], "min_faves": 100, "limit": 50}'

Response Format

Every response includes your usage stats so you always know where you stand.

{
  "success": true,
  "data": [ ... ],          // Array or object depending on endpoint
  "metadata": {             // Search endpoints only
    "queries": ["(AI agents) since:2026-03-25"],
    "total_found": 50,
    "duplicates_removed": 3,
    "type_breakdown": { "tweet": 38, "quote": 10, "reply": 2 }
  },
  "usage": {
    "unique_posts": 1523,   // Your total this period
    "limit": 10000,         // Your plan limit
    "remaining": 8477       // Units left
  }
}

Twitter API

7 endpoints covering search, profiles, posts, comments, and social graph.

POSTSearch

/v1/twitter/search

Search by keywords, hashtags, users, filters

POSTUser Profile

/v1/twitter/user

Full profile with follower counts, bio

POSTUser Posts

/v1/twitter/user/posts

Threads API

Same structure as Twitter. Includes view counts and reply filtering.

POSTSearch

/v1/threads/search

Search posts by query

POSTUser Profile

/v1/threads/user

Full profile data

POSTUser Posts

/v1/threads/user/posts

Rate Limits & Pricing

Plan	Price	Units/month	Requests/min
Free	$0	1,000	60
Starter	$29	10,000	60
Pro	$99	50,000	60
Enterprise	$299	500,000	120

1 unit = 1 unique post. Same post fetched multiple times counts as 1 unit. Need more? Buy unit packs starting at $10 for 5,000 units.

Error Codes

Code	Meaning
401	Missing or invalid API key
403	Key doesn't match the requested platform
429	Rate limit or post limit exceeded
502	Upstream service error
504	Upstream timeout (try again)