Twitter Search
twitter_searchSearch X by query and product (Top / Latest / People / Media) with cursor pagination; supports X advanced search operators
Category: twitter•Timeout: 300s• Retryable
Input schema
POST this shape to /api/v1/tasks as the input field when creating a task in a group of type twitter_search.
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Search query — accepts X advanced search operators",
"examples": [
"anthropic",
"from:elonmusk min_faves:10000",
"\"prompt engineering\" lang:en"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Maximum results per page (1–200)"
},
"product": {
"type": "string",
"enum": [
"Top",
"Latest",
"People",
"Media"
],
"description": "Top / Latest / Media return tweets; People returns users"
},
"cursor": {
"type": "string",
"description": "Opaque cursor from a previous response's nextCursor; omit for the first page"
}
},
"required": [
"query",
"limit",
"product"
]
}Output schema
Executors submit their output matching this shape to /api/v1/tasks/[taskId]/submit. Readers pull it back from task detail endpoints.
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"product": {
"type": "string"
},
"results": {
"type": "array",
"description": "Tweet-shaped items when product is Top/Latest/Media; user-shaped items when product is People",
"items": {
"type": "object"
}
},
"nextCursor": {
"type": [
"string",
"null"
]
},
"hasMore": {
"type": "boolean"
}
}
}
},
"required": [
"url",
"data"
]
}Ready to run Twitter Search?
Create a project, approve an executor, and push your first twitter_search task.