{ "openapi": "3.0.1", "info": { "title": "Twitter Trends Scraper", "description": "Twitter Trends Scraper helps you collect trending topics and hashtags from Twitter in real time. Extract trend names, tweet volume, locations, and related metadata for market research, brand monitoring, content planning, and social media analysis.", "version": "0.2", "x-build-id": "0anFMBlMhEY97aAAz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~Twitter-Trends-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-Twitter-Trends-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/api-empire~Twitter-Trends-Scraper/runs": { "post": { "operationId": "runs-sync-api-empire-Twitter-Trends-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/api-empire~Twitter-Trends-Scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-Twitter-Trends-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", "properties": { "live": { "title": "Live", "type": "boolean", "description": "Scrape the current live trends." }, "hour1": { "title": "1 hour ago", "type": "boolean", "description": "Scrape trends from 1 hour ago." }, "hour2": { "title": "2 hours ago", "type": "boolean", "description": "Scrape trends from 2 hours ago." }, "hour3": { "title": "3 hours ago", "type": "boolean", "description": "Scrape trends from 3 hours ago." }, "hour4": { "title": "4 hours ago", "type": "boolean", "description": "Scrape trends from 4 hours ago." }, "hour5": { "title": "5 hours ago", "type": "boolean", "description": "Scrape trends from 5 hours ago." }, "hour6": { "title": "6 hours ago", "type": "boolean", "description": "Scrape trends from 6 hours ago." }, "hour7": { "title": "7 hours ago", "type": "boolean", "description": "Scrape trends from 7 hours ago." }, "hour8": { "title": "8 hours ago", "type": "boolean", "description": "Scrape trends from 8 hours ago." }, "hour9": { "title": "9 hours ago", "type": "boolean", "description": "Scrape trends from 9 hours ago." }, "hour10": { "title": "10 hours ago", "type": "boolean", "description": "Scrape trends from 10 hours ago." }, "hour11": { "title": "11 hours ago", "type": "boolean", "description": "Scrape trends from 11 hours ago." }, "hour12": { "title": "12 hours ago", "type": "boolean", "description": "Scrape trends from 12 hours ago." }, "hour13": { "title": "13 hours ago", "type": "boolean", "description": "Scrape trends from 13 hours ago." }, "hour14": { "title": "14 hours ago", "type": "boolean", "description": "Scrape trends from 14 hours ago." }, "hour15": { "title": "15 hours ago", "type": "boolean", "description": "Scrape trends from 15 hours ago." }, "hour16": { "title": "16 hours ago", "type": "boolean", "description": "Scrape trends from 16 hours ago." }, "hour17": { "title": "17 hours ago", "type": "boolean", "description": "Scrape trends from 17 hours ago." }, "hour18": { "title": "18 hours ago", "type": "boolean", "description": "Scrape trends from 18 hours ago." }, "hour19": { "title": "19 hours ago", "type": "boolean", "description": "Scrape trends from 19 hours ago." }, "hour20": { "title": "20 hours ago", "type": "boolean", "description": "Scrape trends from 20 hours ago." }, "hour21": { "title": "21 hours ago", "type": "boolean", "description": "Scrape trends from 21 hours ago." }, "hour22": { "title": "22 hours ago", "type": "boolean", "description": "Scrape trends from 22 hours ago." }, "hour23": { "title": "23 hours ago", "type": "boolean", "description": "Scrape trends from 23 hours ago." }, "yesterday": { "title": "Yesterday", "type": "boolean", "description": "Scrape yesterday's full-day summary." }, "weekAgo": { "title": "Week Ago", "type": "boolean", "description": "Scrape trends from 1 week ago." }, "monthAgo": { "title": "Month Ago", "type": "boolean", "description": "Scrape trends from 1 month ago." }, "yearAgo": { "title": "Year Ago", "type": "boolean", "description": "Scrape trends from 1 year ago." }, "day2": { "title": "Day 2 (Yesterday) - Legacy", "type": "boolean", "description": "Scrape yesterday's full-day summary (legacy option, same as 'yesterday')." }, "day3": { "title": "Day 3", "type": "boolean", "description": "Scrape the summary from 2 days ago." }, "country": { "title": "Country", "enum": [ "", "DZ", "AR", "AU", "AT", "BH", "BY", "BE", "BR", "CA", "CL", "CO", "DK", "DO", "EC", "EG", "FR", "DE", "GH", "GR", "GT", "IN", "ID", "IE", "IL", "IT", "JP", "JO", "KE", "KR", "KW", "LV", "LB", "MY", "MX", "NL", "NZ", "NG", "NO", "OM", "PK", "PA", "PE", "PH", "PL", "PT", "PR", "QA", "RU", "SA", "SG", "ZA", "ES", "SE", "CH", "TH", "TR", "UA", "AE", "GB", "US", "VE", "VN" ], "type": "string", "description": "Select a country to scrape country-specific Twitter trends. Leave empty for worldwide trends.", "default": "" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Defaults to no proxy. If the selected proxy is rejected, the actor falls back to Apify RESIDENTIAL automatically." } } }, "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 } } } } } } } } } }