API referenceSearch

Stream an audio clip

Stream one podcast clip as MP3 from the signed link a search returned with includeAudio. The link carries its own token (valid 7 days) in t, so it needs no API key and can be the src of an <audio> element. Single Range requests are supported. Clips are free.

GET/api/v1/clips/{chunkId}

Path Parameters

chunkId*string

The result's chunk id.

Query Parameters

t*string

The signed token from the clip link.

Header Parameters

Range?string

One byte range, e.g. bytes=0-65535.

Response Body

audio/mpeg

audio/mpeg

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/clips/string?t=string"
"string"
Was this page helpful?

Re-fetch cached results GET

Retrieve previously returned search results using the queryId from a prior search response. Returns the same results without billing. The request must use the same API key that performed the original search. Results are available for 7 days. Each result carries `locked`/`tokens`/`cost`: a result not yet paid for through POST /api/v1/search/unlock comes back as a teaser (`locked: true`), never the full text.

Current quota usage and limits GET

Daily and monthly query usage and limits for the authenticated organization.