{ "openapi": "3.0.1", "info": { "title": "X (Twitter) Global Trending Scraper", "description": "Scrape X (Twitter) Global Trending: the most popular posts by country, category and time window, plus the classic ranked trends list and trending topic chips. Rich post data (text, media, likes, views, author). Fast, API-based, no login.", "version": "1.2", "x-build-id": "ieisOnryRo80aKKhg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delicious_zebu~x-global-trending-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delicious_zebu-x-global-trending-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/delicious_zebu~x-global-trending-scraper/runs": { "post": { "operationId": "runs-sync-delicious_zebu-x-global-trending-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/delicious_zebu~x-global-trending-scraper/run-sync": { "post": { "operationId": "run-sync-delicious_zebu-x-global-trending-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": { "resultTypes": { "title": "What to collect", "type": "array", "description": "Pick one or more data types. **Popular posts** = the trending posts feed (richest data, unique to this Actor). **Ranked trends list** = the classic numbered trending-topics list. **Trending topic chips** = the topic keywords shown on the Global Trending page.", "items": { "type": "string", "enum": [ "posts", "trends", "topicChips" ], "enumTitles": [ "Popular posts", "Ranked trends list", "Trending topic chips" ] }, "default": [ "posts" ] }, "countries": { "title": "Countries", "type": "array", "description": "Countries to cover. \"Global\" is the worldwide feed (matches the label on x.com). Applies to posts, trends and chips. Add several to compare markets in one run.", "items": { "type": "string", "enum": [ "Global", "United States", "Algeria", "Argentina", "Australia", "Austria", "Bangladesh", "Belgium", "Brazil", "Canada", "Chile", "Colombia", "Czech Republic", "Denmark", "Ecuador", "Egypt", "Ethiopia", "Finland", "France", "Germany", "Ghana", "Greece", "Hungary", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kenya", "Kuwait", "Lebanon", "Malaysia", "Mexico", "Morocco", "Netherlands", "New Zealand", "Nigeria", "Norway", "Oman", "Pakistan", "Peru", "Philippines", "Poland", "Portugal", "Quatar", "Romania", "Russia", "Saudi Arabia", "Singapore", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sweden", "Switzerland", "Tanzania", "Thailand", "Tunisia", "Turkey", "Ukraine", "United Arab Emirates", "United Kingdom", "Vietnam", "Venezuela" ] }, "default": [ "Global" ] }, "categories": { "title": "Post categories (posts only)", "type": "array", "description": "Which category feeds to scrape for Popular posts. \"All\" is the default mixed feed. These match the category cards on the Global Trending page. Ignored for trends and chips.", "items": { "type": "string", "enum": [ "All", "News", "Sports", "Music", "Dance", "Celebrity", "Relationships", "Movies & TV", "Technology", "Business & Finance", "Cryptocurrency", "Gaming", "Cars", "Nature & Outdoors", "Home & Garden", "Travel", "Health & Fitness", "Pets", "Food", "Memes", "Beauty", "Fashion", "Anime", "Science", "Religion" ] }, "default": [ "All" ] }, "timeWindow": { "title": "Time window (posts only)", "enum": [ "Today", "This week", "This month" ], "type": "string", "description": "Time range for Popular posts, matching the page's \"Popular today / this week / this month\" dropdown.", "default": "Today" }, "languages": { "title": "Language filter (optional, posts only)", "type": "array", "description": "Keep only posts written in these languages. Leave empty to keep every language.", "items": { "type": "string", "enum": [ "en", "ar", "bn", "bg", "ca", "hr", "cs", "da", "nl", "fi", "fr", "de", "el", "gu", "he", "hi", "hu", "id", "it", "ja", "kn", "ko", "mr", "no", "fa", "pl", "pt", "ro", "ru", "sr", "zh-cn", "sk", "es", "sv", "ta", "th", "zh-tw", "tr", "uk", "ur", "vi" ], "enumTitles": [ "English", "Arabic", "Bengali", "Bulgarian", "Catalan", "Croatian", "Czech", "Danish", "Dutch", "Finnish", "French", "German", "Greek", "Gujarati", "Hebrew", "Hindi", "Hungarian", "Indonesian", "Italian", "Japanese", "Kannada", "Korean", "Marathi", "Norwegian", "Persian", "Polish", "Portuguese", "Romanian", "Russian", "Serbian", "Chinese (Simplified)", "Slovak", "Spanish", "Swedish", "Tamil", "Thai", "Chinese (Traditional)", "Turkish", "Ukrainian", "Urdu", "Vietnamese" ] }, "default": [] }, "maxPostsPerFeed": { "title": "Max posts per feed", "minimum": 0, "type": "integer", "description": "Maximum posts per country x category feed. 0 (default) fetches the whole feed (can be 1,000+ posts). Set a smaller number to cap it; 20 or fewer returns instantly.", "default": 0 } } }, "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 } } } } } } } } } }