logo
languageENdown
menu
Template GalleryTemplate Details

Twitter People Search Scraper

Social MediaMCPMCP
Scrape user name, user handle, user bio, user type, user profile URL, and user avatar URL from search result "People" page via Twitter advanced search.
Access Level
Run Mode
$0.3/1000 lines
Cost of Usage
2026/08/19
Last updated
Try it!

📌 How can you discover public X profiles with advanced search criteria?

This template collects the generated query string and URL plus matching user name, handle, profile URL, avatar URL, bio, and user type from people-search results. It is useful for influencer researchers, social media analysts, and B2B prospecting teams.

Data is collected from X People Search. X is a social network whose search tools surface public posts and accounts matching words, hashtags, languages, and account filters.

💰 Pricing

Current price: $0.3/1,000 lines. Billing is based on the number of output lines produced by the task.

📦 Output

The current published implementation can return the following fields:

  • msg_type
  • content
  • key
  • count
  • fail_count
  • hash_key
  • Query_Str
  • Query_URL
  • User_name
  • User_handle
  • User_URL
  • User_avatar_URL
  • User_bio
  • User_type
{
  "msg_type": null,
  "content": null,
  "key": null,
  "count": null,
  "fail_count": null,
  "hash_key": null,
  "Query_Str": "AI",
  "Query_URL": "https://x.com/search?q=AI&src=typed_query",
  "User_name": "ai",
  "User_handle": "ai_art_2025",
  "User_URL": "https://x.com/ai_art_2025",
  "User_avatar_URL": "https://x.com/ai_art_2025/photo",
  "User_bio": "AIアートで可愛い女性の写真をアップしていきます。 モデルは20歳以上の女性です。 We will upload photos of cute women using AI art. The models are women over 20 years old. (20+ models)",
  "User_type": "Blue verified"
}

🎯 Use Cases

  • Discover profiles matching topics, phrases, hashtags, or account filters.
  • Build creator or expert lists using names, handles, bios, and profile URLs.
  • Review account presentation using avatar and user-type fields.
  • Retain reproducible search provenance using query strings and query URLs.

🐙 Why Octoparse

  • Ready-to-use workflow: The extraction steps for X People Search are already configured, so you do not need to build the scraper from scratch.
  • Flexible execution: Run the ready-made task in the cloud without keeping a local computer online for the collection.
  • Structured, repeatable output: Results are returned as consistent rows that are easier to compare, filter, deduplicate, and process than manually copied pages.
  • Verified input guardrails: The form exposes the current inputs, selectable values, and meaningful limits configured for this template.
  • Practical data handoff: Review results in Octoparse and export or process them using the options supported by your Octoparse environment.

📝 Input

Complete the following fields:

  • All of these words (Optional) — Enter words that must all appear in the X people search.
  • This exact phrase (Optional) — This exact phrase from https://x.com/search-advanced.
  • Any of these words (Optional) — Enter words where at least one should appear in the X people search.
  • None of these words (Optional) — Enter words to exclude from the X people search.
  • These hashtags (Optional) — Enter hashtags to include in the X people search.
  • From these accounts (Optional) — Enter account names whose posts should be included.
  • To these accounts (Optional) — Enter account names that posts should be directed to.
  • Mentioning these accounts (Optional) — Enter account names that posts should mention.
  • Max Tweets to Extract (Optional) — Accepted range: 1 to 999999999.
  • Language (Optional)
  • Scraping mode (Required) — This required field is retained by the current template configuration. Its text does not change the scraping behavior.

🚀 How to Use

  1. Open the template and select Try it or Start.
  2. Complete the input fields listed above.
  3. Start the task using the supported cloud run mode.
  4. Review the output rows and export or process the structured data.

⚠️ Limitations

Results depend on what the source site exposes at run time. A listed output field can be empty when the source page does not provide that value. Input limits shown above are enforced by the template.

💡 Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

❓ FAQ

The Python automation builds an X advanced-search query from the supplied word, hashtag, account, and language criteria, requests people-search results, parses matching profiles, and uploads structured user records.

What input does this Twitter People Search Scraper require?

Use the fields and accepted values shown in the Input section. Only user-relevant limits and selectable options are listed.

The current output fields and a representative JSON Data Preview are listed in the Output section. Field availability can vary when the source page does not display a value.

How much does this Twitter People Search Scraper cost?

The current price is $0.3/1,000 lines, and billing is based on the number of output lines produced by the task.

Why can some X People Search fields be empty?

Source pages do not always expose every value for every record, and layouts can vary by item, market, or current site response. The template returns a field when the current page provides it.

Can I export the collected X People Search data?

You can review the structured rows in Octoparse and export or process them using the options supported by your Octoparse environment.

🔗 Related Templates

Share