Threads Post Search (by Keyword, First Page)
omnial/threads-web-search-posts
Given a search keyword, returns the first page of matching Threads posts. Each post comes with its ID and short code, its text, its publish time, a media type code, its like, reply, repost, quote and reshare counts, whether it is a reply (and to which handle), its topic tag when it has one, and the author's user ID, handle, display name and verified flag.
activeper callv1
Price
Up to $0.0041 per call; you pay what the call used
The price shown is the price you pay. No monthly minimum. Top-ups start at $5.
Data source
Threads
Data from Threads.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/threads-web-search-posts" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/threads-web-search-posts" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/threads-web-search-posts", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/threads-web-search-posts", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0041 |
- Updated
- Oct 14, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "The word or phrase to search Threads posts for, in plain text."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"node": {
"type": "object",
"properties": {
"thread": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The thread's ID."
},
"thread_items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"post": {
"type": "object",
"properties": {
"pk": {
"type": "string",
"description": "The post's numeric ID."
},
"code": {
"type": "string",
"description": "The post's short code, as used in its link."
},
"user": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The author's user ID."
},
"username": {
"type": "string",
"description": "The author's handle."
},
"full_name": {
"type": "string",
"description": "The author's display name."
},
"is_verified": {
"type": "boolean",
"description": "Whether the author carries the verified badge."
}
},
"description": "The post's author."
},
"caption": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The post's text."
}
}
},
"taken_at": {
"type": "number",
"description": "Publish time, Unix seconds."
},
"like_count": {
"type": "number",
"description": "Number of likes."
},
"media_type": {
"type": "number",
"description": "Threads' numeric code for the kind of media attached."
},
"text_post_app_info": {
"type": "object",
"properties": {
"is_reply": {
"type": "boolean",
"description": "Whether the post is a reply to another post."
},
"tag_header": {
"type": "object",
"properties": {
"display_name": {
"type": "string",
"description": "The topic tag's name."
}
},
"description": "The post's topic tag; absent when it has none."
},
"quote_count": {
"type": "number",
"description": "Number of quotes."
},
"repost_count": {
"type": "number",
"description": "Number of reposts."
},
"reshare_count": {
"type": [
"number",
"null"
],
"description": "Number of reshares; can be null."
},
"reply_to_author": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "That account's user ID."
},
"username": {
"type": "string",
"description": "That account's handle."
}
},
"description": "The account the post replies to; absent when it is not a reply."
},
"direct_reply_count": {
"type": "number",
"description": "Number of replies."
}
}
}
}
}
}
},
"description": "The thread's posts: usually one, or a reply preceded by the post it answers."
}
}
}
}
}
}
},
"description": "One entry per matching thread, in the order Threads ranks them."
}
},
"description": "The first page of matching posts."
}