# Search titles or people (v1)

Find IMDb movies, shows and episodes by title, or actors and crew by name, with year, rating, votes, poster and directors. Returns 25 matches per page; nothing matching returns empty `results`.

- Platform: IMDb
- Request: `GET https://api.toolzerhub.com/v1/imdb/search`
- Auth: `x-api-key` header
- Cost: 1 credit per successful request. Failed requests are not billed.
- Page: https://docs.toolzerhub.com/reference/imdb/search/get-imdb-search

| Parameter | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `query` | query | yes | string | A title such as the matrix, or a person's name such as morgan freeman with type=person. |
| `type` | query | no | enum: title, person | title finds movies, shows and episodes; person finds actors and crew. Default: title. |
| `title_type` | query | no | enum: movie, tv, tv_episode, music_video, podcast, video_game | Limit a title search to one kind. tv covers series and mini-series. Ignored when type=person. |
| `cursor` | query | no | string | next_cursor from the previous page of the same request. Omit for the first page. Default: . |

## Example request

```bash
curl "https://api.toolzerhub.com/v1/imdb/search?query=<query>" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"
```

Success responses are wrapped as `{ "data": ... }`. Errors return `{ "error": { "code", "status", "message", "retryable", "details" } }`. See https://docs.toolzerhub.com/docs/responses-and-errors.