{
  "openapi": "3.0.1",
  "info": {
    "title": "X (Twitter) Replies Scraper - Tweet Replies, No Login",
    "description": "Export public replies to X (Twitter) posts from tweet URLs or IDs. Each reply row has text, author profile (followers, bio, verified), likes, views, bookmarks, language and conversation IDs. Sort by relevance, recency or likes and resume big exports with a saved cursor. No login or cookies.",
    "version": "1.0",
    "x-build-id": "a9ivVv70Vl5YI7v2F"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~x-twitter-replies-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-x-twitter-replies-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/khadinakbar~x-twitter-replies-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-x-twitter-replies-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/khadinakbar~x-twitter-replies-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-x-twitter-replies-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": [
          "tweetUrls"
        ],
        "properties": {
          "tweetUrls": {
            "title": "Tweet URLs or IDs",
            "minItems": 1,
            "maxItems": 50,
            "type": "array",
            "description": "Use this when you need public replies from specific X (Twitter) posts. Enter full URLs like https://x.com/OpenAI/status/2065225362544726371 or numeric tweet IDs, up to 50 per run. This is not for keyword search or profile timelines.",
            "items": {
              "type": "string"
            }
          },
          "rankingMode": {
            "title": "Reply ranking mode",
            "enum": [
              "Relevance",
              "Recency",
              "Likes"
            ],
            "type": "string",
            "description": "Use this when choosing how X should order replies for each tweet. Relevance returns the default conversation ranking, Recency returns newer replies first, and Likes prioritizes liked replies. Defaults to Relevance. This does not scrape quote tweets or retweeters.",
            "default": "Relevance"
          },
          "maxReplies": {
            "title": "Maximum replies",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Use this to cap the total reply rows saved across all input posts. The Actor stops before charging beyond this limit. Defaults to 100 and supports up to 5000. This is a hard billing and dataset cap, not a per-post target. A post's replies are read 36 at a time, so a run can read a few rows more than it saves; only saved rows are charged.",
            "default": 100
          },
          "maxDepth": {
            "title": "Reply depth",
            "minimum": 1,
            "maximum": 2,
            "type": "integer",
            "description": "Use this to choose how deep to read. 1 returns replies to the post itself (default). 2 also returns replies to those replies, up to 25 reply threads per post, most-replied threads first; each row says its depth and the reply it answers. Rows are billed the same at both depths. Enter 1 or 2.",
            "default": 1
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only replies with at least this many likes, for example 10. Replies below the threshold are skipped and not charged. Defaults to 0 (keep all). This filters saved rows; it does not change how X ranks replies.",
            "default": 0
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only replies seen at least this many times, for example 1000. Replies below the threshold are skipped and not charged. Defaults to 0 (keep all). Only rows the Actor can read are filtered; see the scan limit in the README.",
            "default": 0
          },
          "minReplies": {
            "title": "Minimum replies",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only replies that themselves got at least this many replies, for example 3. Handy for finding sub-threads. Skipped replies are not charged. Defaults to 0 (keep all).",
            "default": 0
          },
          "minRetweets": {
            "title": "Minimum retweets",
            "minimum": 0,
            "type": "integer",
            "description": "Use this to keep only replies retweeted at least this many times. Skipped replies are not charged. Defaults to 0 (keep all).",
            "default": 0
          },
          "language": {
            "title": "Reply language",
            "type": "string",
            "description": "Use this to keep only replies in one language. Enter a two-letter code such as en, es or de. Replies in other languages are skipped and not charged. Leave empty to keep every language.",
            "default": ""
          },
          "since": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Use this to keep only replies posted on or after a date, as YYYY-MM-DD (UTC), for example 2026-06-12. Earlier replies are skipped and not charged. Works best with Recency order, which stops early once replies get older than this date. Leave empty for no start date.",
            "default": ""
          },
          "until": {
            "title": "Posted on or before",
            "type": "string",
            "description": "Use this to keep only replies posted on or before a date, as YYYY-MM-DD (UTC). Later replies are skipped and not charged. Leave empty for no end date.",
            "default": ""
          },
          "verifiedOnly": {
            "title": "Verified accounts only",
            "type": "boolean",
            "description": "Use this to keep only replies from verified accounts, including blue-check accounts. Other replies are skipped and not charged. Defaults to off.",
            "default": false
          },
          "excludeOriginalAuthor": {
            "title": "Skip the post author's own replies",
            "type": "boolean",
            "description": "Use this to drop replies written by the account that posted the original post (for example a brand answering its own thread), so you only get audience replies. Skipped rows are not charged. Defaults to off.",
            "default": false
          },
          "maxPagesPerTweet": {
            "title": "Maximum pages per tweet",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Use this as a pagination safety valve for each post. A page holds up to 36 replies; higher values follow the conversation deeper. Defaults to 10 and supports up to 100. This does not override maxReplies.",
            "default": 10
          },
          "startCursor": {
            "title": "Start cursor",
            "maxLength": 4000,
            "type": "string",
            "description": "Use this when continuing the first post in your list from a previous RUN_SUMMARY nextCursors value. Paste the cursor string exactly as returned by the Actor. Leave blank for a fresh run. This is not a tweet URL or tweet ID field."
          },
          "dedupeReplies": {
            "title": "Dedupe replies",
            "type": "boolean",
            "description": "Use this to skip duplicate reply tweets across pages and input tweets. The Actor dedupes by reply ID first, then reply URL or text. Defaults to true. Disable only when you need to inspect page overlap.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}