{ "openapi": "3.0.1", "info": { "title": "Threads Search Post Scraper", "description": "Search public Threads posts by keyword or hashtag, or look up posts by URL or numeric ID. Get structured text, author, date, engagement, links, conversation data, and optional detailed source fields in an Apify dataset.", "version": "0.0", "x-build-id": "70i19YnsgqbEBNWwQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~threads-search-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-threads-search-post-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/maximedupre~threads-search-post-scraper/runs": { "post": { "operationId": "runs-sync-maximedupre-threads-search-post-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/maximedupre~threads-search-post-scraper/run-sync": { "post": { "operationId": "run-sync-maximedupre-threads-search-post-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": [ "findPostsBy" ], "properties": { "findPostsBy": { "title": "Find posts by", "enum": [ "keyword", "hashtag", "post" ], "type": "string", "description": "Choose how to find public Threads posts. Keyword and Hashtag searches accept lists. Post URL or ID looks up the submitted posts." }, "keywords": { "title": "Keywords", "minItems": 1, "type": "array", "description": "Use this field when Find posts by is Keyword. Enter one or more words or phrases to search. The same sort and post limit apply to all submitted keywords. Values in the other choice sections are ignored.", "items": { "type": "string", "minLength": 1 }, "default": [ "OpenAI" ] }, "hashtags": { "title": "Hashtags", "minItems": 1, "type": "array", "description": "Use this field when Find posts by is Hashtag. Enter one or more hashtags with or without the # sign. The same sort and post limit apply to all submitted hashtags. Values in the other choice sections are ignored.", "items": { "type": "string", "minLength": 1 } }, "postTargets": { "title": "Post URLs or IDs", "minItems": 1, "type": "array", "description": "Use this field when Find posts by is Post URL or ID. Enter one or more public Threads post URLs or numeric post IDs. All submitted posts use the same post limit and output setting. Values in the other choice sections are ignored.", "items": { "type": "string", "minLength": 1 } }, "sortOrder": { "title": "Sort search results", "enum": [ "recent", "top" ], "type": "string", "description": "For Keyword and Hashtag, choose Recent first or Relevance or top. Post URL or ID ignores this field.", "default": "recent" }, "publicationDate": { "title": "Publication date filter", "required": [], "type": "object", "description": "For Keyword and Hashtag, narrow returned posts by publication time. Use From and To for a UTC calendar date range, or use Recent days for a recent window. Post URL or ID ignores this field.", "properties": { "fromDate": { "title": "From", "type": "string", "description": "First publication date to include. Use a UTC calendar date.", "editor": "datepicker", "dateType": "absolute" }, "toDate": { "title": "To", "type": "string", "description": "Last publication date to include. Use a UTC calendar date.", "editor": "datepicker", "dateType": "absolute" }, "recentDays": { "title": "Recent days", "type": "integer", "description": "Include posts published in this many days before the run. Use a positive whole number.", "minimum": 1 } } }, "author": { "title": "Author filter", "minLength": 1, "type": "string", "description": "For Keyword and Hashtag, narrow returned posts to a public Threads author. Enter the username with or without @. Post URL or ID ignores this field." }, "maxItems": { "title": "Maximum posts", "minimum": 1, "type": "integer", "description": "Optional limit for the run. Stop after this many returned posts. Leave it empty to return all available results until the source is exhausted." }, "includeSourceData": { "title": "Include detailed source data", "type": "boolean", "description": "Add the detailed source-level fields alongside the normalized post data. Normalized public post data is always returned.", "default": false } } }, "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 } } } } } } } } } }