X (Twitter) Advanced Search Post Scraper 𝕏

Pricing

Pay per event

Try for free

Go to Apify Store

X (Twitter) Advanced Search Post Scraper 𝕏

Rising star

Try for free

Advanced X (Twitter) post search with 50+ filters: content, users, geo, time, engagement, media. Dual modes: simple queries or structured filters. Enterprise-grade reliability for precise data extraction

Pricing

Pay per event

Rating

4.9

(38)

Developer

API ninja

Maintained by Community

Actor stats

Bookmarked

351

Total users

Monthly active users

0.6 hours

Issues response

2 days ago

Last modified

Categories

Social media

Automation

Integrations

You can access the X (Twitter) Advanced Search Post 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.0",
    "x-build-id": "GjO8FDrhvbuK1Mr4T"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/api-ninja~x-twitter-advanced-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-api-ninja-x-twitter-advanced-search",
        "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-ninja~x-twitter-advanced-search/runs": {
      "post": {
        "operationId": "runs-sync-api-ninja-x-twitter-advanced-search",
        "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-ninja~x-twitter-advanced-search/run-sync": {
      "post": {
        "operationId": "run-sync-api-ninja-x-twitter-advanced-search",
        "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": {
          "query": {
            "title": "Simple Search Query",
            "type": "string",
            "description": "Enter your search terms here for quick and easy Twitter searches. Supports Twitter's powerful search operators for precise results. You can use this simple search OR configure advanced filters below - at least one must be provided."
          },
          "search_type": {
            "title": "Search Type",
            "enum": [
              "Latest",
              "Top",
              "Media",
              "People"
            ],
            "type": "string",
            "description": "Choose your search strategy: 'Latest' for real-time results, 'Top' for popular tweets, 'Media' for tweets with images/videos, or 'People' for user accounts.",
            "default": "Latest"
          },
          "numberOfTweets": {
            "title": "Number of Tweets",
            "minimum": 20,
            "maximum": 50000,
            "type": "integer",
            "description": "Specify how many tweets you want to collect (20-50000). Our intelligent system automatically handles multiple requests to ensure you get exactly the number you need.",
            "default": 100
          },
          "engagementLevel": {
            "title": "Engagement Level Preset",
            "enum": [
              "none",
              "low",
              "medium",
              "high",
              "viral"
            ],
            "type": "string",
            "description": "Smart presets for common engagement scenarios. Choose a preset for instant setup or customize with specific values below for precise control.",
            "default": "none"
          },
          "engagementMinRetweets": {
            "title": "Minimum Retweets",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum number of retweets (shares). Leave empty for no minimum."
          },
          "engagementMaxRetweets": {
            "title": "Maximum Retweets",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of retweets (shares). Leave empty for no maximum."
          },
          "engagementMinLikes": {
            "title": "Minimum Likes",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum number of likes (hearts). Leave empty for no minimum."
          },
          "engagementMaxLikes": {
            "title": "Maximum Likes",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of likes (hearts). Leave empty for no maximum."
          },
          "engagementMinReplies": {
            "title": "Minimum Replies",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum number of replies (comments). Leave empty for no minimum."
          },
          "engagementMaxReplies": {
            "title": "Maximum Replies",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of replies (comments). Leave empty for no maximum."
          },
          "engagementHasEngagement": {
            "title": "Must Have Any Engagement",
            "type": "boolean",
            "description": "Only include tweets that have at least some engagement (likes, retweets, or replies)"
          },
          "mediaTypes": {
            "title": "Media Types",
            "type": "array",
            "description": "Types of media to include",
            "items": {
              "type": "string",
              "enum": [
                "media",
                "images",
                "videos",
                "twimg",
                "native_video",
                "consumer_video",
                "pro_video",
                "vine",
                "periscope",
                "spaces"
              ],
              "enumTitles": [
                "Any Media",
                "Images",
                "Videos",
                "Twitter Images",
                "Native Video",
                "Consumer Video",
                "Pro Video",
                "Vine",
                "Periscope",
                "Spaces"
              ]
            }
          },
          "mediaHasLinks": {
            "title": "Has Links",
            "type": "boolean",
            "description": "Must contain links"
          },
          "mediaHasMentions": {
            "title": "Has Mentions",
            "type": "boolean",
            "description": "Must contain mentions"
          },
          "mediaHasHashtags": {
            "title": "Has Hashtags",
            "type": "boolean",
            "description": "Must contain hashtags"
          },
          "mediaNewsOnly": {
            "title": "News Only",
            "type": "boolean",
            "description": "Only tweets with news links"
          },
          "mediaSafeContentOnly": {
            "title": "Safe Content Only",
            "type": "boolean",
            "description": "Exclude potentially sensitive content"
          },
          "usersBlueVerifiedOnly": {
            "title": "Blue Verified Users Only",
            "type": "boolean",
            "description": "Only tweets from blue verified users"
          },
          "usersVerifiedOnly": {
            "title": "Verified Users Only",
            "type": "boolean",
            "description": "Only tweets from verified users"
          },
          "usersFromUsers": {
            "title": "From Users",
            "type": "array",
            "description": "Tweets from specific users (without @)",
            "items": {
              "type": "string"
            }
          },
          "usersToUsers": {
            "title": "To Users",
            "type": "array",
            "description": "Replies to specific users (without @)",
            "items": {
              "type": "string"
            }
          },
          "usersMentionUsers": {
            "title": "Mention Users",
            "type": "array",
            "description": "Tweets mentioning specific users (without @)",
            "items": {
              "type": "string"
            }
          },
          "usersExcludeFromUsers": {
            "title": "Exclude From Users",
            "type": "array",
            "description": "Exclude tweets from specific users (without @)",
            "items": {
              "type": "string"
            }
          },
          "usersListMembers": {
            "title": "From List Members",
            "type": "array",
            "description": "Tweets from members of specific lists (list ID or username/listname)",
            "items": {
              "type": "string"
            }
          },
          "contentLanguage": {
            "title": "Language",
            "enum": [
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "ru",
              "ja",
              "ko",
              "zh",
              "ar",
              "hi",
              "nl",
              "sv",
              "no",
              "da",
              "fi",
              "pl",
              "tr",
              "el",
              "iw",
              "th",
              "vi",
              "in",
              "ms",
              "tl"
            ],
            "type": "string",
            "description": "Language filter for tweets"
          },
          "contentEmoticons": {
            "title": "Emoticon Sentiment",
            "enum": [
              "positive",
              "negative"
            ],
            "type": "string",
            "description": "Filter by emoticon sentiment"
          },
          "contentKeywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Keywords to search for in tweet content",
            "items": {
              "type": "string"
            }
          },
          "contentExactPhrases": {
            "title": "Exact Phrases",
            "type": "array",
            "description": "Exact phrases to search for (use quotes)",
            "items": {
              "type": "string"
            }
          },
          "contentExcludeKeywords": {
            "title": "Exclude Keywords",
            "type": "array",
            "description": "Keywords to exclude from results",
            "items": {
              "type": "string"
            }
          },
          "contentHashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "Hashtags to include (without #)",
            "items": {
              "type": "string"
            }
          },
          "contentExcludeHashtags": {
            "title": "Exclude Hashtags",
            "type": "array",
            "description": "Hashtags to exclude (without #)",
            "items": {
              "type": "string"
            }
          },
          "contentCashtags": {
            "title": "Cashtags",
            "type": "array",
            "description": "Stock symbols to include (without $)",
            "items": {
              "type": "string"
            }
          },
          "contentQuestionMarks": {
            "title": "Include Question Marks",
            "type": "boolean",
            "description": "Include tweets with question marks"
          },
          "tweetTypes": {
            "title": "Include Tweet Types",
            "type": "array",
            "description": "Types of tweets to include",
            "items": {
              "type": "string",
              "enum": [
                "original",
                "retweets",
                "quotes",
                "replies",
                "self_threads"
              ],
              "enumTitles": [
                "Original Tweets",
                "Retweets",
                "Quote Tweets",
                "Replies",
                "Self Threads"
              ]
            }
          },
          "tweetTypesExclude": {
            "title": "Exclude Tweet Types",
            "type": "array",
            "description": "Types of tweets to exclude",
            "items": {
              "type": "string",
              "enum": [
                "original",
                "retweets",
                "quotes",
                "replies",
                "self_threads"
              ],
              "enumTitles": [
                "Original Tweets",
                "Retweets",
                "Quote Tweets",
                "Replies",
                "Self Threads"
              ]
            }
          },
          "tweetConversationId": {
            "title": "Conversation ID",
            "type": "string",
            "description": "Tweets that are part of a specific conversation/thread"
          },
          "tweetQuotedTweetId": {
            "title": "Quoted Tweet ID",
            "type": "string",
            "description": "Tweets that quote a specific tweet"
          },
          "tweetQuotedUserId": {
            "title": "Quoted User ID",
            "type": "string",
            "description": "Tweets that quote a specific user (numeric user ID)"
          },
          "tweetPollTypes": {
            "title": "Poll Types",
            "type": "array",
            "description": "Tweets containing polls",
            "items": {
              "type": "string",
              "enum": [
                "poll2choice_text_only",
                "poll3choice_text_only",
                "poll4choice_text_only",
                "poll2choice_image",
                "poll3choice_image",
                "poll4choice_image"
              ],
              "enumTitles": [
                "2 Choice Text Poll",
                "3 Choice Text Poll",
                "4 Choice Text Poll",
                "2 Choice Image Poll",
                "3 Choice Image Poll",
                "4 Choice Image Poll"
              ]
            }
          },
          "timeSince": {
            "title": "Since Date",
            "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
            "type": "string",
            "description": "Start date (YYYY-MM-DD)"
          },
          "timeUntil": {
            "title": "Until Date",
            "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
            "type": "string",
            "description": "End date (YYYY-MM-DD)"
          },
          "timeWithinTime": {
            "title": "Within Time",
            "pattern": "^(\\d+)\\s*(d|h|m|s)$",
            "type": "string",
            "description": "Search within last X time (e.g., '2d', '3h', '5m', '30s')"
          },
          "timeSinceUnix": {
            "title": "Since Unix Timestamp",
            "minimum": 0,
            "type": "integer",
            "description": "Start time as Unix timestamp in seconds"
          },
          "timeUntilUnix": {
            "title": "Until Unix Timestamp",
            "minimum": 0,
            "type": "integer",
            "description": "End time as Unix timestamp in seconds"
          },
          "timeSinceId": {
            "title": "Since Tweet ID",
            "type": "string",
            "description": "Start after this Snowflake tweet ID"
          },
          "timeMaxId": {
            "title": "Max Tweet ID",
            "type": "string",
            "description": "End at or before this Snowflake tweet ID"
          },
          "geoNear": {
            "title": "Near Location",
            "type": "string",
            "description": "Location to search near"
          },
          "geoWithinRadius": {
            "title": "Within Radius",
            "type": "string",
            "description": "Radius for location search (e.g., '10km', '5mi')"
          },
          "geoGeocode": {
            "title": "Geocode",
            "type": "string",
            "description": "Exact coordinates (lat,long,radius) e.g., '37.7764685,-122.4172004,10km'"
          },
          "geoPlaceId": {
            "title": "Place ID",
            "type": "string",
            "description": "Twitter Place Object ID (e.g., '96683cc9126741d1' for USA)"
          },
          "appsSources": {
            "title": "Sources",
            "type": "array",
            "description": "Tweets from specific apps/sources",
            "items": {
              "type": "string"
            }
          },
          "appsExcludeSources": {
            "title": "Exclude Sources",
            "type": "array",
            "description": "Exclude tweets from specific apps/sources",
            "items": {
              "type": "string"
            }
          },
          "cardDomain": {
            "title": "Card Domain",
            "type": "string",
            "description": "Domain name in Twitter Card (e.g., 'pscp.tv')"
          },
          "cardUrl": {
            "title": "Card URL",
            "type": "string",
            "description": "URL in Twitter Card"
          },
          "cardName": {
            "title": "Card Name",
            "enum": [
              "audio",
              "animated_gif",
              "player",
              "app",
              "promo_image_app",
              "summary",
              "summary_large_image",
              "promo_website",
              "promo_image_convo",
              "promo_video_convo",
              "moment"
            ],
            "type": "string",
            "description": "Twitter Card name (e.g., 'audio', 'animated_gif', 'player', 'app', 'summary', 'summary_large_image')"
          }
        }
      },
      "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 Advanced Search · 50+ Filters Tool 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) Advanced Search Post 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:

X (Twitter) Advanced Search Post Scraper 𝕏 API in Python

X (Twitter) Advanced Search Post Scraper 𝕏 API in JavaScript

X (Twitter) Advanced Search Post Scraper 𝕏 API through CLI

X (Twitter) Advanced Search Post Scraper 𝕏 API

X (Twitter) Posts Search

scraper_one/x-posts-search

✨ Search for X (formerly Twitter) posts using keywords or hashtags. Retrieve post URLs, content, publication dates, author details, and engagement metrics. Ideal for monitoring brand mentions on X over time.

Scraper One

539

Twitter Search

twitterapi/twitter-search

Advanced Search

dayang

108

Twitter (X.com) Search Scraper

web.harvester/easy-twitter-search-scraper

Easily extract tweets from Twitter (X.com) search results with our powerful Twitter Search Scraper. Get full tweet data, including text, engagement, media, and user info. Export in JSON, CSV, Excel, or HTML—perfect for social media monitoring, market research, competitor analysis, and trend tracking

Web Harvester

5.8K

2.2

X (Twitter) Community Search Post Scraper 𝕏

api-ninja/x-twitter-community-search-post-scraper

Extract tweets from X (Twitter) communities. Process single or multiple communities, get comprehensive tweet data with community context, and handle large-scale data collection efficiently.

API ninja

4.9

Twitter Advanced Search Scraper

mikolabs/Twitter-advanced-search-scraper

Advanced Twitter/X scraper with powerful filtering capabilities. Extract detailed tweet info, user profiles, and media. Supports search by query, user, hashtags, and more.

mikolabs

Twitter Search Scraper

twittapi/twitter-search-scraper

Twitter Search Scraper

twittapi

5.0

Search X By Keywords

watcher.data/search-x-by-keywords

Fast and reliable scraper for searching tweets and users on X (Twitter). Supports multiple output formats (JSON, CSV, Excel), advanced filtering options, and real-time data extraction. Perfect for social media monitoring, research, and business intelligence.

Giichi Arai

261

Twitter (X.com) Search Dataset Cookieless(Full History)

patient_discovery/twitter-search

Extract comprehensive Twitter (X) search results including hidden metadata, engagement metrics, and granular timestamps. High-fidelity, cookieless data extraction tool designed for precise sales intelligence and competitive analysis.

Surge Street

Twitter X-Plorer 🦜

jupri/twitter-scraper

💫 All-in-one Twitter X.com Scraper 🐦🐦‍⬛🐤

cat

727

5.0

X.com Twitter API Scraper

xtdata/twitter-x-scraper

Scrape Twitter (X) data efficiently with this powerful Apify Actor. Real-time, authentic data. No pre-built databases. Extract tweets, user profiles, and more using keywords, hashtags, URLs, and advanced search filters. Fast, reliable, and cost-effective. #TwitterScraper