API: Search

Search

Full-text search across the media catalog with filters.

GET Search

GET /v1/search

Full-text search across movies and TV shows with optional genre and provider filters. Results are ranked by relevance within the specified country.

Requires Authorization: Bearer header

Parameters

q query required

Search query

string

country query required

ISO 3166-1 alpha-2 country code

string

lang query

Override language code (defaults to country's primary language)

string

limit query

integer default: 20

offset query

integer default: 0

kind query

Filter by content type

string movietv_show

genre query

Genre slug filter

string

provider query

Provider short_id filter

string

Responses

200 Search results

400 Missing required parameter

Response schema 200

resultsobject[]required

idstringrequired

slugstringrequired

titlestringrequired

original_titlestringrequirednullable

yearintegerrequirednullable

kindmovie | tv_showrequired

posterstringrequirednullable

backdropstringrequirednullable

genresstring[]required

popularitynumberrequired

tmdb_ratingnumberrequirednullable

totalintegerrequired

Total number of items (before pagination)

limitintegerrequired

offsetintegerrequired

querystringrequired

processing_time_msnumberrequired

Try it

Bearer token

Get an API key

q *

country *

lang

limit

offset

kind

genre

provider

curl -X GET 'https://popcorntime-api-production.wicked-f82.workers.dev/v1/search?q=breaking bad&country=US&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

const res = await fetch('https://popcorntime-api-production.wicked-f82.workers.dev/v1/search?q=breaking bad&country=US&limit=20', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await res.json();

import requests

res = requests.get('https://popcorntime-api-production.wicked-f82.workers.dev/v1/search?q=breaking bad&country=US&limit=20',
    headers={'Authorization': 'Bearer YOUR_API_KEY'})
data = res.json()

// Example response
null