{
  "openapi": "3.0.1",
  "info": {
    "title": "Threads Scraper — Profiles, Posts, Search & Replies",
    "description": "Scrape Meta Threads profiles, user posts, keyword search results and post replies with no login or API key. Extracts followers, verified badges, unwrapped bio links and emails, likes, replies, reposts, quotes, media URLs and engagement metrics.",
    "version": "0.1",
    "x-build-id": "eMEz6K3jAAFGrnYfK"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/foxlabs~threads-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-foxlabs-threads-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/foxlabs~threads-scraper/runs": {
      "post": {
        "operationId": "runs-sync-foxlabs-threads-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/foxlabs~threads-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-foxlabs-threads-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": {
          "usernames": {
            "title": "Threads usernames or profile URLs",
            "type": "array",
            "description": "Threads handles (with or without @, such as zuck or @mosseri) or full profile URLs (https://www.threads.com/@natgeo). Leave empty if you only want keyword search or post replies.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Keyword or topic search queries",
            "type": "array",
            "description": "Optional keywords, phrases or hashtags to search on Threads (for example: openai, \"ai agents\", #buildinpublic). Returns public posts matching each query.",
            "items": {
              "type": "string"
            }
          },
          "postUrls": {
            "title": "Post URLs (for post details & replies)",
            "type": "array",
            "description": "Optional Threads post URLs (for example: https://www.threads.com/@zuck/post/DfihFPxkaZ1) to extract the target post together with its direct replies.",
            "items": {
              "type": "string"
            }
          },
          "accountMode": {
            "title": "For each username, extract",
            "enum": [
              "postsAndProfiles",
              "postsOnly",
              "profilesOnly"
            ],
            "type": "string",
            "description": "Choose whether usernames emit both profile summary rows and post rows, only posts, or only enriched profile rows.",
            "default": "postsAndProfiles"
          },
          "searchSort": {
            "title": "Search sort order",
            "enum": [
              "default",
              "recent"
            ],
            "type": "string",
            "description": "Applies when Search queries are given: Top (relevance/engagement) or Recent (newest posts).",
            "default": "default"
          },
          "maxPostsPerSource": {
            "title": "Max posts per username or search query",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum posts to collect per account or per search query. Profile timelines paginate automatically via Threads GraphQL.",
            "default": 25
          },
          "maxRepliesPerPost": {
            "title": "Max replies per post URL",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum reply rows to extract for each URL in Post URLs.",
            "default": 25
          },
          "maxResults": {
            "title": "Max total rows (overall cap)",
            "minimum": 0,
            "type": "integer",
            "description": "Hard ceiling on total delivered rows across the entire run to control spend. Set 0 for no overall cap.",
            "default": 100
          },
          "minLikes": {
            "title": "Minimum likes filter",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep post/reply rows with at least this many likes (0 = keep all).",
            "default": 0
          },
          "postedAfter": {
            "title": "Posted after date (YYYY-MM-DD)",
            "type": "string",
            "description": "Optional ISO date filter (such as 2026-01-01). Posts older than this date are skipped and profile pagination stops once older non-pinned posts are reached."
          },
          "postedBefore": {
            "title": "Posted before date (YYYY-MM-DD)",
            "type": "string",
            "description": "Optional ISO upper date filter (such as 2026-12-31). Posts newer than the end of this date are skipped."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Uses Apify Proxy automatically (starts on free datacenter sessions and escalates if rate-limited). No setup needed.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}