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

# Batch Search

`POST /svm/search/batch`

## Request

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

Search for multiple titles or talent using newline-delimited JSON.

## Request body `application/x-ndjson`

- string

## Response `200`

OK

- SuccessfulResponseBatchSearchResponse
  - `data` BatchSearchResponse
    - `responses` SearchResults[]: List of search results in the same order as the requests
      - `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
              - …
            - `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
              - …
            - `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
              - …
      - `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`: Invalid request format

---

[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)