logo
languageENdown
menu

Twitter Advanced Search Scraper

Collect data from Twitter Advanced Search Scraper.

Overview

What this app does

Collect public data from Twitter Advanced Search Scraper.

Notes

  • Data is collected from Octoparse public crawling endpoints.
  • This app is rate-limited by upstream platform responses and pagination.

Scope and boundaries

Each run uses the template 'twitter-scraper-by-keywords' with validated input schema constraints.

  • Good for
  • Use this app when you need public data from the corresponding source template.
  • Do not use for
  • Do not use it for login-only, private, or inaccessible data that is not publicly visible.

Failure handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1Retry failed runs with smaller input scope. If repeated failures continue, verify input format and retry later.

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
datesDates (From)stringYes——2024-01-01Dates (From)
dates_2Dates (To)stringYes——2024-01-02Dates (To)
max_Tweets_to_ExtractMax Tweets to ExtractnumberYes——10Max Tweets to Extract
all_of_these_wordsAll of these wordsstringNo——technologyAll of these words
this_exact_phraseThis exact phrasestringNo——This exact phraseThis exact phrase
any_of_these_wordsAny of these wordsstringNo——Any of these wordsAny of these words
none_of_these_wordsNone of these wordsstringNo——None of these wordsNone of these words
these_hashtagsThese hashtagsstringNo——These hashtagsThese hashtags
from_these_accountsFrom these accountsstringNo——From these accountsFrom these accounts
to_these_accountsTo these accountsstringNo——To these accountsTo these accounts
mentioning_these_accountsMentioning these accountsstringNo——Mentioning these accountsMentioning these accounts
minimum_repliesMinimum repliesnumberNo——1Minimum replies
minimum_likesMinimum likesnumberNo——1Minimum likes
minimum_repostsMinimum repostsnumberNo——1Minimum reposts
languageLanguagestringNo——LanguageLanguage
include_Top_ResultsInclude "Top" ResultsstringNo——Include "Top" ResultsInclude "Top" Results
cloud_ClusterCloud ClusterstringNo——Cloud ClusterCloud Cluster
scraping_modeScraping modearray<string>Yes——["day"]Scraping mode
reply_FilterReply FilterstringNo——Reply FilterReply Filter
include_replies_and_original_postsInclude replies and original postsstringNo——Include replies and original postsInclude replies and original posts
only_show_repliesOnly show repliesstringNo——Only show repliesOnly show replies

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
adsAdsstring—
author_HandleAuthor_Handlestring—
author_NameAuthor_Namestring—
author_Web_Page_URLAuthor_Web_Page_URLstring—
bookmark_CountBookmark_Countstring—
languageLanguagestring—
like_CountLike_Countstring—
post_IDPost_IDstring—
post_URLPost_URLstring—
query_StrQuery_Strstring—
quoteContentQuoteContentstring—
quoteTwitterURLQuoteTwitterURLstring—
reply_CountReply_Countstring—
reply_to_WhomReply_to_Whomstring—
reply_to_Whom_HandleReply_to_Whom_Handlestring—
reply_to_Whom_URLReply_to_Whom_URLstring—
reply_to_Whom_UsernameReply_to_Whom_Usernamestring—
replying_toReplying_tostring—
repost_CountRepost_Countstring—
tweet_ContentTweet_Contentstring—
tweet_Image_URLTweet_Image_URLstring—
tweet_URLTweet_URLstring—
typeTypestring—
uTC_TimeUTC_Timestring—
verified_StatusVerified_Statusstring—
view_CountView_Countstring—

Record schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "ads": {
      "type": "string",
      "title": "Ads",
      "prefill": ""
    },
    "author_Handle": {
      "type": "string",
      "title": "Author_Handle",
      "prefill": ""
    },
    "author_Name": {
      "type": "string",
      "title": "Author_Name",
      "prefill": ""
    },
    "author_Web_Page_URL": {
      "type": "string",
      "title": "Author_Web_Page_URL",
      "prefill": ""
    },
    "bookmark_Count": {
      "type": "string",
      "title": "Bookmark_Count",
      "prefill": ""
    },
    "language": {
      "type": "string",
      "title": "Language",
      "prefill": ""
    },
    "like_Count": {
      "type": "string",
      "title": "Like_Count",
      "prefill": ""
    },
    "post_ID": {
      "type": "string",
      "title": "Post_ID",
      "prefill": ""
    },
    "post_URL": {
      "type": "string",
      "title": "Post_URL",
      "prefill": ""
    },
    "query_Str": {
      "type": "string",
      "title": "Query_Str",
      "prefill": ""
    },
    "quoteContent": {
      "type": "string",
      "title": "QuoteContent",
      "prefill": ""
    },
    "quoteTwitterURL": {
      "type": "string",
      "title": "QuoteTwitterURL",
      "prefill": ""
    },
    "reply_Count": {
      "type": "string",
      "title": "Reply_Count",
      "prefill": ""
    },
    "reply_to_Whom": {
      "type": "string",
      "title": "Reply_to_Whom",
      "prefill": ""
    },
    "reply_to_Whom_Handle": {
      "type": "string",
      "title": "Reply_to_Whom_Handle",
      "prefill": ""
    },
    "reply_to_Whom_URL": {
      "type": "string",
      "title": "Reply_to_Whom_URL",
      "prefill": ""
    },
    "reply_to_Whom_Username": {
      "type": "string",
      "title": "Reply_to_Whom_Username",
      "prefill": ""
    },
    "replying_to": {
      "type": "string",
      "title": "Replying_to",
      "prefill": ""
    },
    "repost_Count": {
      "type": "string",
      "title": "Repost_Count",
      "prefill": ""
    },
    "tweet_Content": {
      "type": "string",
      "title": "Tweet_Content",
      "prefill": ""
    },
    "tweet_Image_URL": {
      "type": "string",
      "title": "Tweet_Image_URL",
      "prefill": ""
    },
    "tweet_URL": {
      "type": "string",
      "title": "Tweet_URL",
      "prefill": ""
    },
    "type": {
      "type": "string",
      "title": "Type",
      "prefill": ""
    },
    "uTC_Time": {
      "type": "string",
      "title": "UTC_Time",
      "prefill": ""
    },
    "verified_Status": {
      "type": "string",
      "title": "Verified_Status",
      "prefill": ""
    },
    "view_Count": {
      "type": "string",
      "title": "View_Count",
      "prefill": ""
    }
  },
  "required": [],
  "additionalProperties": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "YiJacobJohnRaku__twitter-scraper-by-keywords": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=YiJacobJohnRaku/twitter-scraper-by-keywords",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

returned record

Charged by the number of records successfully returned. Failed runs are not charged.

$0.0003/ record

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
$0.0003 / record