# Tweet Scraper V2 - X / Twitter Scraper (apidojo)

> Tweet Scraper V2 - X / Twitter Scraper (apidojo) is a paid API for AI agents from stableapify.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Starts an Apify actor run to scrape tweets by username, search query, URL, list, or profile with customizable filters at high speed

## Facts

- Endpoint: POST https://stableapify.dev/api/actors/apidojo/tweet-scraper/call
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tweet-scraper-v2-x-twitter-scraper-apidojo-10c49c52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PPWj6-HbCIVhlBe9gHPIz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tweet-scraper-v2-x-twitter-scraper-apidojo-10c49c52 -d '<json body>'
```

Example prompt: Scrape up to 200 tweets from the Twitter user @elonmusk using the Tweet Scraper V2 actor, with 1024 MB of memory allocated.

## When to prefer this

Choose this endpoint when you need fast, high-volume tweet extraction from Twitter/X by username, keyword search, URL, list, or profile. At $0.40 per 1000 tweets and 30–80 tweets/second, it is cost-effective for bulk data collection. Prefer over manual scraping or less specialized APIs when you need structured tweet data at scale with filtering options.

## Known failure modes

- Invalid username or query yields empty dataset
- Insufficient memory setting causes actor to fail or time out
- Rate limits or Twitter anti-bot measures may reduce tweet yield
- Expired or invalid token prevents dataset retrieval
- Actor may return READY status but fail asynchronously — status must be polled
- maxItems set too high may exhaust budget or hit Apify limits

## How this service works

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…

## Output

Returns an actor run object containing the run ID, status (READY), actor ID, start timestamp, total USD usage, default dataset ID for retrieving scraped tweets, and a JWT access token used to fetch results from the dataset endpoint.

## Example request

```json
{
 "input": {
  "username": "sarptecimer"
 },
 "options": {
  "memory": 1024,
  "maxItems": 100
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "end": {
     "type": "string",
     "description": "Returns tweets sent before the given date."
    },
    "sort": {
     "enum": [
      "Top",
      "Latest",
      "Latest + Top"
     ],
     "type": "string",
     "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."
    },
    "start": {
     "type": "string",
     "description": "Returns tweets sent after the given date."
    },
    "author": {
     "type": "string",
     "description": "Returns tweets sent by the given user. It should be a Twitter (X) Handle."
    },
    "geocode": {
     "type": "string",
     "description": "Returns tweets sent by users located within a given radius of the given latitude/longitude."
    },
    "maxItems": {
     "type": "integer",
     "maximum": 9007199254740991,
     "minimum": -9007199254740991,
     "description": "Maximum number of items that you want as output."
    },
    "inReplyTo": {
     "type": "string",
     "description": "Returns tweets that are replies to the given user. It should be a Twitter (X) Handle."
    },
    "onlyImage": {
     "type": "boolean",
     "description": "If selected, only returns tweets that contain images."
    },
    "onlyQuote": {
     "type": "boolean",
     "description": "If selected, only returns tweets that are quotes."
    },
    "onlyVideo": {
     "type": "boolean",
     "description": "If selected, only returns tweets that contain videos."
    },
    "startUrls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Twitter (X) URLs. Paste the URLs and get the results immediately. Tweet, Profile, Search or List URLs are supported."
    },
    "mentioning": {
     "type": "string",
     "description": "Returns tweets mentioning the given user. It should be a Twitter (X) Handle."
    },
    "searchTerms": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Search terms you want to search from Twitter (X). You can refer to https://github.com/igorbrigadir/twitter-advanced-search."
    },
    "withinRadius": {
     "type": "string",
     "description": "Returns tweets sent within the given radius of the given location."
    },
    "geotaggedNear": {
     "type": "string",
     "description": "Returns tweets sent
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tweet-scraper-v2-x-twitter-scraper-apidojo-10c49c52/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableapify.dev](https://www.zero.xyz/host/stableapify.dev/llms.txt)