v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
catalog

Search catalogs for assets

This endpoint searches for assets in the account's catalog. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter. You can also filter search terms out in the query parameter by prefixing the term with NOT.

get/v2/catalog/search

Query parameters

sort'newest' | 'oldest'

Sort by

pageinteger

Page number

per_pageinteger

Number of results per page

querystring

One or more search terms separated by spaces

collection_idstring[]

Filter by collection id

[
  "123456",
  "456789",
  "13579"
]
asset_typestring[]

Filter by asset type

[
  "image",
  "editorial-image"
]

Response

OK

pagenumber required
per_pagenumber required
total_countnumber required

Example response

{
  "page": 1,
  "per_page": 1,
  "total_count": 82,
  "data": [
    {
      "id": "123",
      "asset": {
        "id": "1690105108",
        "type": "image",
        "name": "Young couple playing tennis at the court"
      },
      "created_time": "2021-06-10T13:26:09-04:00",
      "collection_ids": [
        "126351028"
      ]
    }
  ]
}