{ "openapi": "3.0.1", "info": { "title": "Twitter User Following Scraper", "description": "Twitter User Following Scraper collects publicly available following data from Twitter user profiles. Extract usernames, profile metadata, and relationship details for research, analysis, or monitoring with fast execution and structured output.", "version": "0.1", "x-build-id": "j0iCfxMHobMJgTa8y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper-engine~twitter-user-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper-engine-twitter-user-following-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/scraper-engine~twitter-user-following-scraper/runs": { "post": { "operationId": "runs-sync-scraper-engine-twitter-user-following-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/scraper-engine~twitter-user-following-scraper/run-sync": { "post": { "operationId": "run-sync-scraper-engine-twitter-user-following-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": [ "startUrls", "authToken", "ct0" ], "properties": { "startUrls": { "title": "šŸ”Žāœļø Whose following should we scrape?", "type": "array", "description": "šŸ—‚ļø List every handle or profile URL you care about ā€” one per line is perfect.\n\nāœ… Handles ā€” quick & easy\nā€¢ šŸ‘¤ jordanbpeterson\nā€¢ šŸ‘¤ elonmusk\nā€¢ šŸ‘¤ BillGates\n\nāœ… Full URLs ā€” when you copied straight from the browser\nā€¢ šŸŒ https://x.com/jordanbpeterson\nā€¢ šŸŒ https://twitter.com/elonmusk\n\nšŸ’” Mix both styles ā€” we'll scrape them all in order!", "items": { "type": "string" } }, "maxResults": { "title": "šŸ“ŠšŸŽÆ Max following users per handle", "minimum": 1, "maximum": 10000, "type": "integer", "description": "šŸ§® Set your cap for each handle ā€” stay light for tests, go big for exports.\n\nšŸ”¢ 1ā€“10000 = stop after this many following users per handle\n\nā­ Default: 10 (great for first runs!)", "default": 10 }, "authToken": { "title": "šŸŖšŸ” X `auth_token` cookie ā€” required", "minLength": 1, "type": "string", "description": "šŸ”‘ Required. Paste the value of the `auth_token` cookie from a logged-in browser session on x.com.\n\nšŸ§­ How to grab it\n1ļøāƒ£ Log in to x.com in your browser\n2ļøāƒ£ Open DevTools ā†’ Application ā†’ Cookies ā†’ https://x.com\n3ļøāƒ£ Copy the value of `auth_token` and paste it here\n\nā™»ļø Cookies rotate ā€” refresh them if requests start failing." }, "ct0": { "title": "šŸ›”ļøšŸ§© X `ct0` (CSRF) cookie ā€” required", "minLength": 1, "type": "string", "description": "šŸ”‘ Required. Paste the value of the `ct0` cookie from the same logged-in browser session.\n\nšŸ§­ How to grab it\n1ļøāƒ£ DevTools ā†’ Application ā†’ Cookies ā†’ https://x.com\n2ļøāƒ£ Copy the value of `ct0` and paste it here\n\nšŸ›°ļø Also doubles as the `x-csrf-token` header ā€” must match the `auth_token` session." }, "proxyConfiguration": { "title": "šŸ›°ļø Apify Proxy settings", "type": "object", "description": "šŸš¦ Off by default. Turn on only when X throttles you ā€” then pick groups & country like a pro! šŸŒāœØ" } } }, "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 } } } } } } } } } }