Pricing

Pay per usage

Twitter Profile Scraper

Scrape public Twitter X profiles with detailed data, including bios, followers, following, tweets, links, and engagement metrics. This actor exports clean, structured JSON or CSV for research, analytics, lead generation, and social insights at scale.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

API Empire

Actor stats

Bookmarked

Total users

Monthly active users

15 days ago

Last modified

Categories

Automation

Lead generation

Social media

You can access the Twitter Profile Scraper 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 Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.2",
    "x-build-id": "S5kaTT9Qyd37UChNO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/api-empire~twitter-profile-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-api-empire-twitter-profile-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/api-empire~twitter-profile-scraper/runs": {
      "post": {
        "operationId": "runs-sync-api-empire-twitter-profile-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/api-empire~twitter-profile-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-api-empire-twitter-profile-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": {
          "startUrls": {
            "title": "🔗 Profile URLs",
            "type": "array",
            "description": "List of Twitter/X profile URLs (e.g., https://x.com/elonmusk). Required if twitterHandles is empty.",
            "default": [
              "elonmusk"
            ],
            "items": {
              "type": "string"
            }
          },
          "twitterHandles": {
            "title": "🏷️ Twitter Handles",
            "type": "array",
            "description": "List of usernames without the @ (e.g., elonmusk). Required if startUrls is empty.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "📦 Maximum Items",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on total items written across the whole run.",
            "default": 10
          },
          "start": {
            "title": "📅 Start Date (UTC)",
            "type": "string",
            "description": "Lower bound for tweet date. Use absolute date (YYYY-MM-DD) or relative value (for example, 7 days). Empty = no lower bound.",
            "default": ""
          },
          "end": {
            "title": "📅 End Date (UTC)",
            "type": "string",
            "description": "Upper bound for tweet date. Use absolute date (YYYY-MM-DD) or relative value (for example, 1 day). Empty = no upper bound.",
            "default": ""
          },
          "includeNativeRetweets": {
            "title": "🔁 Include Native Retweets",
            "type": "boolean",
            "description": "When false, native retweets (full_text starts with 'RT @') are dropped. Only effective for the last ~7-10 days.",
            "default": false
          },
          "onlyImages": {
            "title": "🖼️ Only Tweets With Images",
            "type": "boolean",
            "description": "Keep only tweets that contain at least one photo.",
            "default": false
          },
          "getAboutData": {
            "title": "👤 Emit Profile About Data",
            "type": "boolean",
            "description": "Emit one profile-about record per user (uses the embedded user object from UserTweets).",
            "default": false
          },
          "getReplies": {
            "title": "💬 Scrape Replies",
            "type": "boolean",
            "description": "Fetch replies to each qualifying tweet via the TweetDetail endpoint. Requires login cookies.",
            "default": false
          },
          "minReplyCount": {
            "title": "📈 Minimum Reply Count",
            "minimum": 0,
            "type": "integer",
            "description": "Only fetch replies for tweets whose reply_count is at least this value.",
            "default": 0
          },
          "authToken": {
            "title": "🔐 auth_token Cookie",
            "type": "string",
            "description": "Value of the `auth_token` cookie from x.com (devtools → Application → Cookies). Required for getReplies."
          },
          "csrfToken": {
            "title": "🛡️ ct0 Cookie",
            "type": "string",
            "description": "Value of the `ct0` cookie from x.com. Required for getReplies."
          },
          "proxyConfiguration": {
            "title": "🌐 Proxy Configuration",
            "type": "object",
            "description": "Apify proxy configuration. Recommended for reliability against rate limits."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Twitter Profile Scraper 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 Twitter Profile Scraper 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:

Twitter Profile Scraper API in Python

Twitter Profile Scraper API in JavaScript

Twitter Profile Scraper API through CLI

Twitter Profile Scraper API

Twitter (X.com) Tweets & Profiles Scraper

api-empire/twitter-scraper

Scrape public Twitter X profiles with tweets, bios, followers, links, and engagement data. This actor captures structured profile insights at scale, supports keyword filtering, and exports clean JSON or CSV for research, analysis, and automation workflows.

API Empire

X/Twitter Scraper — Tweets, Profiles & Engagement Data

oneary/twitter-scraper

Scrape Twitter/X data at scale. Extract tweets, profiles, hashtags, trends, and engagement metrics for social media analytics.

Luan M.

Twitter X Tweets Profiles Scraper

scrapepilotapi/twitter-x-tweets-profiles-scraper

🐦 Twitter X Tweets Profiles Scraper pulls public tweets & profile data—bios, followers, hashtags, mentions, links, engagement. 🔎 Fast, reliable exports for social listening, brand monitoring, market research & lead gen. 🚀 Output to CSV/JSON.

ScrapePilot

Twitter X Tweets Profiles Scraper

scraply/twitter-x-tweets-profiles-scraper

🐦 Twitter/X Tweets & Profiles Scraper extracts public tweets, bios, followers, hashtags, mentions, links, timestamps & engagement. ⚡ Ideal for social listening, brand monitoring, competitor analysis, research & lead gen. 📊 Clean, structured CSV/JSON for fast insights.

Scraply

Twitter X Tweets Profiles Scraper

scrapier/twitter-x-tweets-profiles-scraper

🐦 Twitter X Tweets Profiles Scraper pulls public tweets & profile data at scale—bios, followers, links, hashtags, mentions, engagement & timestamps. 📥 Export CSV/JSON. 🔎 Ideal for social listening, brand monitoring, competitor analysis & lead gen. ⚡ Fast, reliable.

Scrapier

Twitter X Tweets Profiles Scraper

scrapeengine/twitter-x-tweets-profiles-scraper

🐦 Twitter X Tweets & Profiles Scraper extracts public tweets and profile data — bios, followers, engagement, hashtags, mentions, links & timestamps — at scale. 🔎 Perfect for social listening, competitor analysis, lead gen & marketing research. ⚡ Fast, accurate, export-ready.

ScrapeEngine

Twitter X Tweets Profiles Scraper

scrapemesh/twitter-x-tweets-profiles-scraper

🐦 Twitter X Tweets Profiles Scraper extracts tweets and profile data at scale — bios, usernames, followers, engagement, hashtags, mentions, links & timestamps. 📊 Ideal for social listening, sentiment, competitor research, lead gen & marketing analytics. ⚡ Fast, reliable, export-ready.

ScrapeMesh

Twitter Profile Scraper

scraper-engine/twitter-profile-scraper

Scrapes public Twitter X profiles, capturing usernames, bios, follower and following counts, tweets, media, timestamps, engagement metrics, and profile URLs. Ideal for influencer research, competitor analysis, audience insights, and large-scale Twitter X profile data extraction.

Scraper Engine

5.0

Twitter (X.com) Tweets & Profiles Scraper

simpleapi/twitter-x-scraper

Twitter X Tweets Profiles Scraper collects tweets and profile details from any public X (Twitter) account, including bios, follower stats, timestamps, media, hashtags, and engagement metrics. Ideal for research, trend tracking, social listening, and automating structured Twitter/X data extraction

SimpleAPI

Twitter Profile & Tweets Scraper

scrapio/twitter-profile-scraper

Scrapes public Twitter X profiles, capturing usernames, bios, follower and following counts, tweets, media, timestamps, engagement stats, and profile URLs. Ideal for influencer research, competitor analysis, audience insights, and large-scale Twitter X profile data extraction