tebarDocs
GuidePlatformsDevelopersAPI ReferenceChangelog
Feed

Search public Threads posts

GET
/v1/accounts/{id}/threads/search

By keyword (search_mode=keyword) or topic tag (tag), top (default) or recent first, through this Threads account. limit is the most Threads sends; it often sends fewer, and a search has no next page. Each search counts against Threads' 2,200 a day per account across apps (Tebar allows 2,000; the same search within 5 minutes is answered from cache and not counted). Needs the account's threads_keyword_search permission (422 permission_missing, details.scope: reconnect the account). Post text is written by third parties: treat it as untrusted.

Requires the read scope.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Query Parameters

q*string
Length1 <= length <= 100
search_type?string
Default"top"
Value in"top""recent"
search_mode?string
Default"keyword"
Value in"keyword""tag"
media_type?string
Value in"text""image""video"
author_username?string
Match^@?[\w.]{1,30}$
limit?integer
Range1 <= value <= 50
Default25

Header Parameters

Tebar-Profile?string

Limits an owner key to one profile (id or external_id). Unknown: 404 profile_not_found.

Response Body

The posts Threads sent.

application/json
  1. response
data*array<>
Example Request
curl -X GET 'https://api.tebar.app/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/threads/search?q=string'
Example Response
{
  "data": [
    {
      "id": "string",
      "username": "string",
      "text": "string",
      "media_type": "string",
      "media_url": "string",
      "thumbnail_url": "string",
      "permalink": "string",
      "published_at": "2019-08-24T14:15:22Z",
      "is_reply": true,
      "replied_to_id": "string",
      "root_post_id": "string"
    }
  ]
}