Condé Nast APIs


Welcome to our API Documentation! Get familiar with our APIs and explore their features

Getting started


All of Condé Nast's APIs work over HTTP. All you will need to interact with our APIs is a HTTP client - that can be as simple as a web browser, or a library in your favourite programming language, e.g. python requests, ruby's Rest Client, .NET's HttpClient or just plain old curl on the command line.

Our APIs are RESTful and follow most of the RESTful design patterns. They accept and return JSON. Some require authentication (usually using HTTP basic auth) and some do not. Occasionally, some APIs use HTTPS when sensitive data is being accessed.

An example


Here's an example request and response from Condé Nast's Covers API.
In this request, we are asking for information on the latest cover of Vogue.

curl http://covers.condenast.co.uk/api/v1/vg/
{
  "data": {
    "issue": {
      "brand": "Vogue",
      "covers": {
        "desktop": "/api/v1/vg/2016/9/image/desktop/",
        "digital": "/api/v1/vg/2016/9/image/digital/",
        "mobile": "/api/v1/vg/2016/9/image/mobile/",
        "print": "/api/v1/vg/2016/9/image/print/",
        "tablet": "/api/v1/vg/2016/9/image/tablet/"
      },
      "creative_director": "Jaime Perlman",
      "description": null,
      "editor": "Alexandra Shulman",
      "model": "Cara Delevingne",
      "month": 9,
      "online_editor": "Lucy Hutchings",
      "photographer": "Mario Testino",
      "price": null,
      "year": 2016
    }
  },
  "status": 200
}          

As you can see, JSON data is returned from the covers API which tells us various things about the latest cover of Vogue - who the editor is, who is on the cover, the online editor and links to the images of the cover of the magazine.

Questions?


We're always here to help - see our support section if you require any help.