Threads post search API
Posts matching a keyword: one page of about 15 to 20 results, no paging.
GET /v1/threads/search
GET /v1/threads/search
Posts matching a keyword: one page of about 15 to 20 results, no paging. start_date and end_date filter the page by post date (Threads does not apply them itself).
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Search terms. Also accepted as keyword, q. |
start_date | string | no | Only posts from this date (YYYY-MM-DD). Also accepted as startDate. |
end_date | string | no | Only posts up to this date (YYYY-MM-DD). Also accepted as endDate. |
Every request also accepts:
cursor: the cursor from the previous page (Pagination).trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/threads/search" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "query=basketball"1import os2import requests34params = {5 "query": "basketball",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/threads/search",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/threads/search");2url.search = new URLSearchParams({3 "query": "basketball"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Threads post search",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/threads/search",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "query",19 "value": "basketball"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, lists and long text are shortened. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_1606b873a2f08bbcddca5a85",8 "data": {9 "object": "list",10 "items": [11 {12 "object": "post",13 "platform": "threads",14 "id": "4018945814638194513",15 "url": "https://www.threads.com/@bookmakerstips/post/DfGKezVDW9R",16 "type": "image",17 "author": {18 "id": "77238389559",19 "handle": "bookmakerstips",20 "name": "Book Makers",21 "url": "https://www.threads.com/@bookmakerstips",22 "avatar_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-19/752994703_17893726308573560_3020655541855839830_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-1.cdninstagram.com&_...",23 "verified": false24 },25 "title": null,26 "text": "BOOOOOOM 💥 💥 \nBasketball done and dusted ✅️\nCongratulations ❤️ 🎉",27 "published_at": "2026-10-29T23:14:57Z",28 "duration_seconds": null,29 "language": "en",30 "hashtags": null,31 "mentions": null,32 "stats": {33 "views": null,34 "likes": 2,35 "comments": 0,36 "shares": 0,37 "saves": null,38 "dislikes": null39 },40 "media": {41 "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/879745885_17911689090573560_4594557330892881901_n.webp?_nc_cat=100&ig_cache_key=NDAxODk0NTgxNDYzODE5NDUxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHM...",42 "video_url": null,43 "audio_url": null,44 "image_urls": [45 "https://scontent-ord5-2.cdninstagram.com/v/t51.82787-15/879745885_17911689090573560_4594557330892881901_n.webp?_nc_cat=100&ig_cache_key=NDAxODk0NTgxNDYzODE5NDUxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHM..."46 ],47 "width": 1125,48 "height": 49149 },50 "song": null,51 "location": null,52 "is_pinned": false,53 "is_sponsored": false,54 "extra": {55 "code": "DfGKezVDW9R",56 "full_id": "4018945814638194513_77238389559",57 "quotes": 0,58 "reply_control": "everyone",59 "reposts": 060 }61 },62 {63 "object": "post",64 "platform": "threads",65 "id": "4018825113767779372",66 "url": "https://www.threads.com/@atlantadream/post/DfFvCX4jBws",67 "type": "video",68 "author": {69 "id": "63232452248",70 "handle": "atlantadream",71 "name": "Atlanta Dream",72 "url": "https://www.threads.com/@atlantadream",73 "avatar_url": "https://scontent-ord5-1.cdninstagram.com/v/t51.82787-19/842005499_17989100859108249_9049345542735375395_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDAwLmMyIn0&_nc_ht=scontent-ord5-1.cdninstagram.com&_...",74 "verified": true75 },76 "title": null,77 "text": "A SCRIBBLE, G SCRIBBLE ✍️. THE BIG AG! ALLISHA GR🅰️Y \n\nFrom timely buckets to a stellar defensive effort, Lish came in like the beat on 24s! She is YOUR @albertapp Player of the Game ✅",78 "published_at": "2026-10-29T19:15:38Z",79 "duration_seconds": null,80 "language": "en",81 "hashtags": null,82 "mentions": [83 "albertapp"84 ],85 "stats": {86 "views": null,87 "likes": 1531,88 "comments": 30,89 "shares": 176,90 "saves": null,91 "dislikes": null92 },93 "media": {94 "thumbnail_url": "https://scontent-ord5-2.cdninstagram.com/v/t51.71878-15/879376656_984030317470177_849654799963576848_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=110&ig_cache_key=NDAxODgyNTExMzc2Nzc3OTM3Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI...",95 "video_url": "https://scontent-ord5-2.cdninstagram.com/o1/v/t16/f2/m84/AQOmaKESeWr8pOkJ3c0O-kE__uVf5E8p_LHJKVMYjtYHBejzxWKEh-KI9gXBY2g9OvzIjjTXIGvQ6OsicXX8VcvVW1V7I5CYd8oQUGc.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_ohc=...",96 "audio_url": null,97 "image_urls": null,98 "width": 1080,99 "height": 1350100 },101 "song": null,102 "location": null,103 "is_pinned": false,104 "is_sponsored": false,105 "extra": {106 "code": "DfFvCX4jBws",107 "full_id": "4018825113767779372_63232452248",108 "quotes": 18,109 "reply_control": "everyone",110 "reposts": 158,111 "shares_sent": 16112 }113 }114 ],115 "cursor": null,116 "has_more": false,117 "parent": null118 },119 "cursor": null,120 "has_more": false121}Response#
A list of Post objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- Threads profile (
GET /v1/threads/profile) - Threads profile posts (
GET /v1/threads/profile/posts) - Threads post (
GET /v1/threads/post) - Threads user search (
GET /v1/threads/search/users)