Get search results

GET

{id}

results

Get search results

curl --request GET \
  --url https://api.thred.dev/search/{id}/results \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thred.dev/search/{id}/results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "search_6c479a30-cf06-4dba-8dc9-2d2893bbc64f",
  "status": "completed",
  "results": [
    {
      "id": "k17f0yc20e0v9g8g7hh76m6s7s9a5d2q",
      "rank": 1,
      "business": {
        "name": "Example Electronics",
        "url": "https://example.com/electronics",
        "phone": "+15125550123",
        "address": "Austin, TX"
      },
      "status": "completed",
      "call_id": "call_828544bf-9508-4147-b056-6198c3f2998a",
      "outcome": null,
      "content": "Example Electronics has the Nintendo Switch 2 in stock for pickup today until 6 p.m. Central Time.",
      "evidence": [
        {
          "type": "call",
          "call_id": "call_828544bf-9508-4147-b056-6198c3f2998a",
          "quote": "We have Nintendo Switch 2 consoles in stock. You can pick one up today until 6 p.m. Central Time.",
          "at_seconds": 18.2
        }
      ],
      "sources": [
        {
          "url": "https://example.com/electronics",
          "title": "Example Electronics contact details",
          "phoneExcerpt": "Call +1 512-555-0123"
        }
      ],
      "verified_at": "2026-11-12T15:00:12Z",
      "completed_at": "2026-11-12T15:02:10Z",
      "error": null
    },
    {
      "id": "k17b3a1s4c6d8e0f2g5h7j9k1m3n5p7q",
      "rank": 2,
      "business": {
        "name": "Example Games",
        "url": "https://example.com/games",
        "phone": "+15125550124",
        "address": "Austin, TX"
      },
      "status": "completed",
      "call_id": "call_946bf0ce-c7f6-497d-971b-aa77dcce9016",
      "outcome": null,
      "content": "Example Games has the Nintendo Switch 2 in stock for pickup today until 8 p.m. Central Time.",
      "evidence": [
        {
          "type": "call",
          "call_id": "call_946bf0ce-c7f6-497d-971b-aa77dcce9016",
          "quote": "The Nintendo Switch 2 is in stock. Pickup is available today until 8 p.m. Central Time.",
          "at_seconds": 24.5
        }
      ],
      "sources": [
        {
          "url": "https://example.com/games",
          "title": "Example Games contact details",
          "phoneExcerpt": "Call +1 512-555-0124"
        }
      ],
      "verified_at": "2026-11-12T15:00:15Z",
      "completed_at": "2026-11-12T15:03:05Z",
      "error": null
    }
  ],
  "next_cursor": "WyJzZWFyY2hfNmM0NzlhMzAtY2YwNi00ZGJhLThkYzktMmQyODkzYmJjNjRmIiwyXQ==",
  "has_more": false,
  "terminal": true
}

Read answers in results[].content, with source details and supporting evidence. Requested structured fields appear in output. Pass next_cursor as cursor to read the next page. Keep polling while terminal is false; finish reading when terminal is true and has_more is false. Results arrive as they become available, with their relevance rank preserved. An answer can be partial or null. Check content and any requested output fields before using them.

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <THRED_API_KEY>. Development keys begin thr_dev_; Production keys begin thr_prod_. Each key is scoped to a workspace and environment. Keep secrets on your server.

Path Parameters

string

required

Search ID returned by POST /search.

Pattern: ^search_[a-z0-9-]+$

Query Parameters

limit

integer

default:10

Maximum number of published results to return on this page.

Required range: 1 <= x <= 100

cursor

string

Opaque next_cursor from a previous page of this search. Omit it to start at the first published outcome.

Response

Saved search results.

string

required

Search ID associated with this page.

Pattern: ^search_[a-z0-9-]+$

Example:

"search_6c479a30-cf06-4dba-8dc9-2d2893bbc64f"

status

enum<string>

required

Available options:

discovering,

running,

canceling,

completed,

failed,

canceled,

expired

results

object[]

required

Maximum array length: 100

Show child attributes

next_cursor

string

required

Use for the next page or poll this cursor for future results. Returned even on an empty page.

has_more

boolean

required

More saved results exist now. False does not imply the search has finished.

terminal

boolean

required

No future results will be published for this search.

Get search results

curl --request GET \
  --url https://api.thred.dev/search/{id}/results \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thred.dev/search/{id}/results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": "search_6c479a30-cf06-4dba-8dc9-2d2893bbc64f",
  "status": "completed",
  "results": [
    {
      "id": "k17f0yc20e0v9g8g7hh76m6s7s9a5d2q",
      "rank": 1,
      "business": {
        "name": "Example Electronics",
        "url": "https://example.com/electronics",
        "phone": "+15125550123",
        "address": "Austin, TX"
      },
      "status": "completed",
      "call_id": "call_828544bf-9508-4147-b056-6198c3f2998a",
      "outcome": null,
      "content": "Example Electronics has the Nintendo Switch 2 in stock for pickup today until 6 p.m. Central Time.",
      "evidence": [
        {
          "type": "call",
          "call_id": "call_828544bf-9508-4147-b056-6198c3f2998a",
          "quote": "We have Nintendo Switch 2 consoles in stock. You can pick one up today until 6 p.m. Central Time.",
          "at_seconds": 18.2
        }
      ],
      "sources": [
        {
          "url": "https://example.com/electronics",
          "title": "Example Electronics contact details",
          "phoneExcerpt": "Call +1 512-555-0123"
        }
      ],
      "verified_at": "2026-11-12T15:00:12Z",
      "completed_at": "2026-11-12T15:02:10Z",
      "error": null
    },
    {
      "id": "k17b3a1s4c6d8e0f2g5h7j9k1m3n5p7q",
      "rank": 2,
      "business": {
        "name": "Example Games",
        "url": "https://example.com/games",
        "phone": "+15125550124",
        "address": "Austin, TX"
      },
      "status": "completed",
      "call_id": "call_946bf0ce-c7f6-497d-971b-aa77dcce9016",
      "outcome": null,
      "content": "Example Games has the Nintendo Switch 2 in stock for pickup today until 8 p.m. Central Time.",
      "evidence": [
        {
          "type": "call",
          "call_id": "call_946bf0ce-c7f6-497d-971b-aa77dcce9016",
          "quote": "The Nintendo Switch 2 is in stock. Pickup is available today until 8 p.m. Central Time.",
          "at_seconds": 24.5
        }
      ],
      "sources": [
        {
          "url": "https://example.com/games",
          "title": "Example Games contact details",
          "phoneExcerpt": "Call +1 512-555-0124"
        }
      ],
      "verified_at": "2026-11-12T15:00:15Z",
      "completed_at": "2026-11-12T15:03:05Z",
      "error": null
    }
  ],
  "next_cursor": "WyJzZWFyY2hfNmM0NzlhMzAtY2YwNi00ZGJhLThkYzktMmQyODkzYmJjNjRmIiwyXQ==",
  "has_more": false,
  "terminal": true
}

Get started

Search API

Guides

Account and utilities

Get search results

Authorizations

Path Parameters

Query Parameters

Response