{ "openapi": "3.0.1", "info": { "title": "Twitter (X) Trends Scraper (PPE)", "description": "Scrape real-time Twitter/X trends from any country or city. Get top 50 trending hashtags, tweet counts, and hourly history. Ideal for social media monitoring, viral topic tracking, and market research. Fast, reliable, and supports granular location data.", "version": "0.0", "x-build-id": "QLpuOYTggw6xWdWg5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eunit~x-twitter-trends-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eunit-x-twitter-trends-ppe", "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/eunit~x-twitter-trends-ppe/runs": { "post": { "operationId": "runs-sync-eunit-x-twitter-trends-ppe", "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/eunit~x-twitter-trends-ppe/run-sync": { "post": { "operationId": "run-sync-eunit-x-twitter-trends-ppe", "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": [ "country" ], "properties": { "country": { "title": "Country / City", "enum": [ "Worldwide", "algeria", "algeria/algiers", "argentina", "argentina/buenos-aires", "argentina/cordoba", "argentina/mendoza", "argentina/rosario", "australia", "australia/adelaide", "australia/brisbane", "australia/canberra", "australia/darwin", "australia/melbourne", "australia/perth", "australia/sydney", "austria", "austria/vienna", "bahrain", "belarus", "belarus/brest", "belarus/gomel", "belarus/grodno", "belarus/minsk", "belgium", "brazil", "brazil/belem", "brazil/belo-horizonte", "brazil/brasilia", "brazil/campinas", "brazil/curitiba", "brazil/fortaleza", "brazil/goiania", "brazil/guarulhos", "brazil/manaus", "brazil/porto-alegre", "brazil/recife", "brazil/rio-de-janeiro", "brazil/salvador", "brazil/sao-luis", "brazil/sao-paulo", "canada", "canada/calgary", "canada/edmonton", "canada/montreal", "canada/ottawa", "canada/quebec", "canada/toronto", "canada/vancouver", "canada/winnipeg", "chile", "chile/concepcion", "chile/santiago", "chile/valparaiso", "colombia", "colombia/barranquilla", "colombia/bogota", "colombia/cali", "colombia/medellin", "denmark", "dominican-republic", "dominican-republic/santo-domingo", "ecuador", "ecuador/guayaquil", "ecuador/quito", "egypt", "egypt/alexandria", "egypt/cairo", "egypt/giza", "france", "france/bordeaux", "france/lille", "france/lyon", "france/marseille", "france/montpellier", "france/nantes", "france/paris", "france/rennes", "france/strasbourg", "france/toulouse", "germany", "germany/berlin", "germany/bremen", "germany/cologne", "germany/dortmund", "germany/dresden", "germany/dusseldorf", "germany/essen", "germany/frankfurt", "germany/hamburg", "germany/leipzig", "germany/munich", "germany/stuttgart", "ghana", "ghana/accra", "ghana/kumasi", "greece", "greece/athens", "greece/thessaloniki", "guatemala", "guatemala/guatemala-city", "india", "india/ahmedabad", "india/amritsar", "india/bangalore", "india/bhopal", "india/chennai", "india/delhi", "india/hyderabad", "india/indore", "india/jaipur", "india/kanpur", "india/kolkata", "india/lucknow", "india/mumbai", "india/nagpur", "india/patna", "india/pune", "india/rajkot", "india/ranchi", "india/srinagar", "india/surat", "india/thane", "indonesia", "indonesia/bandung", "indonesia/bekasi", "indonesia/depok", "indonesia/jakarta", "indonesia/makassar", "indonesia/medan", "indonesia/palembang", "indonesia/pekanbaru", "indonesia/semarang", "indonesia/surabaya", "indonesia/tangerang", "ireland", "ireland/cork", "ireland/dublin", "ireland/galway", "israel", "israel/haifa", "israel/jerusalem", "israel/tel-aviv", "italy", "italy/bologna", "italy/genoa", "italy/milan", "italy/naples", "italy/palermo", "italy/rome", "italy/turin", "japan", "japan/chiba", "japan/fukuoka", "japan/hamamatsu", "japan/hiroshima", "japan/kawasaki", "japan/kitakyushu", "japan/kobe", "japan/kumamoto", "japan/kyoto", "japan/nagoya", "japan/niigata", "japan/okayama", "japan/okinawa", "japan/osaka", "japan/sagamihara", "japan/saitama", "japan/sapporo", "japan/sendai", "japan/takamatsu", "japan/tokyo", "japan/yokohama", "jordan", "jordan/amman", "kenya", "kenya/mombasa", "kenya/nairobi", "korea", "korea/ansan", "korea/bucheon", "korea/busan", "korea/changwon", "korea/daegu", "korea/daejeon", "korea/goyang", "korea/gwangju", "korea/incheon", "korea/seongnam", "korea/seoul", "korea/suwon", "korea/ulsan", "korea/yongin", "kuwait", "latvia", "latvia/riga", "lebanon", "malaysia", "malaysia/hulu-langat", "malaysia/ipoh", "malaysia/johor-bahru", "malaysia/kajang", "malaysia/klang", "malaysia/kuala-lumpur", "malaysia/petaling", "mexico", "mexico/acapulco", "mexico/aguascalientes", "mexico/chihuahua", "mexico/ciudad-juarez", "mexico/culiacan", "mexico/ecatepec-de-morelos", "mexico/guadalajara", "mexico/hermosillo", "mexico/leon", "mexico/merida", "mexico/mexicali", "mexico/mexico-city", "mexico/monterrey", "mexico/morelia", "mexico/naucalpan-de-juarez", "mexico/nezahualcoyotl", "mexico/puebla", "mexico/queretaro", "mexico/saltillo", "mexico/san-luis-potosi", "mexico/tijuana", "mexico/toluca", "mexico/zapopan", "netherlands", "netherlands/amsterdam", "netherlands/den-haag", "netherlands/rotterdam", "netherlands/utrecht", "new-zealand", "new-zealand/auckland", "nigeria", "nigeria/benin-city", "nigeria/ibadan", "nigeria/kaduna", "nigeria/kano", "nigeria/lagos", "nigeria/port-harcourt", "norway", "norway/bergen", "norway/oslo", "oman", "oman/muscat", "pakistan", "pakistan/faisalabad", "pakistan/karachi", "pakistan/lahore", "pakistan/multan", "pakistan/rawalpindi", "panama", "peru", "peru/lima", "philippines", "philippines/antipolo", "philippines/cagayan-de-oro", "philippines/calocan", "philippines/cebu-city", "philippines/davao-city", "philippines/makati", "philippines/manila", "philippines/pasig", "philippines/quezon-city", "philippines/taguig", "philippines/zamboanga-city", "poland", "poland/gdansk", "poland/krakow", "poland/lodz", "poland/poznan", "poland/warsaw", "poland/wroclaw", "portugal", "puerto-rico", "qatar", "russia", "russia/chelyabinsk", "russia/irkutsk", "russia/kazan", "russia/khabarovsk", "russia/krasnodar", "russia/krasnoyarsk", "russia/moscow", "russia/nizhny-novgorod", "russia/novosibirsk", "russia/omsk", "russia/perm", "russia/rostov-on-don", "russia/saint-petersburg", "russia/samara", "russia/ufa", "russia/vladivostok", "russia/volgograd", "russia/voronezh", "russia/yekaterinburg", "saudi-arabia", "saudi-arabia/ahsa", "saudi-arabia/dammam", "saudi-arabia/jeddah", "saudi-arabia/mecca", "saudi-arabia/medina", "saudi-arabia/riyadh", "singapore", "singapore/singapore", "south-africa", "south-africa/cape-town", "south-africa/durban", "south-africa/johannesburg", "south-africa/port-elizabeth", "south-africa/pretoria", "south-africa/soweto", "spain", "spain/barcelona", "spain/bilbao", "spain/las-palmas", "spain/madrid", "spain/malaga", "spain/murcia", "spain/palma", "spain/seville", "spain/valencia", "spain/zaragoza", "sweden", "sweden/gothenburg", "sweden/stockholm", "switzerland", "switzerland/geneva", "switzerland/lausanne", "switzerland/zurich", "thailand", "thailand/bangkok", "turkey", "turkey/adana", "turkey/ankara", "turkey/antalya", "turkey/bursa", "turkey/diyarbakir", "turkey/eskisehir", "turkey/gaziantep", "turkey/istanbul", "turkey/izmir", "turkey/kayseri", "turkey/konya", "turkey/mersin", "ukraine", "ukraine/dnipropetrovsk", "ukraine/donetsk", "ukraine/kharkiv", "ukraine/kyiv", "ukraine/lviv", "ukraine/odesa", "ukraine/zaporozhye", "united-arab-emirates", "united-arab-emirates/abu-dhabi", "united-arab-emirates/dubai", "united-arab-emirates/sharjah", "united-kingdom", "united-kingdom/belfast", "united-kingdom/birmingham", "united-kingdom/blackpool", "united-kingdom/bournemouth", "united-kingdom/brighton", "united-kingdom/bristol", "united-kingdom/cardiff", "united-kingdom/coventry", "united-kingdom/derby", "united-kingdom/edinburgh", "united-kingdom/glasgow", "united-kingdom/hull", "united-kingdom/leeds", "united-kingdom/leicester", "united-kingdom/liverpool", "united-kingdom/london", "united-kingdom/manchester", "united-kingdom/middlesbrough", "united-kingdom/newcastle", "united-kingdom/nottingham", "united-kingdom/plymouth", "united-kingdom/portsmouth", "united-kingdom/preston", "united-kingdom/sheffield", "united-kingdom/stoke-on-trent", "united-kingdom/swansea", "united-states", "united-states/albuquerque", "united-states/atlanta", "united-states/austin", "united-states/baltimore", "united-states/baton-rouge", "united-states/birmingham", "united-states/boston", "united-states/charlotte", "united-states/chicago", "united-states/cincinnati", "united-states/cleveland", "united-states/colorado-springs", "united-states/columbus", "united-states/dallas-ft-worth", "united-states/denver", "united-states/detroit", "united-states/el-paso", "united-states/fresno", "united-states/greensboro", "united-states/harrisburg", "united-states/honolulu", "united-states/houston", "united-states/indianapolis", "united-states/jackson", "united-states/jacksonville", "united-states/kansas-city", "united-states/las-vegas", "united-states/long-beach", "united-states/los-angeles", "united-states/louisville", "united-states/memphis", "united-states/mesa", "united-states/miami", "united-states/milwaukee", "united-states/minneapolis", "united-states/nashville", "united-states/new-haven", "united-states/new-orleans", "united-states/new-york", "united-states/norfolk", "united-states/oklahoma-city", "united-states/omaha", "united-states/orlando", "united-states/philadelphia", "united-states/phoenix", "united-states/pittsburgh", "united-states/portland", "united-states/providence", "united-states/raleigh", "united-states/richmond", "united-states/sacramento", "united-states/salt-lake-city", "united-states/san-antonio", "united-states/san-diego", "united-states/san-francisco", "united-states/san-jose", "united-states/seattle", "united-states/st-louis", "united-states/tallahassee", "united-states/tampa", "united-states/tucson", "united-states/virginia-beach", "united-states/washington", "venezuela", "venezuela/barcelona", "venezuela/barquisimeto", "venezuela/caracas", "venezuela/ciudad-guayana", "venezuela/maracaibo", "venezuela/maracay", "venezuela/maturin", "venezuela/turmero", "venezuela/valencia", "vietnam", "vietnam/can-tho", "vietnam/da-nang", "vietnam/hai-phong", "vietnam/hanoi", "vietnam/ho-chi-minh-city" ], "type": "string", "description": "Select the location to scrape trends for.", "default": "Worldwide" } } }, "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 } } } } } } } } } }