Meta Threads Scraper - Posts, Profiles & Search

Extract comprehensive Threads data including posts, profiles, engagement metrics (likes, replies, reposts, shares, views), and contact information from bios. Scrape user posts, search by hashtag/tag, or search by keyword with filters. Built for social media monitoring, influencer outreach, and competitive analysis. No login required. Export to JSON/CSV/Excel.

Note: This is an experimental tool. Website structure may occasionally change, which could affect data extraction. Please test with small batches before large-scale use.

What Data Can You Get?

User Profile Information

• Username and display name
• Bio/description (full text)
• Profile picture URL (standard and high-resolution variants)
• Follower count (when available)
• Verification status
• Fediverse / ActivityPub participation flag
• Profile URL
• Contact information: emails, phone numbers, and website links extracted from bio
• External profile links
• Interest and topic tags from the user's profile
• Linked podcast name and URL (when available)

Post Content

• Text content
• Post creation time (ISO, formatted, and Unix timestamp)
• Post URL and unique code
• Engagement metrics: likes, replies, reposts, quotes, shares, and views
• Pinned post indicator and edit status
• Sponsored / paid-partnership flag
• Accessibility / alt-text caption on images (when available)
• Original media width and height
• Media attachments (images/videos)
• Hashtags used
• User mentions (@username format)
• External links

Conversation Context (per post)

• Reply flag with the username being replied to
• Reply-control setting (who is allowed to reply)
• Quote-post flag and the URL of the quoted post
• Repost flag and the URL of the original post

Why This Scraper?

Core capabilities (what most users come for)

Need	This actor
All 6 engagement metrics (likes, replies, reposts, quotes, shares, views)	✅
Bio contact extraction (emails, phones, links) for lead gen	✅
Search by username, hashtag, or keyword	✅
Date-bounded research (start_date / end_date)	✅
Batch up to 20 users or 20 keywords per run	✅
No login / no sessionid required	✅

Pro features (deeper analytics)

Feature	What it enables
Sponsored / paid-partnership flag	Filter organic vs branded content
Quote / repost source URLs	Map conversation graphs across posts
Reply context (target username + reply-control)	Reconstruct thread structure
Image accessibility caption	Content cataloging and a11y workflows
HD profile picture URL	Premium branding research
Fediverse / ActivityPub flag	Cross-platform reach analysis

Quick Picker

• Want a specific account's posts → mode: "user"
• Want posts under a hashtag → mode: "keyword"
• Want a topic's high-engagement results → mode: "search" + search_filter: "top"
• Want posts inside a date window → mode: "search" + start_date / end_date

Use Cases

• Social Media Monitoring: Track brand mentions and conversations
• Influencer Discovery: Find content creators with follower metrics
• Competitor Research: Monitor competitor activity and engagement
• Content Analysis: Analyze trending topics and hashtags
• Lead Generation: Discover profiles in your niche
• Market Research: Understand audience sentiment

How to Use

Input Configuration

Parameter	Type	Description	Example
mode	string	Scraping mode: user, keyword, or search	"user"
usernames	array	Target usernames (for user mode, without @, max 20)	["zuck", "nike"]
keywords	array	Hashtags or search terms (for keyword/search mode, max 20)	["AI", "tech"]
search_filter	string	Sort search results (search mode only): top (popular) or recent (newest first)	"top"
start_date	string	Search by Keyword only. Show posts from this date onward (YYYY-MM-DD or "7 days")	"2026-01-01"
end_date	string	Search by Keyword only. Show posts up to this date (inclusive)	"7 days"
max_posts	number	Posts per source (10-500)	200

Note: Date options are only for Search by Keyword. If you use them in User Posts or Hashtag / Tag, the run will stop and show a clear reminder.

Mode 1: Scrape User Posts (with Profile Data)

Extract posts and complete profile information from a specific user:

{
  "mode": "user",
  "usernames": ["zuck"],
  "max_posts": 200
}

Batch Scraping Multiple Users

Scrape posts from multiple users in one run (up to 20 usernames):

{
  "mode": "user",
  "usernames": ["zuck", "instagram", "nike"],
  "max_posts": 200
}

This returns:

• Each user's bio and follower count
• Contact information extracted from bio (emails, phones, links)
• All recent posts with engagement metrics (likes, replies, reposts, shares, views)
• Profile verification status
• Media attachments
• Mentions and hashtags

Mode 2: Search Posts by Hashtag/Tag

Discover posts under popular Threads hashtags. Results are sorted by relevance.

Best for: Popular hashtags with active communities. Works great with tags like AI, tech, fashion, etc.

Tip: You can include or omit the # symbol - both AI and #AI will work the same way.

{
  "mode": "keyword",
  "keywords": ["AI", "tech", "#startup"],
  "max_posts": 200
}

Mode 3: Search by Keyword (with Filters)

Full-text search with sort options. Result volume is best-effort and depends on Threads' current public search availability.

Understanding Search Filters

Filter	Best For	What You Get
Top (top)	Discovering viral content	Popular posts with high engagement
Recent (recent)	Broader topic discovery	A mix of recent and older posts matching the keyword

Top/Popular Posts

{
  "mode": "search",
  "keywords": ["artificial intelligence"],
  "search_filter": "top",
  "max_posts": 50
}

Recent Posts

{
  "mode": "search",
  "keywords": ["AI"],
  "search_filter": "recent",
  "max_posts": 50
}

Date Filtering (Search Mode Only)

Filter search results by date range. Supports absolute dates and relative dates. The actor first narrows results by your date range, then checks dates again before saving. If start_date or end_date is used outside Search by Keyword, the run stops immediately with a clear reminder.

{
  "mode": "search",
  "keywords": ["AI"],
  "search_filter": "top",
  "start_date": "2026-01-01",
  "end_date": "2026-02-28",
  "max_posts": 100
}

{
  "mode": "search",
  "keywords": ["AI"],
  "start_date": "7 days",
  "max_posts": 50
}

Output Format

Viewing Your Data

1. Dataset View: Click "Preview" to see scraped posts
2. All Fields: Switch to "All fields" view to see complete data including:
   • Full user profile information
   • Complete mentions array
   • Media metadata
   • Additional extracted fields

Sample Dataset Output

Each post is saved as a separate record. Below is an example from user mode:

{
  "post_url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp",
  "post_code": "DTa3-B1EbTp",
  "text_content": "we're establishing a new top-level initiative called Meta Compute...",
  "created_at": "2026-01-12T18:00:30+00:00",
  "created_at_display": "2026-01-12 18:00 UTC",
  "created_at_timestamp": 1768240830,
  "like_count": 2684,
  "reply_count": 810,
  "repost_count": 129,
  "quote_count": 42,
  "share_count": 221,
  "view_count": 416512,
  "has_media": false,
  "media_type": "text",
  "media_url": "",
  "media_urls": [],
  "media_width": null,
  "media_height": null,
  "hashtags": [],
  "mentions": [],
  "urls": [],
  "is_pinned": false,
  "is_edited": false,
  "is_paid_partnership": false,
  "accessibility_caption": "",
  "is_reply": false,
  "reply_to_username": "",
  "reply_control": "everyone",
  "is_quote_post": false,
  "quoted_post_url": "",
  "is_repost": false,
  "reposted_post_url": "",
  "scraped_at": "2026-04-25T10:00:00+00:00",
  "username": "zuck",
  "display_name": "Mark Zuckerberg",
  "profile_url": "https://www.threads.com/@zuck",
  "is_verified": true,
  "followers_count": 5450146,
  "bio": "Mostly superintelligence and MMA takes",
  "profile_pic_url": "https://...",
  "profile_pic_hd_url": "https://...",
  "fediverse_enabled": true,
  "external_links": ["https://zuck.com"],
  "emails": [],
  "phones": [],
  "bio_links": [],
  "profile_tags": ["AI", "Tech"],
  "podcast_name": "",
  "podcast_url": "",
  "podcast_platform": ""
}

Sample 2: A reply post that quotes a sponsored brand collaboration

Showcasing the conversation-context and partnership fields populated together:

{
  "post_url": "https://www.threads.com/@nike/post/EXMPL_REPLY01",
  "post_code": "EXMPL_REPLY01",
  "text_content": "Loved the new collab piece — wearing it tomorrow!",
  "created_at": "2026-04-22T14:30:00+00:00",
  "like_count": 412,
  "reply_count": 23,
  "repost_count": 9,
  "view_count": 18750,
  "is_paid_partnership": true,
  "accessibility_caption": "Athletic shoe in red colorway on a wooden surface",
  "media_width": 1200,
  "media_height": 1600,
  "is_reply": true,
  "reply_to_username": "athleteX",
  "reply_control": "followers_only",
  "is_quote_post": true,
  "quoted_post_url": "https://www.threads.com/@brandY/post/QUOTED_ORIG",
  "is_repost": false,
  "reposted_post_url": "",
  "username": "nike",
  "display_name": "Nike",
  "is_verified": true,
  "followers_count": 1250000,
  "fediverse_enabled": true
}

Search mode results include author profile data inline plus three additional fields:

• search_keyword: the searched keyword
• search_filter: the filter used
• keyword_match: whether the post text directly matches the searched keyword

Hashtag mode results include author profile data inline plus a search_keyword field (the searched hashtag). For hashtag/search modes, author profile fields are best-effort and are backfilled when public profile data is available.

Example Use Cases

1. Competitor Analysis with Engagement Metrics

{
  "mode": "user",
  "usernames": ["competitor_brand_a", "competitor_brand_b"],
  "max_posts": 300
}

Pull a deep post history with engagement metrics (likes, replies, reposts, quotes, shares, views) for side-by-side competitor analysis. Each post also carries sponsored-content, quote/repost, and reply-context flags so you can slice organic vs paid content quickly.

2. Influencer Discovery

{
  "mode": "user",
  "usernames": ["creator_a", "creator_b", "creator_c"],
  "max_posts": 200
}

Pull long-form profile data (bio, followers, tags, podcast link, contact info from bio) plus recent posts to build an influencer shortlist in one run. The Fediverse flag and verified status help qualify authenticity.

3. Brand Mention Monitoring (Hashtag)

{
  "mode": "keyword",
  "keywords": ["#YourBrand", "#CompetitorBrand"],
  "max_posts": 200
}

Follow brand and competitor conversations via hashtag feeds. Combine with the keyword_match flag in search mode (below) to separate direct matches from broader context.

4. Trend & Content Research (Search, Top)

{
  "mode": "search",
  "keywords": ["AI tools", "machine learning"],
  "search_filter": "top",
  "max_posts": 200
}

Discover high-engagement posts on topic keywords. The paid-partnership flag lets you isolate sponsored content; quote/repost URLs let you map conversation graphs.

5. Date-bounded Research (Search with Date Filter)

{
  "mode": "search",
  "keywords": ["climate policy"],
  "search_filter": "top",
  "start_date": "30 days",
  "max_posts": 200
}

Narrow a topic to the last 30 days for time-sensitive research. Date filtering is available only in Search mode.

Limitations

Batch Limits:

• Up to 20 usernames or 20 keywords per run
• Maximum 500 posts per user or per keyword

Actual Results:

• User posts: quantity varies by account activity
• Hashtag results: typically up to ~20 results per tag
• Search (Top): typically up to ~25–30 results per keyword
• Search (Recent): typically up to ~20 results per keyword

Search Relevance:

• Threads search ranking does not guarantee exact keyword-only matching
• "Top" mode may include broadly related content and can sometimes include unrelated content
• "Recent" mode returns a mix of recent and older posts for the keyword
• In search mode, all currently available results are returned
• Use keyword_match to quickly separate direct matches from broader context results
• For a tighter date window, combine search with start_date / end_date; only posts inside your range will be kept

FAQ

Q: What engagement metrics can I get? A: The scraper extracts likes, replies, reposts, quotes, shares, and views when publicly available. On some posts, share_count and view_count can be null.

Q: How does contact information extraction work? A: Contact extraction is best effort. The scraper parses public bio text and profile links to find emails, phone numbers, and websites. Phone parsing covers international formats (with leading +), US formats, and common Taiwan formats (09xx mobile and 02–08 area-code landlines). Availability depends on what the account chose to publish in the bio.

Q: How do I see all available data fields? A: In the Apify console, switch from "Preview" to "All fields" view. You will see the full schema, including fields that may be null for some records.

Q: Does it support batch scraping of multiple users or keywords? A: Yes. You can enter up to 20 usernames or 20 keywords in one run. Items are processed in sequence and combined into the same dataset.

Q: Can I tell which posts are sponsored / paid partnerships? A: Yes. Every post carries is_paid_partnership which Threads sets on posts marked as paid partnerships or branded content. Useful for filtering organic vs paid content.

Q: Can I see quote posts and reposts, and the original they reference? A: Yes. is_quote_post + quoted_post_url mark quotes; is_repost + reposted_post_url mark reposts. You can follow the reference URL to pull the referenced post in a second run.

Q: Can I distinguish top-level posts from replies? A: Yes. is_reply is true when the post is a reply; reply_to_username tells you who is being replied to; reply_control indicates who is allowed to reply ("everyone" / "followers_only" / "mentioned_only").

Q: What about image alt text and media size? A: When available, accessibility_caption returns the image description and media_width / media_height return the original pixel dimensions.

Q: Is there a Fediverse / ActivityPub signal? A: Yes. fediverse_enabled is true when the user has activated Threads' Fediverse sharing.

Q: What is the difference between Hashtag mode and Search mode? A: Hashtag mode scrapes the /tag/ page (limited results, no filter options). Search mode uses full-text search with top or recent filters, then returns currently available results for your query.

Q: Are usernames with dots supported? A: Yes. Usernames with dots are supported by validation (for example, swtt.hawk.art). Any specific username still needs to exist on Threads.

Q: Why do search results seem unrelated to the keyword? A: Threads search ranking is not strict keyword-only matching. Results can include broadly related content and sometimes unrelated content. Use keyword_match to separate direct matches in downstream filtering.

Q: Why do I get fewer results than my max_posts limit? A: Threads limits the amount of content accessible through its interface. The actual number of available posts varies based on several factors including account activity and content type.

Q: Why are bio or follower_count sometimes empty in hashtag/search mode? A: These modes first use post-level public data, then try to backfill author profile details. Some profiles can still return limited public fields, so availability may vary by account and time.

Alternative: Threads API

Important: This scraper operates without login, meaning the accessible data is limited by Threads' public interface.

If you need to work with your own account data, review the official Threads API:

• Uses an authenticated developer API model
• Follows the official documentation and platform policies
• Better suited for authorized, long-term application integrations

Disclaimer

This Actor is provided for educational and research purposes only. Users must use it ethically, responsibly, and in compliance with applicable laws and platform terms. Data availability and accuracy may vary based on platform behavior. The developers are not responsible for misuse of this tool or the collected data.

---

Keywords: Threads scraper, Threads API, Meta Threads, social media scraper, Instagram Threads, Threads posts, Threads hashtag search, Threads keyword search, Threads data extraction, social media monitoring, Threads automation, influencer discovery, follower count scraper, Threads engagement metrics, Threads search, OpenClaw, Claude Code, Gemini CLI, Antigravity, Codex, ChatGPT, Apify Skills