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

# Search

`POST /svm/search`

## Request

- Base URL: `https://api.luminatedata.com`
- URL: `https://api.luminatedata.com/svm/search`
- Auth: API key in header `x-api-key` and API key in header `authorization`

Locate movies and TV shows (and their IDs) with lexical search or by external identifiers. Set entity_type to 'talent' to search talent names or talent IDs instead; it defaults to 'title'.

## Request body

- SearchRequest
  - `query` string: Provide a query term to search for TV show and movie titles, or for talent names when entity_type is 'talent'. This parameter cannot be used if an identifier is provided.
  - `identifier` string: Provide an ID to search for exact matches of external IDs. For a title search the accepted external IDs are Luminate Film & TV project ID or IMDb ID; for a talent search they are the Luminate talent ID or the IMDb name ID. This parameter cannot be used if a query string is provided.
  - `entity_type` 'title' | 'talent': The type of entity to search for. Defaults to 'title', so requests that omit this parameter keep returning TV shows and movies.
  - `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` SearchHit[]: List of items matching the query
      - union
        - object
          - `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 talent, such as the IMDb name ID
            - `imdb` string[]: IMDB ID
            - `lftv` string[]: Luminate Film & TV project ID
          - `title` string: Title of the item
        - object
          - `talent_id` string: Unique Luminate ID assigned to the talent
          - `talent_name` string: Full name of the talent
          - `birthdate` string, date: Date of birth of the talent, formatted according to the ISO 8601 date standard (YYYY-MM-DD)
          - `country_of_origin` string: Country the talent originates from
          - `gender` string: Gender of the talent
          - `external_ids` ExternalIds: External identifiers for the talent, such as the IMDb name ID
            - `imdb` string[]: IMDB ID
            - `lftv` string[]: Luminate Film & TV project ID
    - `query` string: The search query used
    - `identifier` string: The external identifier used for the search
    - `entity_type` 'title' | 'talent': The type of entity that was searched
    - `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.dev/luminatedata/apis/luminate-svm-api.md) - [All operations](https://skmtc.dev/luminatedata/apis/luminate-svm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/luminatedata/apis/luminate-svm-api/revisions/ff683b83f008?raw)