SHshutterstock
editorial_images

(Deprecated) License editorial content

Changed on

Deprecated; use POST /v2/editorial/images/licenses instead to get 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/licenses

Request

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
}

Changes

  • b43cab3aaaaaRevision changes
    • info

      added the optional property // to the response with the status

  • d2e03e7f655dRevision changes
    • breaking

      removed subschema #1 subschema #2 from the request property anyOf list

    • info

      added subschema #1 subschema #2 to the request property oneOf list