Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
editorial_images

License editorial content

This endpoint gets licenses for one or more editorial images. You must specify the country and one or more editorial images to license. The download links in the response are valid for 8 hours.

post/v2/editorial/images/licenses

Request body

Example request

{
  "country": "USA",
  "editorial": [
    {
      "editorial_id": "10687730b",
      "license": "premier_editorial_comp",
      "metadata": {
        "customer_id": "12345",
        "geo_location": "US",
        "number_viewed": "15",
        "search_term": "dog"
      },
      "size": "original"
    }
  ]
}

Response

OK

messagestring

Optional error message

pageinteger

Current page of the response

per_pageinteger

Number of results per page

total_countinteger

Total count of all results

Example response

{
  "data": [
    {
      "allotment_charge": 1,
      "editorial_id": "69656358",
      "download": {
        "url": "https://s3-eu-west-1.amazonaws.com/api-downloads.rexfeatures.com/[random-characters].jpg?Expires=1524717323"
      }
    }
  ],
  "page": 1,
  "per_page": 1,
  "total_count": 12
}