Search entities

POST /data/search
Jwt authorization

Search across indexes for persons, assets and shots. Use optional filters to limit results to a project and specific indexes. Results are paginated with limit and offset.

application/json

Body Required

  • query string Required

    Search query string (minimum 3 characters)

  • project_id string(uuid)

    Filter search results by project ID

  • limit integer

    Maximum number of results per index

    Default value is 3.

  • offset integer

    Number of results to skip

    Default value is 0.

  • index_names array[string]

    List of index names to search in

    Values are assets, shots, or persons. Default value is ["assets", "shots", "persons"].

Responses

  • 200 application/json

    List of entities that contain the query

    Hide response attributes Show response attributes object
    • persons array

      List of matching persons

    • assets array

      List of matching assets

    • shots array

      List of matching shots
  • 400

    Bad request

POST /data/search 
curl \
 --request POST 'http://api.example.com/data/search' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"query":"kitsu","project_id":"a24a6ea4-ce75-4665-a070-57453082c25","limit":3,"offset":0,"index_names":["assets"]}'
Request examples 
{
  "query": "kitsu",
  "project_id": "a24a6ea4-ce75-4665-a070-57453082c25",
  "limit": 3,
  "offset": 0,
  "index_names": [
    "assets"
  ]
}
Response examples (200) 
{
  "persons": [
    {
      "id": "a24a6ea4-ce75-4665-a070-57453082c25",
      "...": null,
      "name": "John Doe"
    }
  ],
  "assets": [],
  "shots": [
    {
      "id": "a24a6ea4-ce75-4665-a070-57453082c25",
      "...": null,
      "name": "Shot 001"
    }
  ]
}