{
  "openapi": "3.0.1",
  "info": {
    "title": "Threads Scraper: Posts by Keyword or Profile, No Login",
    "description": "Public Threads posts by keyword, profile or post link: text, author, likes, replies, reposts, shares, views, language, images, videos and post time. Date filter, profile Replies tab. No login needed. $1 per 1,000 results, platform usage included.",
    "version": "0.1",
    "x-build-id": "YiImey2mAOW9qmC1j"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/one_dollar_store~threads-post-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-one_dollar_store-threads-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/one_dollar_store~threads-post-scraper/runs": {
      "post": {
        "operationId": "runs-sync-one_dollar_store-threads-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/one_dollar_store~threads-post-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-one_dollar_store-threads-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",
        "properties": {
          "searchQueries": {
            "title": "Keywords",
            "type": "array",
            "description": "Words or phrases to search on Threads. Each keyword is searched on its own. A Threads search link (threads.com/search?q=...) works too. Leave empty if you only want profile posts or post links.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "Profiles",
            "type": "array",
            "description": "Threads usernames or profile links, for example zuck, @zuck or https://www.threads.com/@zuck. Returns the posts the public profile page shows.",
            "items": {
              "type": "string"
            }
          },
          "postUrls": {
            "title": "Post links",
            "type": "array",
            "description": "Links to single Threads posts, for example https://www.threads.com/@nasa/post/Dd6o9h3ERXF or a threads.net/t/ short link. Returns one row per post with its current likes, replies, reposts and the view count the post page shows. For the replies under a post, use Threads Replies Scraper.",
            "items": {
              "type": "string"
            }
          },
          "searchSort": {
            "title": "Search results list",
            "enum": [
              "top",
              "recent",
              "both",
              "all"
            ],
            "type": "string",
            "description": "Which Threads result list to read for each keyword. Both reads the Top list and then the Recent list. All three adds the Topic tags list (posts filed under the Threads topic that matches the keyword), which usually adds 5 to 15 more posts. Every list after the first keeps only posts that contain the keyword (or, on the topic list, sit under a topic named after it). Each list is one more page per keyword.",
            "default": "top"
          },
          "exactMatchOnly": {
            "title": "Only posts that contain the keyword",
            "type": "boolean",
            "description": "Threads search also returns posts it links to the keyword by topic, picture or language even when the words are not in the text. Turn this on to keep only posts whose text or hashtags contain every word of the keyword. You get fewer posts, all of them on topic.",
            "default": false
          },
          "includeProfileReplies": {
            "title": "Also read each profile's Replies tab",
            "type": "boolean",
            "description": "Also reads the Replies tab of each profile and returns the replies the account posted under other people's threads (usually 5 to 10 more posts per profile). One more page per profile. Rows say which tab they came from in profileTab.",
            "default": false
          },
          "postedAfter": {
            "title": "Posted on or after",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?)?$|^\\d{1,4} ?(hour|day|week|month|year)s?( ago)?$",
            "type": "string",
            "description": "Keep only posts published on or after this time: a date such as 2026-11-01 (start of that day, UTC) or a relative time such as 24 hours, 7 days or 1 month. Threads does not filter a logged out search by date, so this drops older posts from the pages it reads; it does not reach further back."
          },
          "postedBefore": {
            "title": "Posted before",
            "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?)?$|^\\d{1,4} ?(hour|day|week|month|year)s?( ago)?$",
            "type": "string",
            "description": "Keep only posts published before this time: a date such as 2026-11-10 (start of that day, UTC) or a relative time such as 1 day. Leave empty for no upper limit."
          },
          "includeViews": {
            "title": "Add view counts",
            "type": "boolean",
            "description": "Fills viewCount on keyword and profile rows by reading each post's own page, the number Threads shows under a post (rounded above 1,000, so 908K is 908000). One more page per post, so runs take longer. Post links always get it.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum posts",
            "minimum": 10,
            "maximum": 10000,
            "type": "integer",
            "description": "The run stops after this many posts in total. Minimum 10, maximum 10,000. Threads shows about 15 to 35 posts per keyword list and 5 to 10 per profile page, so add more keywords or profiles for more posts.",
            "default": 100
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "The default is the Apify datacenter proxy with a new address for every request. If Threads blocks two requests in a row, the run switches to residential proxy for up to 10 requests. Pick the Residential group here to use it from the start. Costs are included in the price.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}