# Odysee Search

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.

- **Documentation:** [https://scrappa.co/docs/odysee-api/odysee_search](https://scrappa.co/docs/odysee-api/odysee_search)
- **API group:** Odysee API
- **Endpoint:** `GET https://scrappa.co/api/odysee/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | The full-text search query (e.g. ethereum). |
| `page` | integer | No | 1-based page number for pagination. Defaults to 1. |
| `page_size` | integer | No | Results per page (1-50). Defaults to 20. |
| `order_by` | string | No | Optional claim_search order, e.g. trending_group. Omit for relevance. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Odysee search is temporarily unavailable. Please retry. |  |
|  | Odysee returned an unexpected response. |  |
|  | Odysee rejected one or more parameter values. Check your parameters and try again. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)