Search Odysee's public video catalog (LBRY network) with full-text queries and paginated results. Returns claim id, public odysee.com url, title, description, thumbnail, duration, release time (ISO 8601, UTC), tags and channel for each video. Failed requests are never charged; a valid empty result page is a successful, charged request.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
3 optional filters available.
string
Required
The full-text search query (e.g. ethereum).
coffee shops
integer
Optional
1-based page number for pagination. Defaults to 1.
1
integer
Optional
Results per page (1-50). Defaults to 20.
10
string
Optional
Optional claim_search order, e.g. trending_group. Omit for relevance.
example
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP UPSTREAM_UNAVAILABLE
Odysee search is temporarily unavailable. Please retry.
HTTP UPSTREAM_UNEXPECTED_RESPONSE
Odysee returned an unexpected response.
HTTP INVALID_PARAMETER
Odysee rejected one or more parameter values. Check your parameters and try again.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.