{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Quote Tweets Scraper", "description": "Scrape the public quote tweets that cited any X/Twitter post URL or numeric ID. Each row includes the quote tweet's full text, author profile, engagement, media, and the original quoted post as context. No user cookies or X login required.", "version": "1.0", "x-build-id": "lBcvkz6kKQOo1bRrZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~x-twitter-quote-tweets-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-x-twitter-quote-tweets-scraper", "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/khadinakbar~x-twitter-quote-tweets-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-x-twitter-quote-tweets-scraper", "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/khadinakbar~x-twitter-quote-tweets-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-x-twitter-quote-tweets-scraper", "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", "required": [ "tweetUrls" ], "properties": { "tweetUrls": { "title": "Tweet URLs or IDs", "minItems": 1, "maxItems": 5, "type": "array", "description": "Use this when you need the quote tweets that cited specific X/Twitter posts. Accepts a post URL such as https://x.com/OpenAI/status/2065225362544726371 or its numeric ID. Provide from 1 to 5 posts; the actor reads quote tweets for each. This is not a profile URL, handle, hashtag, keyword, or replies/retweets field.", "items": { "type": "string" }, "default": [ "https://x.com/OpenAI/status/2065225362544726371" ] }, "maxQuotesPerTweet": { "title": "Max quotes per tweet", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to cap the number of quote-tweet rows kept for each supplied post, for example 50. The accepted range is 1 to 500 and the default is 100. This is a hard cap and the primary cost control; the actor never persists or charges beyond it. It does not guarantee every post has this many public quotes.", "default": 100 }, "maxPagesPerTweet": { "title": "Max pages per tweet", "minimum": 1, "maximum": 10, "type": "integer", "description": "Use this to control how many cursor-linked result pages the actor walks for each post, for example 5. Each page returns up to about 20 public quote tweets, so pages multiplied by 20 approximates the raw fetch depth before the hard result cap applies. The accepted range is 1 to 10 and the default is 3. This is not a per-page charge and does not exceed maxQuotesPerTweet.", "default": 3 }, "deduplicateQuotes": { "title": "Deduplicate quotes", "type": "boolean", "description": "Use this to avoid persisting the same quote-tweet ID twice when pagination returns a repeated entry. Defaults to true and compares the stable X tweet ID across the current run. Set it to false only when you intentionally want every source occurrence. This does not deduplicate similar text with different tweet IDs.", "default": true } } }, "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 } } } } } } } } } }