Endpoints
media-search
Was this page helpful?
Search the available media library with a validated natural-language query.
GET
/api/v1/media-search
Describe media search
Authentication: Public
curl "https://reviral.ai/api/v1/media-search"Responses
- 200
- Media search contract
POST
/api/v1/media-search
Search available media
Authentication: Bearer API key required
curl -X POST "https://reviral.ai/api/v1/media-search" \
-H "Authorization: Bearer $REVIRAL_API_KEY" \
-H "Content-Type: application/json" \
--data '{"query":"bright modern studio","type":"any","limit":10}'Request body
| Field | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | — |
| type | string: image | video | any | No | — |
| limit | integer (min 1, max 50) | No | — |
Responses
- 200
- Ranked matching media
- 400
- Invalid body
- 401
- Key is missing, revoked, or invalid