---
title: "Look up titles by name, IMDb id, or TMDB id"
method: GET
path: "/v1/titles"
tags: ["Titles"]
---

# Look up titles by name, IMDb id, or TMDB id

`GET /v1/titles`

## Request

- Base URL: `https://streamrank.io`
- URL: `https://streamrank.io/v1/titles`
- Auth: one of:
  - none
  - HTTP bearer

Returns a ranked list. Ambiguous names are not a 404. Then call GET /v1/titles/{id} for current positions. At least one of q, imdb_id, or tmdb_id is required.

## Query parameters

- `q` string
- `imdb_id` string
- `tmdb_id` integer
- `type` 'movie' | 'tv'
- `year` integer
- `limit` integer

## Response `200`

OK. Body is `{ data }` and sometimes `{ meta }`.

## Other responses

- `400`: invalid_request
- `401`: unauthorized
- `403`: plan_required
- `404`: not_found
- `429`: rate_limited or quota_exceeded

---

[API](https://skmtc.dev/streamrank/apis/streamrank-api.md) · [All operations](https://skmtc.dev/streamrank/apis/streamrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamrank/apis/streamrank-api/revisions/082b881d04e4?raw)