x.com
X API
Query public X data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Extracts search tweets from X by keyword using Nitter as a public source, with salted hash anonymized author data, text, metrics, links, media and pagination by cursor.
GeckoAPI is independent of X. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search public posts
x.com:plp
Extracts search tweets from X by keyword using Nitter as a public source, with salted hash anonymized author data, text, metrics, links, media and pagination by cursor.
1 credit per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Make your first request
The example uses search public posts. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "openai",
"target": "x.com",
"type": "plp",
"page": 1
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "req_01HZXAMPLE0000000000000000",
"executionId": "exec_01HZXAMPLE0000000000000000",
"notFound": false,
"data": {
"source": "x.com",
"provider": "nitter.net",
"type": "plp",
"url": "https://nitter.net/search?f=tweets&q=openai",
"requestUrl": "https://nitter.net/search?f=tweets&q=openai",
"searchUrl": "https://nitter.net/search?f=tweets&q=openai",
"extractedAt": "2026-05-17T14:45:30.000Z",
"query": "openai",
"page": 1,
"resultsPerPage": 20,
"offset": 0,
"primaryResults": 20,
"totalResults": 0,
"hasMore": true,
"nextPage": 2,
"nextPageUrl": "https://nitter.net/search?f=tweets&q=openai&cursor=DAADDAABCgABExample",
"nextCursor": "DAADDAABCgABExample",
"exhaustedBeforePage": false
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the X API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.