{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Trends Scraper by Country & City", "description": "Discover current X (Twitter) trends worldwide, by country, or by city. Export up to 50 ranked topics per location with search links and X snapshot times for regional research, content planning, and scheduled reports. No X login, API key, or proxy setup required.", "version": "0.1", "x-build-id": "T6w18H2y3nEGYjqwU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arjun_code~x-twitter-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arjun_code-x-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/arjun_code~x-twitter-trends-scraper/runs": { "post": { "operationId": "runs-sync-arjun_code-x-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/arjun_code~x-twitter-trends-scraper/run-sync": { "post": { "operationId": "run-sync-arjun_code-x-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": { "countries": { "title": "Countries or Worldwide", "type": "array", "description": "Select one or more countries, or Worldwide. You can also select cities below. If both fields are empty, Worldwide is collected.", "items": { "type": "string", "enum": [ "Worldwide", "Algeria (DZ)", "Argentina (AR)", "Australia (AU)", "Austria (AT)", "Bahrain (BH)", "Belarus (BY)", "Belgium (BE)", "Brazil (BR)", "Canada (CA)", "Chile (CL)", "Colombia (CO)", "Denmark (DK)", "Dominican Republic (DO)", "Ecuador (EC)", "Egypt (EG)", "France (FR)", "Germany (DE)", "Ghana (GH)", "Greece (GR)", "Guatemala (GT)", "India (IN)", "Indonesia (ID)", "Ireland (IE)", "Israel (IL)", "Italy (IT)", "Japan (JP)", "Jordan (JO)", "Kenya (KE)", "Korea (KR)", "Kuwait (KW)", "Latvia (LV)", "Lebanon (LB)", "Malaysia (MY)", "Mexico (MX)", "Netherlands (NL)", "New Zealand (NZ)", "Nigeria (NG)", "Norway (NO)", "Oman (OM)", "Pakistan (PK)", "Panama (PA)", "Peru (PE)", "Philippines (PH)", "Poland (PL)", "Portugal (PT)", "Puerto Rico (PR)", "Qatar (QA)", "Russia (RU)", "Saudi Arabia (SA)", "Singapore (SG)", "South Africa (ZA)", "Spain (ES)", "Sweden (SE)", "Switzerland (CH)", "Thailand (TH)", "Turkey (TR)", "Ukraine (UA)", "United Arab Emirates (AE)", "United Kingdom (GB)", "United States (US)", "Venezuela (VE)", "Vietnam (VN)" ] }, "default": [] }, "cities": { "title": "Cities", "type": "array", "description": "Select one or more cities. Each option includes its country to distinguish cities with the same name. Country and city selections are independent.", "items": { "type": "string", "enum": [ "Abu Dhabi — United Arab Emirates (AE)", "Acapulco — Mexico (MX)", "Accra — Ghana (GH)", "Adana — Turkey (TR)", "Adelaide — Australia (AU)", "Aguascalientes — Mexico (MX)", "Ahmedabad — India (IN)", "Albuquerque — United States (US)", "Alexandria — Egypt (EG)", "Algiers — Algeria (DZ)", "Amman — Jordan (JO)", "Amritsar — India (IN)", "Amsterdam — Netherlands (NL)", "Ankara — Turkey (TR)", "Ansan — Korea (KR)", "Antalya — Turkey (TR)", "Antipolo — Philippines (PH)", "Athens — Greece (GR)", "Atlanta — United States (US)", "Auckland — New Zealand (NZ)", "Austin — United States (US)", "Baltimore — United States (US)", "Bandung — Indonesia (ID)", "Bangalore — India (IN)", "Bangkok — Thailand (TH)", "Barcelona — Spain (ES)", "Barcelona — Venezuela (VE)", "Barquisimeto — Venezuela (VE)", "Barranquilla — Colombia (CO)", "Baton Rouge — United States (US)", "Bekasi — Indonesia (ID)", "Belfast — United Kingdom (GB)", "Belo Horizonte — Brazil (BR)", "Belém — Brazil (BR)", "Benin City — Nigeria (NG)", "Bergen — Norway (NO)", "Berlin — Germany (DE)", "Bhopal — India (IN)", "Bilbao — Spain (ES)", "Birmingham — United Kingdom (GB)", "Birmingham — United States (US)", "Blackpool — United Kingdom (GB)", "Bogotá — Colombia (CO)", "Bologna — Italy (IT)", "Bordeaux — France (FR)", "Boston — United States (US)", "Bournemouth — United Kingdom (GB)", "Brasília — Brazil (BR)", "Bremen — Germany (DE)", "Brest — Belarus (BY)", "Brighton — United Kingdom (GB)", "Brisbane — Australia (AU)", "Bristol — United Kingdom (GB)", "Bucheon — Korea (KR)", "Buenos Aires — Argentina (AR)", "Bursa — Turkey (TR)", "Busan — Korea (KR)", "Cagayan de Oro — Philippines (PH)", "Cairo — Egypt (EG)", "Calgary — Canada (CA)", "Cali — Colombia (CO)", "Calocan — Philippines (PH)", "Campinas — Brazil (BR)", "Can Tho — Vietnam (VN)", "Canberra — Australia (AU)", "Cape Town — South Africa (ZA)", "Caracas — Venezuela (VE)", "Cardiff — United Kingdom (GB)", "Cebu City — Philippines (PH)", "Changwon — Korea (KR)", "Charlotte — United States (US)", "Chelyabinsk — Russia (RU)", "Chennai — India (IN)", "Chiba — Japan (JP)", "Chicago — United States (US)", "Chihuahua — Mexico (MX)", "Cincinnati — United States (US)", "Ciudad Guayana — Venezuela (VE)", "Ciudad Juarez — Mexico (MX)", "Cleveland — United States (US)", "Cologne — Germany (DE)", "Colorado Springs — United States (US)", "Columbus — United States (US)", "Concepcion — Chile (CL)", "Cork — Ireland (IE)", "Coventry — United Kingdom (GB)", "Culiacán — Mexico (MX)", "Curitiba — Brazil (BR)", "Córdoba — Argentina (AR)", "Da Nang — Vietnam (VN)", "Daegu — Korea (KR)", "Daejeon — Korea (KR)", "Dallas-Ft. Worth — United States (US)", "Dammam — Saudi Arabia (SA)", "Darwin — Australia (AU)", "Davao City — Philippines (PH)", "Delhi — India (IN)", "Den Haag — Netherlands (NL)", "Denver — United States (US)", "Depok — Indonesia (ID)", "Derby — United Kingdom (GB)", "Detroit — United States (US)", "Diyarbakır — Turkey (TR)", "Dnipropetrovsk — Ukraine (UA)", "Donetsk — Ukraine (UA)", "Dortmund — Germany (DE)", "Dresden — Germany (DE)", "Dubai — United Arab Emirates (AE)", "Dublin — Ireland (IE)", "Durban — South Africa (ZA)", "Dusseldorf — Germany (DE)", "Ecatepec de Morelos — Mexico (MX)", "Edinburgh — United Kingdom (GB)", "Edmonton — Canada (CA)", "El Paso — United States (US)", "Eskişehir — Turkey (TR)", "Essen — Germany (DE)", "Faisalabad — Pakistan (PK)", "Fortaleza — Brazil (BR)", "Frankfurt — Germany (DE)", "Fresno — United States (US)", "Fukuoka — Japan (JP)", "Galway — Ireland (IE)", "Gaziantep — Turkey (TR)", "Gdańsk — Poland (PL)", "Geneva — Switzerland (CH)", "Genoa — Italy (IT)", "Giza — Egypt (EG)", "Glasgow — United Kingdom (GB)", "Goiânia — Brazil (BR)", "Gomel — Belarus (BY)", "Gothenburg — Sweden (SE)", "Goyang — Korea (KR)", "Greensboro — United States (US)", "Grodno — Belarus (BY)", "Guadalajara — Mexico (MX)", "Guarulhos — Brazil (BR)", "Guatemala City — Guatemala (GT)", "Guayaquil — Ecuador (EC)", "Gwangju — Korea (KR)", "Hai Phong — Vietnam (VN)", "Haifa — Israel (IL)", "Hamamatsu — Japan (JP)", "Hamburg — Germany (DE)", "Hanoi — Vietnam (VN)", "Harrisburg — United States (US)", "Hermosillo — Mexico (MX)", "Hiroshima — Japan (JP)", "Ho Chi Minh City — Vietnam (VN)", "Honolulu — United States (US)", "Houston — United States (US)", "Hull — United Kingdom (GB)", "Hulu Langat — Malaysia (MY)", "Hyderabad — India (IN)", "Ibadan — Nigeria (NG)", "Incheon — Korea (KR)", "Indianapolis — United States (US)", "Indore — India (IN)", "Ipoh — Malaysia (MY)", "Irkutsk — Russia (RU)", "Istanbul — Turkey (TR)", "Izmir — Turkey (TR)", "Jackson — United States (US)", "Jacksonville — United States (US)", "Jaipur — India (IN)", "Jakarta — Indonesia (ID)", "Jeddah — Saudi Arabia (SA)", "Jerusalem — Israel (IL)", "Johannesburg — South Africa (ZA)", "Johor Bahru — Malaysia (MY)", "Kaduna — Nigeria (NG)", "Kajang — Malaysia (MY)", "Kano — Nigeria (NG)", "Kanpur — India (IN)", "Kansas City — United States (US)", "Karachi — Pakistan (PK)", "Kawasaki — Japan (JP)", "Kayseri — Turkey (TR)", "Kazan — Russia (RU)", "Khabarovsk — Russia (RU)", "Kharkiv — Ukraine (UA)", "Kitakyushu — Japan (JP)", "Klang — Malaysia (MY)", "Kobe — Japan (JP)", "Kolkata — India (IN)", "Konya — Turkey (TR)", "Kraków — Poland (PL)", "Krasnodar — Russia (RU)", "Krasnoyarsk — Russia (RU)", "Kuala Lumpur — Malaysia (MY)", "Kumamoto — Japan (JP)", "Kumasi — Ghana (GH)", "Kyiv — Ukraine (UA)", "Kyoto — Japan (JP)", "Lagos — Nigeria (NG)", "Lahore — Pakistan (PK)", "Las Palmas — Spain (ES)", "Las Vegas — United States (US)", "Lausanne — Switzerland (CH)", "Leeds — United Kingdom (GB)", "Leicester — United Kingdom (GB)", "Leipzig — Germany (DE)", "León — Mexico (MX)", "Lille — France (FR)", "Lima — Peru (PE)", "Liverpool — United Kingdom (GB)", "Lodz — Poland (PL)", "London — United Kingdom (GB)", "Long Beach — United States (US)", "Los Angeles — United States (US)", "Louisville — United States (US)", "Lucknow — India (IN)", "Lviv — Ukraine (UA)", "Lyon — France (FR)", "Madrid — Spain (ES)", "Makassar — Indonesia (ID)", "Makati — Philippines (PH)", "Malaga — Spain (ES)", "Manaus — Brazil (BR)", "Manchester — United Kingdom (GB)", "Manila — Philippines (PH)", "Maracaibo — Venezuela (VE)", "Maracay — Venezuela (VE)", "Marseille — France (FR)", "Maturín — Venezuela (VE)", "Mecca — Saudi Arabia (SA)", "Medan — Indonesia (ID)", "Medellín — Colombia (CO)", "Medina — Saudi Arabia (SA)", "Melbourne — Australia (AU)", "Memphis — United States (US)", "Mendoza — Argentina (AR)", "Mersin — Turkey (TR)", "Mesa — United States (US)", "Mexicali — Mexico (MX)", "Mexico City — Mexico (MX)", "Miami — United States (US)", "Middlesbrough — United Kingdom (GB)", "Milan — Italy (IT)", "Milwaukee — United States (US)", "Minneapolis — United States (US)", "Minsk — Belarus (BY)", "Mombasa — Kenya (KE)", "Monterrey — Mexico (MX)", "Montpellier — France (FR)", "Montreal — Canada (CA)", "Morelia — Mexico (MX)", "Moscow — Russia (RU)", "Multan — Pakistan (PK)", "Mumbai — India (IN)", "Munich — Germany (DE)", "Murcia — Spain (ES)", "Muscat — Oman (OM)", "Mérida — Mexico (MX)", "Nagoya — Japan (JP)", "Nagpur — India (IN)", "Nairobi — Kenya (KE)", "Nantes — France (FR)", "Naples — Italy (IT)", "Nashville — United States (US)", "Naucalpan de Juárez — Mexico (MX)", "New Haven — United States (US)", "New Orleans — United States (US)", "New York — United States (US)", "Newcastle — United Kingdom (GB)", "Nezahualcóyotl — Mexico (MX)", "Niigata — Japan (JP)", "Nizhny Novgorod — Russia (RU)", "Norfolk — United States (US)", "Nottingham — United Kingdom (GB)", "Novosibirsk — Russia (RU)", "Odesa — Ukraine (UA)", "Okayama — Japan (JP)", "Okinawa — Japan (JP)", "Oklahoma City — United States (US)", "Omaha — United States (US)", "Omsk — Russia (RU)", "Orlando — United States (US)", "Osaka — Japan (JP)", "Oslo — Norway (NO)", "Ottawa — Canada (CA)", "Palembang — Indonesia (ID)", "Palermo — Italy (IT)", "Palma — Spain (ES)", "Paris — France (FR)", "Pasig — Philippines (PH)", "Patna — India (IN)", "Pekanbaru — Indonesia (ID)", "Perm — Russia (RU)", "Perth — Australia (AU)", "Petaling — Malaysia (MY)", "Philadelphia — United States (US)", "Phoenix — United States (US)", "Pittsburgh — United States (US)", "Plymouth — United Kingdom (GB)", "Port Elizabeth — South Africa (ZA)", "Port Harcourt — Nigeria (NG)", "Portland — United States (US)", "Porto Alegre — Brazil (BR)", "Portsmouth — United Kingdom (GB)", "Poznań — Poland (PL)", "Preston — United Kingdom (GB)", "Pretoria — South Africa (ZA)", "Providence — United States (US)", "Puebla — Mexico (MX)", "Pune — India (IN)", "Quebec — Canada (CA)", "Querétaro — Mexico (MX)", "Quezon City — Philippines (PH)", "Quito — Ecuador (EC)", "Rajkot — India (IN)", "Raleigh — United States (US)", "Ranchi — India (IN)", "Rawalpindi — Pakistan (PK)", "Recife — Brazil (BR)", "Rennes — France (FR)", "Richmond — United States (US)", "Riga — Latvia (LV)", "Rio de Janeiro — Brazil (BR)", "Riyadh — Saudi Arabia (SA)", "Rome — Italy (IT)", "Rosario — Argentina (AR)", "Rostov-on-Don — Russia (RU)", "Rotterdam — Netherlands (NL)", "Sacramento — United States (US)", "Sagamihara — Japan (JP)", "Saint Petersburg — Russia (RU)", "Saitama — Japan (JP)", "Salt Lake City — United States (US)", "Saltillo — Mexico (MX)", "Salvador — Brazil (BR)", "Samara — Russia (RU)", "San Antonio — United States (US)", "San Diego — United States (US)", "San Francisco — United States (US)", "San Jose — United States (US)", "San Luis Potosí — Mexico (MX)", "Santiago — Chile (CL)", "Santo Domingo — Dominican Republic (DO)", "Sapporo — Japan (JP)", "Seattle — United States (US)", "Semarang — Indonesia (ID)", "Sendai — Japan (JP)", "Seongnam — Korea (KR)", "Seoul — Korea (KR)", "Seville — Spain (ES)", "Sharjah — United Arab Emirates (AE)", "Sheffield — United Kingdom (GB)", "Singapore — Singapore (SG)", "Srinagar — India (IN)", "St. Louis — United States (US)", "Stockholm — Sweden (SE)", "Stoke-on-Trent — United Kingdom (GB)", "Strasbourg — France (FR)", "Stuttgart — Germany (DE)", "Surabaya — Indonesia (ID)", "Surat — India (IN)", "Suwon — Korea (KR)", "Swansea — United Kingdom (GB)", "Sydney — Australia (AU)", "São Luís — Brazil (BR)", "São Paulo — Brazil (BR)", "Taguig — Philippines (PH)", "Takamatsu — Japan (JP)", "Tallahassee — United States (US)", "Tampa — United States (US)", "Tangerang — Indonesia (ID)", "Tel Aviv — Israel (IL)", "Thane — India (IN)", "Thessaloniki — Greece (GR)", "Tijuana — Mexico (MX)", "Tokyo — Japan (JP)", "Toluca — Mexico (MX)", "Toronto — Canada (CA)", "Toulouse — France (FR)", "Tucson — United States (US)", "Turin — Italy (IT)", "Turmero — Venezuela (VE)", "Ufa — Russia (RU)", "Ulsan — Korea (KR)", "Utrecht — Netherlands (NL)", "Valencia — Spain (ES)", "Valencia — Venezuela (VE)", "Valparaiso — Chile (CL)", "Vancouver — Canada (CA)", "Vienna — Austria (AT)", "Virginia Beach — United States (US)", "Vladivostok — Russia (RU)", "Volgograd — Russia (RU)", "Voronezh — Russia (RU)", "Warsaw — Poland (PL)", "Washington — United States (US)", "Winnipeg — Canada (CA)", "Wroclaw — Poland (PL)", "Yekaterinburg — Russia (RU)", "Yokohama — Japan (JP)", "Yongin — Korea (KR)", "Zamboanga City — Philippines (PH)", "Zapopan — Mexico (MX)", "Zaporozhye — Ukraine (UA)", "Zaragoza — Spain (ES)", "Zurich — Switzerland (CH)" ] }, "default": [] }, "maxTrendsPerLocation": { "title": "Maximum trends per location", "minimum": 1, "maximum": 50, "type": "integer", "description": "Save up to this many trending topics for each location. X currently returns at most 50 topics per location.", "default": 50 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }