---
title: "Search"
method: POST
path: "/svm/search"
tags: ["Search"]
---

# Search

`POST /svm/search`

Locate movies and TV shows (and their IDs) with lexical search or by external identifiers

## Request body

- SearchRequest
  - `query` string — Provide a query term to search for TV show and movie titles. This parameter cannot be used if an identifier is provided.
  - `identifier` string — Provide an ID to search for exact matches of TV show and movie external IDs. The accepted external IDs are Luminate Film & TV project ID or IMDb ID. This parameter cannot be used if a query string is provided.
  - `from` integer — Offset from first result, used for pagination
  - `size` integer — Number of results to return, used for pagination

## Response `200`

OK

- SuccessfulResponseSearchResults
  - `data` SearchResults
    - `hits` TitleSearchHit[] — List of items matching the query
      - `id` string — Unique Luminate ID assigned to the item. For a search by query, TV shows are provided by season. For a search by identifier, TV shows are provided by series.
      - `release_information` SearchReleaseDate[] — Release information of the item
        - `release_date` string, date — Date the item was first available to stream formatted according to the ISO 8601 date standard (YYYY-MM-DD). For a search by identifier, refers to the first release date of the series.
      - `creators` string[] — Creators/showrunners or the director
      - `video_type` 'movie' | 'tv_show' — Type of video content, either 'movie' or 'tv_show'
      - `season` string — Identifier of the TV show season. Not present for movies or for searches by identifier.
      - `external_ids` ExternalIds — External identifiers for the title, such as IMDB and LFTV IDs
        - `imdb` string[] — IMDB ID
        - `lftv` string[] — Luminate Film & TV project ID
      - `title` string — Title of the item
    - `query` string — The search query used
    - `identifier` string — The external identifier used for the search
    - `from` integer — Requested offset from first result, used for pagination
    - `size` integer — Requested number of results to return, used for pagination
    - `total_hits` integer — Total number of results matched by the query, used for pagination
    - `success` boolean — Indicates if the search was successful
    - `error_message` string — Error message if the search failed

## Other responses

- `400` — Issue with client request

---

[API](https://skmtc.net/luminatedata/apis/authentication.md) · [All operations](https://skmtc.net/luminatedata/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luminatedata/authentication/versions/81d2bd1553e1/schema)