Api Endpoint

Apify API

Start the "🏯 Tweet Scraper V2 - X / Twitter Scraper" Apify actor (apidojo/tweet-scraper). ⚡️ Lightning-fast search, URL, list, and profile scraping, with customizable filters. At $0.40 per 1000 tweets, and 30-80 tweets per second, it is ideal for re…

Open interactive test console

Offering

Provider
stableapify.dev
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://stableapify.dev/api/actors/apidojo/tweet-scraper/call
MIME type
Not provided
First seen
2026-10-16T01:54:06.400Z
Last seen
Tags
Actors

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0x23d931f95831cee50b5f5edf4d0e88270f6c8411"
  }
]

Observed health

Status
Healthy
Latest latency
90 ms
Average latency
304 ms
HTTP status
204
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "additionalProperties": false,
      "properties": {
        "input": {
          "additionalProperties": {},
          "description": "Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).",
          "properties": {
            "author": {
              "description": "Returns tweets sent by the given user. It should be a Twitter (X) Handle.",
              "type": "string"
            },
            "conversationIds": {
              "description": "Conversation IDs that you want to search on Twitter (X)",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "customMapFunction": {
              "description": "Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically.",
              "type": "string"
            },
            "end": {
              "description": "Returns tweets sent before the given date.",
              "type": "string"
            },
            "geocode": {
              "description": "Returns tweets sent by users located within a given radius of the given latitude/longitude.",
              "type": "string"
            },
            "geotaggedNear": {
              "description": "Returns tweets sent near the given location.",
              "type": "string"
            },
            "inReplyTo": {
              "description": "Returns tweets that are replies to the given user. It should be a Twitter (X) Handle.",
              "type": "string"
            },
            "includeSearchTerms": {
              "description": "If selected, a field will be added to each tweets about the search term that was used to find it.",
              "type": "boolean"
            },
            "maxItems": {
              "description": "Maximum number of items that you want as output.",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "mentioning": {
              "description": "Returns tweets mentioning the given user. It should be a Twitter (X) Handle.",
              "type": "string"
            },
            "minimumFavorites": {
              "description": "Returns tweets with at least the given number of favorites.",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "minimumReplies": {
              "description": "Returns tweets with at least the given number of replies.",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "minimumRetweets": {
              "description": "Returns tweets with at least the given number of retweets.",
              "maximum": 9007199254740991,
              "minimum": -9007199254740991,
              "type": "integer"
            },
            "onlyImage": {
              "description": "If selected, only returns tweets that contain images.",
              "type": "boolean"
            },
            "onlyQuote": {
              "description": "If selected, only returns tweets that are quotes.",
              "type": "boolean"
            },
            "onlyTwitterBlue": {
              "description": "If selected, only returns tweets by users who are Twitter Blue subscribers.",
              "type": "boolean"
            },
            "onlyVerifiedUsers": {
              "description": "If selected, only returns tweets by users who are verified.",
              "type": "boolean"
            },
            "onlyVideo": {
              "description": "If selected, only returns tweets that contain videos.",
              "type": "boolean"
            },
            "placeObjectId": {
              "description": "Returns tweets tagged with the given place.",
              "type": "string"
            },
            "searchTerms": {
              "description": "Search terms you want to search from Twitter (X). You can refer to https://github.com/igorbrigadir/twitter-advanced-search.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "sort": {
              "description": "Sorts search results. If you are getting low results, try Top instead of Latest. Latest + Top runs both simultaneously to maximize results but may return some duplicate tweets.",
              "enum": [
                "Top",
                "Latest",
                "Latest + Top"
              ],
              "type": "string"
            },
            "start": {
              "description": "Returns tweets sent after the given date.",
              "type": "string"
            },
            "startUrls": {
              "description": "Twitter (X) URLs. Paste the URLs and get the results immediately. Tweet, Profile, Search or List URLs are supported.",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "tweetLanguage": {
              "description": "Restricts tweets to the given language, given by an ISO 639-1 code.",
              "enum": [
                "ab",
                "aa",
                "af",
                "ak",
                "sq",
                "am",
                "ar",
                "an",
                "hy",
                "as",
                "av",
                "ae",
                "ay",
                "az",
                "bm",
                "ba",
                "eu",
                "be",
                "bn",
                "bi",
                "bs",
                "br",
                "bg",
                "my",
                "ca",
                "ch",
                "ce",
                "ny",
                "zh",
                "cu",
                "cv",
                "kw",
                "co",
                "cr",
                "hr",
                "cs",
                "da",
                "dv",
                "nl",
                "dz",
                "en",
                "eo",
                "et",
                "ee",
                "fo",
                "fj",
                "fi",
                "fr",
                "fy",
                "ff",
                "gd",
                "gl",
                "lg",
                "ka",
                "de",
                "el",
                "kl",
                "gn",
                "gu",
                "ht",
                "ha",
                "he",
                "hz",
                "hi",
                "ho",
                "hu",
                "is",
                "io",
                "ig",
                "id",
                "ia",
                "ie",
                "iu",
                "ik",
                "ga",
                "it",
                "ja",
                "jv",
                "kn",
                "kr",
                "ks",
                "kk",
                "km",
                "ki",
                "rw",
                "ky",
                "kv",
                "kg",
                "ko",
                "kj",
                "ku",
                "lo",
                "la",
                "lv",
                "li",
                "ln",
                "lt",
                "lu",
                "lb",
                "mk",
                "mg",
                "ms",
                "ml",
                "mt",
                "gv",
                "mi",
                "mr",
                "mh",
                "mn",
                "na",
                "nv",
                "nd",
                "nr",
                "ng",
                "ne",
                "no",
                "nb",
                "nn",
                "ii",
                "oc",
                "oj",
                "or",
                "om",
                "os",
                "pi",
                "ps",
                "fa",
                "pl",
                "pt",
                "pa",
                "qu",
                "ro",
                "rm",
                "rn",
                "ru",
                "se",
                "sm",
                "sg",
                "sa",
                "sc",
                "sr",
                "sn",
                "sd",
                "si",
                "sk",
                "sl",
                "so",
                "st",
                "es",
                "su",
                "sw",
                "ss",
                "sv",
                "tl",
                "ty",
                "tg",
                "ta",
                "tt",
                "te",
                "th",
                "bo",
                "ti",
                "to",
                "ts",
                "tn",
                "tr",
                "tk",
                "tw",
                "ug",
                "uk",
                "ur",
                "uz",
                "ve",
                "vi",
                "vo",
                "wa",
                "cy",
                "wo",
                "xh",
                "yi",
                "yo",
                "za",
                "zu"
              ],
              "type": "string"
            },
            "twitterHandles": {
              "description": "Twitter handles that you want to search on Twitter (X)",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "withinRadius": {
              "description": "Returns tweets sent within the given radius of the given location.",
              "type": "string"
            }
          },
          "type": "object"
        },
        "options": {
          "additionalProperties": false,
          "description": "Optional Apify run options.",
          "properties": {
            "build": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            },
            "maxItems": {
              "maximum": 100000,
              "minimum": 1,
              "type": "integer"
            },
            "memory": {
              "maximum": 32768,
              "minimum": 128,
              "type": "integer"
            }
          },
          "type": "object"
        }
      },
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": false,
          "properties": {
            "input": {
              "additionalProperties": {},
              "description": "Normalized actor input. See field descriptions for the simplified shape; native Apify input also accepted (passed through).",
              "properties": {
                "author": {
                  "description": "Returns tweets sent by the given user. It should be a Twitter (X) Handle.",
                  "type": "string"
                },
                "conversationIds": {
                  "description": "Conversation IDs that you want to search on Twitter (X)",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "customMapFunction": {
                  "description": "Function that takes each of the objects as argument and returns data that will be mapped by the function itself. This function is not intended for filtering, please don't use it for filtering purposes or you will get banned automatically.",
                  "type": "string"
                },
                "end": {
                  "description": "Returns tweets sent before the given date.",
                  "type": "string"
                },
                "geocode": {
                  "description": "Returns tweets sent by users located within a given radius of the given latitude/longitude.",
                  "type": "string"
                },
                "geotaggedNear": {
                  "description": "Returns tweets sent near the given location.",
                  "type": "string"
                },
                "inReplyTo": {
                  "description": "Returns tweets that are replies to the given user. It should be a Twitter (X) Handle.",
                  "type": "string"
                },
                "includeSearchTerms": {
                  "description": "If selected, a field will be added to each tweets about the search term that was used to find it.",
                  "type": "boolean"
                },
                "maxItems": {
                  "description": "Maximum number of items that you want as output.",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "mentioning": {
                  "description": "Returns tweets mentioning the given user. It should be a Twitter (X) Handle.",
                  "type": "string"
                },
                "minimumFavorites": {
                  "description": "Returns tweets with at least the given number of favorites.",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "minimumReplies": {
                  "description": "Returns tweets with at least the given number of replies.",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "minimumRetweets": {
                  "description": "Returns tweets with at least the given number of retweets.",
                  "maximum": 9007199254740991,
                  "minimum": -9007199254740991,
                  "type": "integer"
                },
                "onlyImage": {
                  "description": "If selected, only returns tweets that contain images.",
                  "type": "boolean"
                },
                "onlyQuote": {
                  "description": "If selected, only returns tweets that are quotes.",
                  "type": "boolean"
                },
                "onlyTwitterBlue": {
                  "description": "If selected, only returns tweets by users who are Twitter Blue subscribers.",
                  "type": "boolean"
                },
                "onlyVerifiedUsers": {
                  "description": "If selected, only returns tweets by users who are verified.",
                  "type": "boolean"
                },
                "onlyVideo": {
                  "description": "If selected, only returns tweets that contain videos.",
                  "type": "boolean"
                },
                "placeObjectId": {
                  "description": "Returns tweets tagged with the given place.",
                  "type": "string"
                },
                "searchTerms": {
                  "description": "Search terms you want to search from Twitter (X). You can refer to https://github.com/igorbrigadir/twitter-advanced-search.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "sort": {
                  "description": "Sorts search results. If you are getting low results, try Top instead of Latest. Latest + Top runs both simultaneously to maximize results but may return some duplicate tweets.",
                  "enum": [
                    "Top",
                    "Latest",
                    "Latest + Top"
                  ],
                  "type": "string"
                },
                "start": {
                  "description": "Returns tweets sent after the given date.",
                  "type": "string"
                },
                "startUrls": {
                  "description": "Twitter (X) URLs. Paste the URLs and get the results immediately. Tweet, Profile, Search or List URLs are supported.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "tweetLanguage": {
                  "description": "Restricts tweets to the given language, given by an ISO 639-1 code.",
                  "enum": [
                    "ab",
                    "aa",
                    "af",
                    "ak",
                    "sq",
                    "am",
                    "ar",
                    "an",
                    "hy",
                    "as",
                    "av",
                    "ae",
                    "ay",
                    "az",
                    "bm",
                    "ba",
                    "eu",
                    "be",
                    "bn",
                    "bi",
                    "bs",
                    "br",
                    "bg",
                    "my",
                    "ca",
                    "ch",
                    "ce",
                    "ny",
                    "zh",
                    "cu",
                    "cv",
                    "kw",
                    "co",
                    "cr",
                    "hr",
                    "cs",
                    "da",
                    "dv",
                    "nl",
                    "dz",
                    "en",
                    "eo",
                    "et",
                    "ee",
                    "fo",
                    "fj",
                    "fi",
                    "fr",
                    "fy",
                    "ff",
                    "gd",
                    "gl",
                    "lg",
                    "ka",
                    "de",
                    "el",
                    "kl",
                    "gn",
                    "gu",
                    "ht",
                    "ha",
                    "he",
                    "hz",
                    "hi",
                    "ho",
                    "hu",
                    "is",
                    "io",
                    "ig",
                    "id",
                    "ia",
                    "ie",
                    "iu",
                    "ik",
                    "ga",
                    "it",
                    "ja",
                    "jv",
                    "kn",
                    "kr",
                    "ks",
                    "kk",
                    "km",
                    "ki",
                    "rw",
                    "ky",
                    "kv",
                    "kg",
                    "ko",
                    "kj",
                    "ku",
                    "lo",
                    "la",
                    "lv",
                    "li",
                    "ln",
                    "lt",
                    "lu",
                    "lb",
                    "mk",
                    "mg",
                    "ms",
                    "ml",
                    "mt",
                    "gv",
                    "mi",
                    "mr",
                    "mh",
                    "mn",
                    "na",
                    "nv",
                    "nd",
                    "nr",
                    "ng",
                    "ne",
                    "no",
                    "nb",
                    "nn",
                    "ii",
                    "oc",
                    "oj",
                    "or",
                    "om",
                    "os",
                    "pi",
                    "ps",
                    "fa",
                    "pl",
                    "pt",
                    "pa",
                    "qu",
                    "ro",
                    "rm",
                    "rn",
                    "ru",
                    "se",
                    "sm",
                    "sg",
                    "sa",
                    "sc",
                    "sr",
                    "sn",
                    "sd",
                    "si",
                    "sk",
                    "sl",
                    "so",
                    "st",
                    "es",
                    "su",
                    "sw",
                    "ss",
                    "sv",
                    "tl",
                    "ty",
                    "tg",
                    "ta",
                    "tt",
                    "te",
                    "th",
                    "bo",
                    "ti",
                    "to",
                    "ts",
                    "tn",
                    "tr",
                    "tk",
                    "tw",
                    "ug",
                    "uk",
                    "ur",
                    "uz",
                    "ve",
                    "vi",
                    "vo",
                    "wa",
                    "cy",
                    "wo",
                    "xh",
                    "yi",
                    "yo",
                    "za",
                    "zu"
                  ],
                  "type": "string"
                },
                "twitterHandles": {
                  "description": "Twitter handles that you want to search on Twitter (X)",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "withinRadius": {
                  "description": "Returns tweets sent within the given radius of the given location.",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "options": {
              "additionalProperties": false,
              "description": "Optional Apify run options.",
              "properties": {
                "build": {
                  "maxLength": 100,
                  "minLength": 1,
                  "type": "string"
                },
                "maxItems": {
                  "maximum": 100000,
                  "minimum": 1,
                  "type": "integer"
                },
                "memory": {
                  "maximum": 32768,
                  "minimum": 128,
                  "type": "integer"
                }
              },
              "type": "object"
            }
          },
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST",
            "PUT",
            "PATCH"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}