Twitter Scraper APIsAdvanced Tweet Search API
Twitter Advanced Tweet Search API

Twitter (X) Advanced Tweet Search API for Precise Keyword, User, and Date-Based Search

Search public Twitter posts using keywords, hashtags, usernames, languages, date ranges, engagement thresholds, and other advanced operators. Retrieve Top, Latest, or Media results as detailed structured JSON.

1 focused search endpoint
Up to 100 tweets per page
Cursor-based pagination
1 base credit + 1 credit per tweet
1,000 free credits
No credit card required
GET /v1/twitter/tweets/advanced_search
TWITTER
{
  "data": [
    {
      "id": "888",
      "text": "Just tried this web scraping API and it's incredible...",
      "author": { "username": "dev_user", "followers_count": 4500 },
      "favorite_count": 67,
      "created_at": "2025-01-20T09:15:00Z"
    }
  ],
  "next_cursor": "search_cursor_abc"
}
Endpoints

One Focused Endpoint

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

Cost Calculator

Estimate your advanced search scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 advanced search requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

FAQ

Frequently asked questions

Everything you need to know about the Twitter Advanced Tweet Search API.

What is a Twitter Advanced Tweet Search API?

A Twitter Advanced Tweet Search API lets an application search public Twitter posts using keywords, phrases, hashtags, account names, languages, dates, engagement thresholds, and other advanced operators. ScrapeBadger returns matching posts as structured tweet objects.

Which Twitter advanced search operators are supported?

The documented operators include from:, to:, since:, until:, min_faves:, min_retweets:, and lang:. Queries can also contain ordinary keywords, exact phrases in quotes, hashtags, and combinations of multiple filters in a single query string.

What is the difference between Top, Latest, and Media?

Top returns tweets ranked by popularity and relevance and is the default. Latest returns the most recent matching tweets in reverse-chronological order and may return fewer results than Top. Media returns matching tweets that contain images or videos.

What tweet data is returned?

Responses can include tweet text, author identifiers, timestamps, language, engagement counts, media, URLs, hashtags, mentions, polls, places, reply and quote relationships, edit information, link previews, Community Notes indicators, and the tweet source.

How many tweets can I retrieve per request?

The count parameter accepts values from 1 to 100 and defaults to 20 tweets per page. When another page is available, the response includes a top-level next_cursor that can be passed through the cursor parameter to request the next page.

Can I search the complete historical Twitter archive?

The endpoint searches results currently available through Twitter's search system. The API documentation does not promise access to every historical tweet or guarantee complete archive coverage for all dates and queries. Use since: and until: operators to target a specific date range.

How much does the Twitter Advanced Tweet Search API cost?

Every successful search costs 1 base credit plus 1 credit for each tweet returned. A response containing 20 tweets uses 21 credits; a full 100-tweet page uses 101 credits. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

More Twitter Data APIs

Start building with the Advanced Tweet Search API

Sign up free and get 1,000 API credits. No credit card required.

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.