Threads Search API
Search Threads programmatically and get structured, ranked results.
GET request to /v1/threads/search that responds with clean JSON, costs 18 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.What is the Threads Search API?
The Threads Search API lets you search and return matching results from Threads with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.
What you get
- Ranked, structured result list
- Title, URL, author, and thumbnail per result
- Engagement metrics where available
- Configurable result limit
Try it
Fill in the parameters below and copy a ready-to-run request in your language of choice.
Parameters
curl "https://api.captapi.com/v1/threads/search?q=skincare" \
-H "Authorization: Bearer capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"data": {
"query": "artificial intelligence",
"totalReturned": 5,
"results": [
{
"platform": "threads",
"id": "3928882651670873164",
"code": "DaGMfShCYRM",
"url": "https://www.threads.net/@aiwithanju/post/DaGMfShCYRM",
"text": "All Paid Courses (Free for First 4500 People)\n\n𝗣𝗮𝗶𝗱 𝗖𝗼𝘂𝗿𝘀𝗲 𝗙𝗥𝗘𝗘 (PART - 1)\n1. Artificial Intelligence\n2. Machine Learning\n3. Prompt Engineering\n4. Claude,Chatgpt,Grok\n5. Data Analytics\n6. AWS Certified\n7. Data Science\n8. BIG DATA\n9. Python\n10. Ethical Hacking\n\n(72 Hours only )\n\nLike + RT + comment 'Drive'\n\nMust Follow me so I can DM you.",
"publishedAt": "2026-06-27T16:55:31.000Z",
"author": {
"username": "aiwithanju",
"displayName": "Anjana | AI Strategist & Coach",
"verified": true,
"followers": null,
"profileImage": null
},
"engagement": {
"likes": 431,
"replies": 481,
"reposts": 139,
"quotes": 2
},
"media": [
"https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/728627202_17977076481105005_209164695399005645_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&ig_cache_key=MzkyODg4MjY1MTY3MDg3MzE2NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNzk5LnNkci5yZWd1bGFyX3Bob3RvLkMzIn0%3D&_nc_ohc=W1sXBSn11tQQ7kNvwFqNL9l&_nc_oc=Adrk5GzsVTO1vUYoIED8QGuB5jonqlYN-J17bKSMcIIelh8okUySU82v8dOtNZ8zhZc&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_gid=LvyGXtI_yQ4Ud9tWRKe0yw&_nc_ss=7a22e&oh=00_AQChLgS32zB6GM3x9UfQgDpFGCtVGDCdgVtXAfjhj34shw&oe=6A4DCC0F"
]
},
{
"platform": "threads",
"id": "3748832590774943568",
"code": "DQGh2EPjD9Q",
"url": "https://www.threads.net/@leon_paul_h/post/DQGh2EPjD9Q",
"text": "I hear a lot of people saying AI is good for nothing and shouldn’t exist. You’re probably thinking of Gen-AI. \nHere is the system I built with the same AI detecting lethal landmines, designed to look like leaves, amongst thousands of leaves. \nHumans cannot do this. This saves lives. This replaces a job no one wants to do. \nThis is AI.",
"publishedAt": "2025-10-22T06:51:14.000Z",
"author": {
"username": "leon_paul_h",
"displayName": "Leon",
"verified": false,
"followers": null,
"profileImage": null
},
"engagement": {
"likes": 12505,
"replies": 509,
"reposts": 518,
"quotes": 44
},
"media": [
"https://scontent-lax3-1.cdninstagram.com/v/t51.71878-15/570177049_4178982172340663_131830339174579264_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&ig_cache_key=Mzc0ODgzMjU5MDc3NDk0MzU2OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=fXdLXhdv-VkQ7kNvwG_Or4F&_nc_oc=AdrK_4oq9gsxQRORQkSc_UWpTgspPdcBct4abCJfEX9nUoIcNgPWmv3qjp7yn_sKMMA&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_gid=LvyGXtI_yQ4Ud9tWRKe0yw&_nc_ss=7a22e&oh=00_AQBPhSLCRwlnaKdD67Tqjfyv7Ehl3Y-8x_2abWjJ2xAnCA&oe=6A4DD6A3"
]
},
{
"platform": "threads",
"id": "3911701753045711256",
"code": "DZJKATxj_mY",
"url": "https://www.threads.net/@quanthustle/post/DZJKATxj_mY",
"text": "FREE Artificial Intelligence with Python Course from Harvard University\n\n$0 to learn:\n• Reinforcement learning\n• Machine learning\n• Artificial intelligence principles\n• How to design intelligent systems\n• How to use AI in Python programs",
"publishedAt": "2026-06-04T00:00:14.000Z",
"author": {
"username": "quanthustle",
"displayName": "QuantHustle | Algo Trading Blog",
"verified": false,
"followers": null,
"profileImage": null
},
"engagement": {
"likes": 21,
"replies": 2,
"reposts": 2,
"quotes": 0
},
"media": [
"https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/714823247_17890449732513878_4716534577049443792_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=MzkxMTcwMTc1MzA0NTcxMTI1Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=XV1J2SK5UXsQ7kNvwGDz9g_&_nc_oc=AdqmTn6qcbidruNxR6m7pz300hV2R9iv5v4XKblOCKTyPUeba1nM_qMFQ_pDq58TFag&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_gid=LvyGXtI_yQ4Ud9tWRKe0yw&_nc_ss=7a22e&oh=00_AQC4BcKT0BrCbUa3NaZYH2odFARFHMIWfva5Q-eF_iPI7g&oe=6A4DD29E"
]
},
{
"platform": "threads",
"id": "3612852547526776951",
"code": "DIjbkARMth3",
"url": "https://www.threads.net/@kelynglinsky/post/DIjbkARMth3",
"text": "I see people treating AI as a divine force.\n\nThey say it’s an \"entity with consciousness”.\n\nAnd an extension of our highest self.\n\nBut this is a deeply concerning development.\n\nHere’s the truth about AI most aren’t ready to hear:",
"publishedAt": "2025-04-17T16:00:07.000Z",
"author": {
"username": "kelynglinsky",
"displayName": "Kelyn Glinsky",
"verified": true,
"followers": null,
"profileImage": null
},
"engagement": {
"likes": 55,
"replies": 113,
"reposts": 3,
"quotes": 1
},
"media": []
},
{
"platform": "threads",
"id": "3911074115188480204",
"code": "DZG7S-eCNjM",
"url": "https://www.threads.net/@nazakat_ali_khowaja/post/DZG7S-eCNjM",
"text": "As the global race for artificial intelligence accelerates, China is exploring a novel way to reduce one of AI’s biggest infrastructure challenges: cooling.\n\nUnderwater data centers are already operating off the coasts of Shanghai and Hainan, where submerged server modules use the surrounding ocean as a natural cooling system for high-performance computing workloads.\n\nThe concept offers significant efficiency advantages.",
"publishedAt": "2026-06-03T03:13:08.000Z",
"author": {
"username": "nazakat_ali_khowaja",
"displayName": "Nazakat Ali Khowaja",
"verified": false,
"followers": null,
"profileImage": null
},
"engagement": {
"likes": 4044,
"replies": 149,
"reposts": 73,
"quotes": 9
},
"media": [
"https://scontent-lax3-2.cdninstagram.com/v/t51.82787-15/710058396_17969743665113579_6096653293534949211_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&ig_cache_key=MzkxMTA3NDExNTE4ODQ4MDIwNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=RTPcRoAFPHYQ7kNvwGYbR7y&_nc_oc=AdqyE_b28fPUkop5euyZNNU855F464disr2IHw6tmDWl1kX9Q3WZdCLF-dgbD3l81ZY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_gid=LvyGXtI_yQ4Ud9tWRKe0yw&_nc_ss=7a22e&oh=00_AQALaX8bSITupI567y3bAhH4PD-Tuqy5WrygoBj4blwp9w&oe=6A4DF136"
]
}
]
}
}Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Result
totalNumber of results returned.
Each result
Each item in results contains:
titleResult title.urlDirect URL to the content.authorCreator handle.viewsView count where available.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Keyword or phrase to search Threads (min 2 characters). |
| limit | integer | No | Max items to return (default 25, max 200). Billed per result. |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 18 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).
How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/threads/searchand parse the JSON response.
Use cases
Trend Discovery
Find trending content by keyword or hashtag.
Content Sourcing
Build feeds and playlists programmatically.
Monitoring
Track topics, brands, and competitors.
Research
Sample large sets of content for analysis.
Frequently asked questions
What does the Threads Search API do?+
The Threads Search API lets you search and return matching results from a public Threads query using one GET request to /v1/threads/search. It returns clean JSON — no OAuth or scraping setup required.
How many credits does the Threads Search API cost?+
Each successful call costs 18 credits. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.
Do I need a Threads API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, and Rumble. We handle proxies, rate limits, retries, and authentication for you.
Is the Threads Search API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.
More Threads APIs
Ready to use the Threads Search API?
Sign up, grab your key, and make your first call in 60 seconds.