API Reference
GET /v1/twitter/search

GET /v1/twitter/search

Search for tweets matching a query. Returns up to 20 tweets per request with pagination support.

Cost: $0.01 per call — X API would charge $0.10 for the same 20 tweets ($0.005 each)

curl "https://frontrun.vc/v1/twitter/search?q=AI%20funding%20round&type=Latest" \
  -H "X-API-Key: your_api_key"

Parameters

ParameterTypeDefaultDescription
qstring (query)--Search query (required)
typestring (query)LatestSort order: Latest or Top
cursorstring (query)--Pagination cursor from previous response

Response

{
  "query": "AI funding round",
  "count": 20,
  "cursor": "scroll:abc123...",
  "data": [
    {
      "id": "1234567890",
      "text": "Excited to announce our $50M Series B...",
      "author": {
        "id": "111222333",
        "userName": "ai_startup",
        "name": "AI Startup",
        "followers": 15000,
        "isBlueVerified": true
      },
      "createdAt": "Thu Mar 13 18:45:00 +0000 2026",
      "likes": 245,
      "retweets": 67
    }
  ],
  "cost_cents": 1,
  "balance_cents": 9899
}