X/Twitter search Tweets scrapper
Pricing
$0.30 / 1,000 results
Collect tweets for any topic and filter them to keep only useful, analysis-ready results.
Pricing
$0.30 / 1,000 results
Rating
0.0
(0)
Developer
simoit
Maintained by CommunityActor stats
1
Bookmarked
14
Total users
8
Monthly active users
9 hours ago
Last modified
Categories
Share
You can access the X/Twitter search Tweets scrapper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "wruPwVhXbO6dWyCGM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simoit~x-twitter-search-tweets-scrapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simoit-x-twitter-search-tweets-scrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/simoit~x-twitter-search-tweets-scrapper/runs": { "post": { "operationId": "runs-sync-simoit-x-twitter-search-tweets-scrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/simoit~x-twitter-search-tweets-scrapper/run-sync": { "post": { "operationId": "run-sync-simoit-x-twitter-search-tweets-scrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search terms", "type": "string", "description": "Search phrase or multiple queries (comma/newline)." }, "conversationIds": { "title": "Conversation IDs", "type": "string", "description": "Conversation IDs, comma-separated or new lines. Converted to conversation_id:<id> queries." }, "startUrls": { "title": "Start URLs", "type": "string", "description": "Optional X/Twitter search URLs (comma-separated or new lines). Search URLs infer query." }, "sort": { "title": "Sort", "enum": [ "latest", "top" ], "type": "string", "description": "Result sorting mode.", "default": "latest" }, "fromUsers": { "title": "From users", "type": "string", "description": "CSV usernames for from: filter." }, "toUsers": { "title": "To users", "type": "string", "description": "CSV usernames for to: filter." }, "mentioningUsers": { "title": "Mentioning users", "type": "string", "description": "CSV usernames that should be mentioned." }, "startDate": { "title": "Start date", "type": "string", "description": "Start date. Accepts YYYY-MM-DD, D/M/YYYY, or M/D/YYYY and is normalized automatically." }, "endDate": { "title": "End date", "type": "string", "description": "End date. Accepts YYYY-MM-DD, D/M/YYYY, or M/D/YYYY and is normalized automatically." }, "minimumLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Minimum likes count." }, "minimumRetweets": { "title": "Minimum retweets", "minimum": 0, "type": "integer", "description": "Minimum retweets count." }, "minimumReplies": { "title": "Minimum replies", "minimum": 0, "type": "integer", "description": "Minimum replies count." }, "onlyImage": { "title": "Only image", "type": "boolean", "description": "Only tweets with images.", "default": false }, "onlyVideo": { "title": "Only video", "type": "boolean", "description": "Only tweets with videos.", "default": false }, "onlyVerifiedUsers": { "title": "Only verified users", "type": "boolean", "description": "Only tweets from verified accounts.", "default": false }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Include reply tweets.", "default": true }, "includeRetweets": { "title": "Include retweets", "type": "boolean", "description": "Include retweets.", "default": true }, "withinRadius": { "title": "Within radius", "type": "string", "description": "Geocode in lat,lon,radius format (for example 52.23,21.01,10km)." }, "page": { "title": "Page", "minimum": 1, "type": "integer", "description": "Starting page number.", "default": 1 }, "limit": { "title": "Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Items per page.", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Maximum number of pages to fetch.", "default": 1 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum number of output items to push." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for X/Twitter search Tweets scrapper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: