Pricing

from $0.50 / 1,000 results

Try for free

Go to Apify Store

X (Twitter) Tweet Scraper — browserless

Try for free

Scrapes public tweets from X over its internal GraphQL API using HTTP requests only (no headless browser). Fetch by author handle or tweet ID, filter by hashtag, date, language, engagement and media type. Guest-token rotation, cursor pagination, resumable state, and a strict output schema.

Pricing

from $0.50 / 1,000 results

Rating

0.0

(0)

Developer

Juan ignacio Veltri

Actor stats

Bookmarked

Total users

Monthly active users

22 days ago

Last modified

Categories

Social media

News

Developer tools

You can access the X (Twitter) Tweet Scraper — browserless programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "heCY9M5AIhls307mp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/juanoox~x-tweet-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-juanoox-x-tweet-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/juanoox~x-tweet-scraper/runs": {
      "post": {
        "operationId": "runs-sync-juanoox-x-tweet-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/juanoox~x-tweet-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-juanoox-x-tweet-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": {
          "fromUsers": {
            "title": "From users",
            "uniqueItems": true,
            "type": "array",
            "description": "Handles whose recent tweets should be scraped, without the leading @. Backed by X's profile timeline operation, which is reachable with a guest token.",
            "items": {
              "type": "string"
            }
          },
          "tweetIds": {
            "title": "Tweet IDs",
            "uniqueItems": true,
            "type": "array",
            "description": "Specific tweet IDs to hydrate into the full output schema.",
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "Search terms (topic discovery)",
            "uniqueItems": true,
            "type": "array",
            "description": "Free-text topics. X's own SearchTimeline is closed to guest tokens, so these are resolved a different way: a public search engine is asked which X profiles rank for the topic, those profiles' timelines are read through the guest-token path, and only tweets actually mentioning a term are kept. This finds tweets by accounts that rank for the topic — it is not an exhaustive index of every matching tweet. See the README.",
            "items": {
              "type": "string"
            }
          },
          "hashtags": {
            "title": "Hashtags",
            "uniqueItems": true,
            "type": "array",
            "description": "Keep only tweets containing all of these hashtags, without the leading #. Applied as a post-filter over the fetched timelines.",
            "items": {
              "type": "string"
            }
          },
          "since": {
            "title": "Since (inclusive)",
            "type": "string",
            "description": "Keep only tweets created on or after this date (ISO date, e.g. 2025-01-01)."
          },
          "until": {
            "title": "Until (inclusive)",
            "type": "string",
            "description": "Keep only tweets created on or before this date (ISO date, e.g. 2025-12-31)."
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Keep only tweets whose detected language matches this ISO-639-1 code, e.g. 'en' or 'es'."
          },
          "minLikes": {
            "title": "Minimum likes",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only tweets with at least this many likes."
          },
          "minRetweets": {
            "title": "Minimum retweets",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only tweets with at least this many retweets."
          },
          "minReplies": {
            "title": "Minimum replies",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only tweets with at least this many replies."
          },
          "onlyVerified": {
            "title": "Only verified authors",
            "type": "boolean",
            "description": "Keep only tweets whose author is verified (legacy verified or X Premium blue check).",
            "default": false
          },
          "mediaType": {
            "title": "Media type",
            "enum": [
              "any",
              "text_only",
              "images",
              "video",
              "links"
            ],
            "type": "string",
            "description": "Keep only tweets carrying this kind of media.",
            "default": "any"
          },
          "includeReplies": {
            "title": "Include replies",
            "type": "boolean",
            "description": "Count replies as results.",
            "default": false
          },
          "includeRetweets": {
            "title": "Include retweets",
            "type": "boolean",
            "description": "Count retweets as results.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "latest",
              "top"
            ],
            "type": "string",
            "description": "Ordering, for the surfaces that support it. X's profile timeline is served newest-first, so 'top' is applied by this Actor as an engagement sort over what was fetched.",
            "default": "latest"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "How many items you want. NOTE: free-tier runs are capped server-side at 10 items regardless of this value; raising it cannot lift that cap.",
            "default": 100
          },
          "webhookUrl": {
            "title": "Finish webhook URL",
            "type": "string",
            "description": "Optional. When the run finishes, the summary (counts, timing, the free-tier flag and error tallies) is POSTed as JSON to this URL. Delivery failures are logged and never fail the run."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify Proxy settings. Residential rotation is supported; pick the RESIDENTIAL group and optionally a country.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

X (Twitter) Scraper - Tweets, Profiles & Search Data API OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for X (Twitter) Tweet Scraper — browserless from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

X (Twitter) Tweet Scraper — browserless API in Python

X (Twitter) Tweet Scraper — browserless API in JavaScript

X (Twitter) Tweet Scraper — browserless API through CLI

X (Twitter) Tweet Scraper — browserless API

X (Twitter) Tweet Scraper — browserless

arthurvianna/x-tweet-scraper

Scrapes public tweets from X without a browser engine, using guest-token GraphQL over plain HTTP. Free runs return up to 10 results.

Arthur Vianna

X Tweet Scraper

lucasacci/x-tweet-scraper

Browserless X/Twitter tweet scraper built with Node.js and TypeScript. Extracts and filters tweets using HTTP requests only, with pagination, rate-limit handling, retries, deduplication, resumable state, proxy support, and strict free-tier result limits.

Luciano Casacci

X (Twitter) Tweet Scraper — browserless

davehpino/x-tweet-scraper

Scrapes public tweets from X without a browser, using X internal GraphQL with guest tokens. Rich filtering and a tamper-proof free-tier limit.

David Pino

X Tweet Scraper

ikdem/x-tweet-scraper

Extract public tweets from X (Twitter) by username or tweet ID. No official API key required.

Ikdem Ben Mbarek

X Twitter Tweet Scraper

simoit/x-twitter-search-tweets-scrapper

Scrape X / Twitter tweets by keyword, URL, conversation ID, author, date, engagement, and media filters. Export structured tweet data for monitoring, research, and automation.

simoit

Twitter (X) Tweet Scraper – Search & Export Tweets by Keyword

endspec/twitter-instant-tweet-scraper

Scrape Twitter / X tweets by any keyword, hashtag, phrase, or advanced query (OR, from:, #tag). Export full text, author handle & name, likes, retweets, replies, language, timestamp and tweet URL to JSON, CSV or Excel. No login, no cookies, no Twitter API key. Pay only per tweet returned.

EndSpec

Tweet X Scraper

qaseemiqbal/tweet-x-scraper

Collect public X/Twitter tweets from usernames, from:username queries, tweet URLs, and tweet IDs. Export clean tweet text, author info, engagement metrics, media, links, and run summaries without X login.

Muhammad Qaseem Iqbal

Tweet Scraper - Twitter / X Tweets by Username, URL or ID

goat255/twitter-tweet-scraper

Bulk tweet scraper for Twitter / X: pull tweets by username, tweet URL or tweet ID, with no API key and no login. Get text, media, engagement counts, language and reply or retweet flags. Great for sentiment analysis, brand monitoring and content research. One clean row per tweet.

Goutam Soni

5.0

X Tweet Scraper

devchrisvaz/x-tweet-scraper

Alexander Vazquez

X (Twitter) Tweet Scraper | Search, Hashtags & Profiles

khadinakbar/x-tweet-scraper

Scrape tweets from X.com (Twitter) by search query, hashtag, username, or URL. Returns tweet text, engagement metrics, author info, media, and more $3.00/1K. MCP/API-ready.