Threads Search Scraper

Threads Search Scraper

Threads Search Scraper extracts public Threads search post data by keyword or hashtag, including post text, author details, available engagement metrics, media URLs, hashtags, mentions, and search metadata.

Search Threads by keyword or hashtag, choose top or recent public posts, apply optional date windows, and export structured social listening data for analysis or integrations.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

Use Apify Actor parsebird/threads-search-scraper to scrape public Threads search posts. Example with ApifyClient: client.actor("parsebird/threads-search-scraper").call(run_input={"keywords":["AI","#startup","stock market"],"search_filter":"recent","max_posts":50}). Inputs: keywords string[] required default ["AI"]; search_filter string enum "top" or "recent" default "recent"; max_posts integer default 50; start_date optional string YYYY-MM-DD or relative like "7 days"; end_date optional string YYYY-MM-DD. Output fields: post_url, post_code, text_content, created_at, username, display_name, profile_url, followers_count, bio, like_count, reply_count, repost_count, quote_count, share_count, view_count, has_media, media_type, media_urls, hashtags, mentions, search_keyword, search_filter, keyword_match, scraped_at. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations.

What is Threads Search Scraper?

Threads Search Scraper is a Threads scraper and Threads API alternative for collecting public search posts without manually copying results from the website. Enter one or more keywords, hashtags, or phrases, choose top or recent, and the actor returns structured rows ready for analysis.

Use it for Threads data extraction workflows where you need repeatable exports, scheduled monitoring, API access, or integrations through Apify. The actor works with public data availability at run time, so some fields may be empty when Threads does not expose them publicly.

What can Threads Search Scraper do?

• Search public Threads posts by keyword, hashtag, or phrase.
• Choose top for popular matching posts or recent for newer matching public posts first.
• Extract post text, post URLs, author usernames, display names, profile URLs, media links, hashtags, mentions, and available engagement metrics.
• Add optional start_date and end_date filters for repeatable research windows.
• Run searches on demand or with Apify schedules.
• Access results through the Apify API, webhooks, and integrations.
• Download datasets as JSON, CSV, Excel, XML, RSS, or HTML from Apify storage.

What Threads data can you extract?

Field	Description
post_url	Direct URL of the Threads post when available or reconstructable
post_code	Threads post identifier returned in public page data
text_content	Public post text
created_at	Post timestamp when available
username	Author username
display_name	Author display name
profile_url	Public Threads profile URL
followers_count	Public follower count when available
bio	Public author bio when available
like_count	Likes when available
reply_count	Replies when available
repost_count	Reposts when available
quote_count	Quotes when available
share_count	Shares when available
view_count	Public views when available
media_urls	Public media URLs returned in page data
hashtags	Hashtags found in the post text
mentions	Mentions found in the post text
search_keyword	Keyword or hashtag associated with the row
keyword_match	Whether the text directly includes the searched keyword

How to scrape Threads search posts

1. Open Threads Search Scraper on Apify.
2. Add one or more keywords, for example AI, #startup, or stock market.
3. Choose search_filter: top for popular posts or recent for newer matching public posts.
4. Set max_posts for the maximum public posts to collect per keyword.
5. Optionally add start_date and end_date in YYYY-MM-DD format, or use a relative start such as 7 days.
6. Run the actor, open the dataset, and export results as JSON, CSV, Excel, or through the Apify API.

Input parameters

Parameter	Type	Required	Default	Description
keywords	array of strings	Yes	["AI"]	Keywords or hashtags to search. The # is optional.
max_posts	integer	No	50	Maximum posts per keyword. Actual results depend on public availability at run time.
search_filter	string	No	recent	top for popular posts or recent for newer matching public posts first.
start_date	string	No	-	Optional start date. Supports YYYY-MM-DD or relative values such as 7 days.
end_date	string	No	-	Optional end date. YYYY-MM-DD is recommended for clarity.

Example input:

{
  "keywords": ["AI", "#startup", "stock market"],
  "search_filter": "recent",
  "max_posts": 50
}

Date-bounded input:

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

Input / Output

Example output:

{
  "record_type": "post",
  "post_url": "https://www.threads.com/@example/post/ABC123",
  "post_code": "ABC123",
  "text_content": "Example public Threads post about AI research.",
  "created_at": "2026-02-15T08:30:00+00:00",
  "username": "example",
  "display_name": "Example Account",
  "profile_url": "https://www.threads.com/@example",
  "followers_count": 12500,
  "bio": "Public profile bio",
  "like_count": 152,
  "reply_count": 18,
  "repost_count": 7,
  "quote_count": 2,
  "share_count": 4,
  "view_count": 4200,
  "has_media": true,
  "media_type": "photo",
  "media_urls": ["https://scontent.cdninstagram.com/..."],
  "hashtags": ["AI"],
  "mentions": ["openai"],
  "search_keyword": "AI",
  "search_filter": "top",
  "keyword_match": true,
  "scraped_at": "2026-02-18T12:00:00+00:00"
}

The example is illustrative and shows the dataset shape. Download results in JSON, CSV, Excel, HTML, XML, or RSS from the Apify dataset.

Python API example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("parsebird/threads-search-scraper").call(run_input={
    "keywords": ["AI", "#startup", "stock market"],
    "search_filter": "recent",
    "max_posts": 50,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('parsebird/threads-search-scraper').call({
  keywords: ['AI', '#startup', 'stock market'],
  search_filter: 'recent',
  max_posts: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

See Apify's official Python client and JavaScript client documentation for more options.

How much does it cost to scrape Threads?

What is the price per Threads search post?

Event	Free, Bronze, Silver	Gold
post-scraped	$0.00399 per post ($3.99 / 1,000)	$0.00359 per post ($3.59 / 1,000)

Each post-scraped event means one public Threads post was extracted and pushed to the dataset. A run with 1,000 posts costs $3.99 on Free, Bronze, and Silver plans, or $3.59 on Gold. Apify free trial credits may cover test runs where applicable.

Use cases

• Monitor public Threads conversations around brands, products, competitors, campaigns, or topics.
• Track newer or popular posts for social listening and market research.
• Collect public engagement fields for trend analysis when Threads exposes those fields.
• Build keyword datasets for content research, audience research, or reporting.
• Feed Threads search data into spreadsheets, BI tools, databases, or automation workflows.

How it works

1. The actor validates keywords, search_filter, max_posts, and optional date filters.
2. It requests public Threads search pages with browser-like headers.
3. It extracts public Threads post objects from embedded page data when Threads exposes them.
4. It normalizes author, engagement, media, hashtag, mention, search, and scrape-time fields.
5. It pushes one row per post to the default Apify dataset and charges one PPE event per saved post on the Apify platform.

What are the limitations of Threads search scraping?

• Threads may change which public data appears in its web pages over time.
• Some public posts do not expose every engagement or author field.
• New, deleted, private, restricted, or partially available posts may produce incomplete rows.
• Threads search can return broadly related posts, not only exact keyword matches.
• A keyword may return fewer rows than requested when fewer matching public posts are available.

Is it legal to scrape Threads?

Is scraping Threads legal?

Scraping publicly available web data is generally allowed in many jurisdictions, but you should review Threads' terms, avoid collecting private or sensitive information, and make sure your use case complies with applicable laws. For background, read Apify's guide: Is web scraping legal?.

Other Threads scrapers / Related Actors

Actor	Best for
Threads Search Scraper	Public keyword and hashtag search posts
YouTube Search Scraper	Structured YouTube search results
Pinterest Search Scraper	Pinterest keyword search results
Truth Social Scraper	Public Truth Social profile posts
Product Hunt Scraper	Product launches and maker data

FAQ

Does Threads Search Scraper require a Threads login?

No login input is required. The actor is designed for public Threads web data that is available without a user account.

Can I schedule recurring Threads searches?

Yes. Use Apify schedules to run the actor hourly, daily, weekly, or at another interval.

Can I use it as a Threads scraper API?

Yes. Start runs and fetch datasets through the Apify API, Python client, JavaScript client, webhooks, or integrations.

Why did I get fewer results than requested?

Result counts depend on what Threads shows publicly for the keyword at run time. Try a broader keyword, a different sort order, or a wider date range.

Why are some fields empty?

Some posts and profiles expose only partial public data. Empty fields usually mean the information was not public or not available in the page data when the actor ran.

Are top and recent exact filters?

They follow the public Threads search ordering available at run time. Search ranking can still include related posts rather than only exact keyword matches.

Where can I report issues or request fields?

Open the Issues tab on the actor page and include your input example, run ID, and the fields you expected.