Threads Keyword Search

Search public Threads posts by keyword and return structured results with author, content, engagement, and media fields.

What does Threads Keyword Search do?

This actor helps you discover Threads posts for a single keyword and export a clean dataset for analysis, monitoring, and reporting workflows.

Key features

• Single-keyword focus — One keyword per run for cleaner intent and more predictable output
• Exclude keywords — Filter out posts containing unwanted terms
• Time filtering — Best-effort filtering for day/week/month/year windows
• Engagement fields — Likes, comments, reposts, and view counts when available
• Author profiles — Username, display name, and verification status
• Media detection — Identifies images and videos with direct URLs
• Text analysis — Automatic hashtag and mention extraction

How to use

1. Enter one search keyword (any language)
2. Optionally add exclude keywords to filter out unwanted results
3. Choose how many results (10, 20, or 30)
4. Optionally set a time range
5. Click Start and wait for results

Input example

Array format:

{
  "keywords": ["AI automation"],
  "maxResults": "10",
  "timeFilter": "any"
}

String format (backward compatible):

{
  "keywords": "AI automation",
  "maxResults": "10",
  "timeFilter": "any"
}

Output

Each result includes:

Field	Description
keyword	The search keyword used
rank	Position in search results
postUrl	Direct link to the Threads post
postCode	Threads post identifier
username	Author's Threads username
displayName	Author's display name
isVerified	Whether the author has a verified badge
text	Full post text content
createdAt	When the post was published
likeCount	Number of likes
commentCount	Number of comments
repostCount	Number of reposts
viewCount	Number of views
hasMedia	Whether the post contains images or videos
mediaType	Type of media (image or video)
mediaUrls	Direct URLs to media content
hashtags	Hashtags found in the post
mentions	@mentions found in the post
searchParameters	Search settings used (timeFilter, maxResults)
collectedAt	When the data was collected

Output example

{
  "keyword": "AI automation",
  "rank": 1,
  "postUrl": "https://www.threads.com/@techguru/post/ABC123",
  "postCode": "ABC123",
  "username": "techguru",
  "displayName": "Tech Guru",
  "isVerified": true,
  "text": "Just tested the latest AI automation tools and the results are incredible. The workflow took 3 hours manually, now it's done in 10 minutes.",
  "createdAt": "2026-02-15T08:30:00.000Z",
  "likeCount": 1523,
  "commentCount": 89,
  "repostCount": 234,
  "viewCount": 45000,
  "hasMedia": true,
  "mediaType": "image",
  "mediaUrls": ["https://scontent.cdninstagram.com/..."],
  "hashtags": ["AI", "automation"],
  "mentions": ["openai"],
  "searchParameters": {
    "timeFilter": "w",
    "maxResults": 10
  },
  "collectedAt": "2026-02-18T12:00:00.000Z"
}

Dataset views

Results are organized into three views:

• Search Results — Overview with rank, author, text, and URL
• Engagement Metrics — Likes, comments, reposts, and view counts
• Post Content — Full text with hashtags, mentions, media, and timestamps

Tips for best results

• Use specific keywords — "AI automation tools" works better than just "AI"
• Exclude noise — Add terms like "ads", "spam", or "giveaway" to exclude keywords
• Search any language — Keywords in any language are supported (English, Chinese, Japanese, etc.)
• Use time filters — "Past week" is great for trending topics

Limitations

• Very recent posts (under ~1 hour) may not appear in search results yet
• Fewer results may be returned for niche or uncommon keywords
• Post engagement fields depend on public post visibility and page availability
• Some records may have partial fields (for example, missing view count or timestamp)
• Private accounts and deleted posts can return limited or empty details

FAQ

Why are there fewer results than requested?

Result count depends on public availability and keyword coverage at run time. If fewer matching public posts exist, fewer items are returned.

Why are some fields null?

Some post pages expose partial data only. This is expected for restricted, removed, or partially rendered content.

Does this actor require account login?

The actor is designed for publicly accessible content and does not require end-user login input.

Is time filtering exact to the second?

No. Time filtering is best-effort and based on available post timestamps.

Disclaimer

Use this actor responsibly and ensure your usage complies with Threads terms, local laws, and your organization's policies. Data availability may change as the platform evolves.

Keywords: Threads keyword search, Threads data extraction, Threads analytics, social listening, social media monitoring, Threads engagement metrics, Threads hashtag search, OpenClaw, Claude Code, Gemini, Antigravity, Codex, ChatGPT