Documents v2 API

The main purpose of this API is to retrieve documents.

The production url for this API is https://nap.launchmetrics.com/documents/v2

Authentication

There are two ways to authenticate the request

with just an app_id parameter (if you don’t have an app_id you should request one) (less secure)
with an app_id + signature parameters (signature creation explained below) (more secure)

The testing environment is not up 24/7, so some calls to the testing urls may return 404

Create a signature

This method is inspired from https://dev.twitter.com/docs/auth/creating-signature

To sign a request you need:

http method in uppercase: GET, POST
Request url without parameters
The parameter string, a url-encoded and sorted parameters string (see below to know how to generate it)
Body bytes content, if you’re not sending form data
Current timestamp (in seconds)
A nonce, in other words, a random string which have at least 32 characters
An app_id provided by R&D
A secret (related to the app) provided by R&D

For example, given this parameters as key and values:

{ “query”: “girona”, "period: “last_month”, }

Step 1, add the timestampp, nonce and app_id:

{ “query”: “girona”, “period”: “last_month”, “timestamp”: “1380545928”, “nonce”: “QC3hTWyVby6PtKKeCnxPAEMPXebUP82D”, “app_id”: “3ttp2946sij2hic” }

Step 2, percent encode all keys and values

{ “query”: “girona”, “period”: “last_month”, “timestamp”: “1380545928”, “nonce”: “QC3hTWyVby6PtKKeCnxPAEMPXebUP82D”, “app_id”: “3ttp2946sij2hic” }

Make sure your percent encode library encode spaces as %20 instead of +. Using the + sign will generate an incorrect signature.

Step 3, join the key and value using a = and sort the parameters alphabetically

[ “app_id=3ttp2946sij2hic”, “nonce=QC3hTWyVby6PtKKeCnxPAEMPXebUP82D”, “period=last_month”, “query=girona”, “timestamp=1380545928” ]

Step 4, join all parameters with & to generate the parameter_string

app_id=3ttp2946sij2hic&nonce=QC3hTWyVby6PtKKeCnxPAEMPXebUP82D&period=last_month&query=girona&timestamp=1380545928

Step 5, generate the signature_base string using this schema

signature_base = http_method&url_encoded(request_url)&url_encoded(parameter_string)

Step 6, if you’re sending not form data on body(p.e. a json or plain text), add body bytes after a new line

signature_base = signature_base + “\n” + ‘{“json”: “example”}’

where

http_method is the http method used for the request in uppercase: GET
request_url is the url without parameters and without the protocol, for example nap.aws.augure.com/v1/search/influencers
parameter_string is explained above, for example app_id=3ttp2946sij2hic&nonce=QC3hTWyVby6PtKKeCnxPAEMPXebUP82D&period=last_month&query=girona&timestamp=1380545928

Then the signature_base string will be:

GET&nap.aws.augure.com%2Fv1%2Fsearch%2Finfluencers&app_id%3D3ttp2946sij2hic%26nonce%3DQC3hTWyVby6PtKKeCnxPAEMPXebUP82D%26period%3Dlast_month%26query%3Dgirona%26timestamp%3D1380545928 {“json”: “example”}

don’t forget to url_encode the request_url and the parameter_string

Step 6, generate the signature parameter using the HMAC_SHA1 algorithm. This algorithm needs 2 strings to work, the first one will be the signature_base string, and the second one will be the secret (needed to generate the secure hash).

The output of this algorithm is binary, so you should use base64 encoding to produce the final signature string.

If the secret provided for our app is rpii62atrbqejx27v7uv32qbn8exv7gj then the signature of our request will be

OHQRsFL3dqFIStxxHcv1yY8qcy4=

Step 7, add the signature value to the request parameters and execute the request to the API. In this case will be

{ “query”: “girona”, “period”: “last_month”, “nonce”: “QC3hTWyVby6PtKKeCnxPAEMPXebUP82D”, “timestamp”: “1380545928”, “app_id”: “3ttp2946sij2hic”, “signature”: “OHQRsFL3dqFIStxxHcv1yY8qcy4=” }

Don’t forget, if you’re not using a helper library, you should url encode all keys and values.

For the POST and PUT requests which you’re not sending form data, like a json or plain text, the parameters related to the signature must be added to the url, p.e.: https://nap.launchmetrics.com/v1/analysis?app_id=xxx&nonce=xxx&timestamp=xxx&signature=xxx

Response

All responses return application/json; charset=utf-8.

Response ok (application/json)

The response element will contain the specific API method response.

{
        "status": "200",
        "time": "0.2",
        "request": {
          "method":"GET",
          "path":"/ping",
          "parameters": {}
      },
      "response": {}
    }

Response error (application/json)

There could be different messages with the correspondent HTTP error code.

{
        "status": "404",
        "time": "0.2",
        "request": {
          "method":"GET",
          "path":"/ping",
          "parameters": {}
      },
      "error": {
        "code": "WRONG_PARAMETERS",
        "message": "The email parameter is mandatory"
      }
    }

Generic Error codes

Http status 400
- MISSING_PARAMETERS
  
  Some error with the API parameters
Http status 500
- INTERNAL_ERROR
  
  Unexpected API error

Custom error codes ¶

Http status 400

DOCUMENT_INVALID_IDS

Ids passed to api are not corrects.

Http status 500

DOCUMENT_LOAD_ERROR

The load process has failed.

Documents Collection ¶

Document retrieval ¶

Documents
GET`/documents/{ids}`

Method used to get documents data.

The v2 of this endpoint ONLY retrieve DMR print documents.

If you want to retrieve a lot of documents, please use the next method instead

Example URI

GET https://nap.launchmetrics.com/documents/v2/documents/135271927088218112

URI Parameters

HideShow

ids: number (required) Example: 135271927088218112
The documents ids you want to retrieve. It can be one or more separated by comas.

If one or more of these documents aren’t in our database, it won’t be returned

Response 200

HideShow

Headers

Content-Type: application/json

Body

[
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "content": "Asymmetrische jurk, € 2900, spandex\nbodysuit, € 3200, jersey over-de-knie-\nlaarzen, € 1990, alles Balenciaga",
    "country": {
      "iso": "NL",
      "name": "NETHERLANDS"
    },
    "id": "16636505860255034802",
    "id_from_provider": "25034802",
    "indexed_at": 1665672235728,
    "inserted_at": 1663576649737,
    "language": {
      "iso": "nl",
      "name": "Dutch"
    },
    "last_updated_at": 1663576649737,
    "miv": {
      "source_miv": {},
      "value": 2500
    },
    "print": {
      "advertising": {
        "sample": {}
      },
      "article": {
        "id": "e2b79adff447fadeacbcd0583b8ee95294e8799e68b41256ff6120dbe3eeda88",
        "topic": {
          "id": 6,
          "name": "Fashion Article"
        },
        "type": {
          "id": 1,
          "name": "Mixed collective"
        }
      },
      "brand": {
        "id": 147828,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "celebrities": [],
      "communication_type": {
        "id": 9,
        "name": "MAKE-UP ARTIST"
      },
      "company": {
        "id": 88669,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "designers": [],
      "event": {},
      "extra_clipping": false,
      "holding": {
        "id": 1017,
        "name": "LVMH"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": false,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109147015.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109147015_t.jpg"
          }
        },
        "date": 1662033600000,
        "editorial_completed": false,
        "id": 10489633,
        "number": 4
      },
      "page": {
        "active": true,
        "id": "109146427",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109146427.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109146427_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1663576648300,
        "is_cover": false,
        "linked_image_location": {
          "thumbnail": {}
        },
        "numbers": [
          "174",
          "175"
        ],
        "occupation": {
          "id": 12,
          "name": "Tenth",
          "value": 0.1
        },
        "order": 142,
        "side": {
          "id": 3,
          "name": "DBL"
        },
        "type": {
          "id": 48,
          "name": "DPS"
        }
      },
      "product": {
        "id": 1024620,
        "line": {
          "id": 10120,
          "name": "Face care"
        },
        "name": "Capture Totale Cell Energy Super Potent Serum",
        "subline": {
          "id": 100667,
          "name": "Women`s face care"
        },
        "type": {
          "id": 1010,
          "name": "Cosmetics"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 2,
        "total_look": false
      },
      "season": {
        "id": 1121,
        "name": "Fall/winter 2022/2023"
      },
      "sold_brands": [],
      "source": {
        "circulation": 25000,
        "frequency": {
          "id": 5,
          "name": "bi-monthly"
        },
        "id": 190631,
        "language": {
          "iso": "nl",
          "name": "Dutch"
        },
        "name": "HARPER`S BAZAAR",
        "publisher": {
          "id": 719,
          "name": "HEARST MAGAZINES NETHERLANDS B.V. "
        }
      }
    },
    "provider": "dmr",
    "published_at": 1662033600000
  }
]

Request Documents

HideShow

Body

documents/16645962670252185049,16645962670252021737,16636505860255034802

Response 200

HideShow

Headers

Content-Type: application/json

Body

[
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "country": {
      "iso": "JP",
      "name": "JAPAN"
    },
    "id": "16645962670252185049",
    "id_from_provider": "22185049",
    "indexed_at": 1665672235728,
    "inserted_at": 1639548674189,
    "language": {
      "iso": "ja",
      "name": "Japanese"
    },
    "last_updated_at": 1639548674189,
    "miv": {
      "currency": "EUR",
      "source_miv": {
        "conversion_date": "2022-09-13",
        "conversion_rate": 132.7797,
        "currency": "JPY",
        "value": 800000
      },
      "value": 6025.0173784095
    },
    "print": {
      "advertising": {},
      "article": {
        "id": "3e278b8516e7c48b07303b4c1ea449346b2523ba4b9eb3500b67dcd719d825f4",
        "title": "bulgari",
        "topic": {
          "id": 6,
          "name": "Fashion Article"
        },
        "type": {
          "id": 3,
          "name": "Monography"
        }
      },
      "brand": {
        "id": 101,
        "name": "SPORTMAX"
      },
      "celebrities": [],
      "communication_type": {
        "id": 10,
        "name": "CREDITS ON MODEL"
      },
      "company": {
        "id": 5,
        "name": "MAX MARA FASHION GROUP"
      },
      "designers": [],
      "extra_clipping": false,
      "holding": {
        "id": 3,
        "name": "MAX MARA FASHION GROUP"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": true,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108057616.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108057616_t.jpg"
          }
        },
        "date": 1641042000000,
        "editorial_completed": true,
        "id": 10451612,
        "number": 37
      },
      "page": {
        "active": true,
        "id": "108062605",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108062605.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108062605_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1639542940620,
        "is_cover": false,
        "linked_image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108062605.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108062605_t.jpg"
          }
        },
        "numbers": [
          "186",
          "187"
        ],
        "occupation": {
          "id": 6,
          "name": "Fourth",
          "value": 0.25
        },
        "order": 186,
        "side": {
          "id": 3,
          "name": "DBL"
        },
        "type": {
          "id": 1,
          "name": "Standard SP"
        },
        "updated_at": 1652259236895
      },
      "product": {
        "line": {
          "id": 10007,
          "name": "Ready to wear"
        },
        "subline": {
          "id": 100069,
          "name": "Womenswear"
        },
        "type": {
          "id": 1001,
          "name": "Clothing"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 2,
        "total_look": false
      },
      "season": {
        "id": 1081,
        "name": "Fall/winter 2021/2022"
      },
      "sold_brands": [],
      "source": {
        "circulation": 49667,
        "frequency": {
          "id": 7,
          "name": "monthly"
        },
        "id": 110443,
        "language": {
          "iso": "ja",
          "name": "Japanese"
        },
        "name": "PRECIOUS",
        "publisher": {
          "id": 15754,
          "name": "SHOGAKUKAN"
        }
      },
      "stylist_name": "H.Oshida,ph-H.Hisatomi,N.Koike"
    },
    "provider": "dmr",
    "published_at": 1641042000000,
    "title": "bulgari"
  },
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "country": {
      "iso": "JP",
      "name": "JAPAN"
    },
    "id": "16645962670252021737",
    "id_from_provider": "22021737",
    "indexed_at": 1665672235728,
    "inserted_at": 1638251187545,
    "language": {
      "iso": "ja",
      "name": "Japanese"
    },
    "last_updated_at": 1641721866108,
    "miv": {
      "currency": "EUR",
      "source_miv": {
        "conversion_date": "2022-09-13",
        "conversion_rate": 132.7797,
        "currency": "JPY",
        "value": 160000
      },
      "value": 1205.0034756819
    },
    "print": {
      "advertising": {},
      "article": {
        "id": "eff9e8c252cc216b43cecddf78c084a4beaadd1d9aa6087ca8367306302b21f8",
        "title": "STYLE / PORTRAIT MODE",
        "topic": {
          "id": 1,
          "name": "Fashion Matter"
        },
        "type": {
          "id": 1,
          "name": "Mixed collective"
        }
      },
      "brand": {
        "id": 760,
        "name": "CHOPARD"
      },
      "celebrities": [],
      "communication_type": {
        "id": 38,
        "name": "PHOTO OF PRODUCT"
      },
      "company": {
        "id": 416,
        "name": "CHOPARD & CIE S.A."
      },
      "designers": [],
      "extra_clipping": false,
      "holding": {
        "id": 379,
        "name": "KARL SCHEUFELE GMBH"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": true,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10454432/107998877.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10454432/107998877_t.jpg"
          }
        },
        "date": 1641042000000,
        "editorial_completed": true,
        "id": 10454432,
        "number": 5
      },
      "page": {
        "active": true,
        "id": "107999082",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10454432/107999082.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10454432/107999082_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1638251090944,
        "is_cover": false,
        "numbers": [
          "16"
        ],
        "occupation": {
          "id": 12,
          "name": "Tenth",
          "value": 0.1
        },
        "order": 16,
        "side": {
          "id": 2,
          "name": "LH"
        },
        "type": {
          "id": 1,
          "name": "Standard SP"
        },
        "updated_at": 1638251090944
      },
      "product": {
        "line": {
          "id": 10219,
          "name": "Jewels"
        },
        "subline": {
          "id": 102763,
          "name": "Necklaces Fine Jewellery"
        },
        "type": {
          "id": 1032,
          "name": "Jewels"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 1,
        "total_look": false
      },
      "season": {
        "id": 1081,
        "name": "Fall/winter 2021/2022"
      },
      "sold_brands": [],
      "source": {
        "circulation": 75000,
        "frequency": {
          "id": 3,
          "name": "yearly"
        },
        "id": 192455,
        "language": {
          "iso": "ja",
          "name": "Japanese"
        },
        "name": "HARPER`S BAZAAR Suppl. JEWELLERY & WATCH",
        "publisher": {
          "id": 66669,
          "name": "HEARST FUJINGAHO CO. LTD. "
        }
      }
    },
    "provider": "dmr",
    "published_at": 1641042000000,
    "title": "STYLE / PORTRAIT MODE"
  },
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "content": "Asymmetrische jurk, € 2900, spandex\nbodysuit, € 3200, jersey over-de-knie-\nlaarzen, € 1990, alles Balenciaga",
    "country": {
      "iso": "NL",
      "name": "NETHERLANDS"
    },
    "id": "16636505860255034802",
    "id_from_provider": "25034802",
    "indexed_at": 1665672235728,
    "inserted_at": 1663576649737,
    "language": {
      "iso": "nl",
      "name": "Dutch"
    },
    "last_updated_at": 1663576649737,
    "miv": {
      "source_miv": {},
      "value": 2500
    },
    "print": {
      "advertising": {
        "sample": {}
      },
      "article": {
        "id": "e2b79adff447fadeacbcd0583b8ee95294e8799e68b41256ff6120dbe3eeda88",
        "topic": {
          "id": 6,
          "name": "Fashion Article"
        },
        "type": {
          "id": 1,
          "name": "Mixed collective"
        }
      },
      "brand": {
        "id": 147828,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "celebrities": [],
      "communication_type": {
        "id": 9,
        "name": "MAKE-UP ARTIST"
      },
      "company": {
        "id": 88669,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "designers": [],
      "event": {},
      "extra_clipping": false,
      "holding": {
        "id": 1017,
        "name": "LVMH"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": false,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109147015.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109147015_t.jpg"
          }
        },
        "date": 1662033600000,
        "editorial_completed": false,
        "id": 10489633,
        "number": 4
      },
      "page": {
        "active": true,
        "id": "109146427",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109146427.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109146427_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1663576648300,
        "is_cover": false,
        "linked_image_location": {
          "thumbnail": {}
        },
        "numbers": [
          "174",
          "175"
        ],
        "occupation": {
          "id": 12,
          "name": "Tenth",
          "value": 0.1
        },
        "order": 142,
        "side": {
          "id": 3,
          "name": "DBL"
        },
        "type": {
          "id": 48,
          "name": "DPS"
        }
      },
      "product": {
        "id": 1024620,
        "line": {
          "id": 10120,
          "name": "Face care"
        },
        "name": "Capture Totale Cell Energy Super Potent Serum",
        "subline": {
          "id": 100667,
          "name": "Women`s face care"
        },
        "type": {
          "id": 1010,
          "name": "Cosmetics"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 2,
        "total_look": false
      },
      "season": {
        "id": 1121,
        "name": "Fall/winter 2022/2023"
      },
      "sold_brands": [],
      "source": {
        "circulation": 25000,
        "frequency": {
          "id": 5,
          "name": "bi-monthly"
        },
        "id": 190631,
        "language": {
          "iso": "nl",
          "name": "Dutch"
        },
        "name": "HARPER`S BAZAAR",
        "publisher": {
          "id": 719,
          "name": "HEARST MAGAZINES NETHERLANDS B.V. "
        }
      }
    },
    "provider": "dmr",
    "published_at": 1662033600000
  }
]

Documents
POST`/documents/`

Same as the previous call, but the ids are sent with the request message body.

The v2 of this endpoint ONLY retrieve DMR print documents.

Example URI

POST https://nap.launchmetrics.com/documents/v2/documents/

Request

HideShow

Headers

Content-Type: text/plain

Body

16645962670252185049,16645962670252021737,16636505860255034802

Response 200

HideShow

Headers

Content-Type: application/json

Body

[
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "country": {
      "iso": "JP",
      "name": "JAPAN"
    },
    "id": "16645962670252185049",
    "id_from_provider": "22185049",
    "indexed_at": 1665672235728,
    "inserted_at": 1639548674189,
    "language": {
      "iso": "ja",
      "name": "Japanese"
    },
    "last_updated_at": 1639548674189,
    "miv": {
      "currency": "EUR",
      "source_miv": {
        "conversion_date": "2022-09-13",
        "conversion_rate": 132.7797,
        "currency": "JPY",
        "value": 800000
      },
      "value": 6025.0173784095
    },
    "print": {
      "advertising": {},
      "article": {
        "id": "3e278b8516e7c48b07303b4c1ea449346b2523ba4b9eb3500b67dcd719d825f4",
        "title": "bulgari",
        "topic": {
          "id": 6,
          "name": "Fashion Article"
        },
        "type": {
          "id": 3,
          "name": "Monography"
        }
      },
      "brand": {
        "id": 101,
        "name": "SPORTMAX"
      },
      "celebrities": [],
      "communication_type": {
        "id": 10,
        "name": "CREDITS ON MODEL"
      },
      "company": {
        "id": 5,
        "name": "MAX MARA FASHION GROUP"
      },
      "designers": [],
      "extra_clipping": false,
      "holding": {
        "id": 3,
        "name": "MAX MARA FASHION GROUP"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": true,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108057616.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108057616_t.jpg"
          }
        },
        "date": 1641042000000,
        "editorial_completed": true,
        "id": 10451612,
        "number": 37
      },
      "page": {
        "active": true,
        "id": "108062605",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108062605.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108062605_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1639542940620,
        "is_cover": false,
        "linked_image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10451612/108062605.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10451612/108062605_t.jpg"
          }
        },
        "numbers": [
          "186",
          "187"
        ],
        "occupation": {
          "id": 6,
          "name": "Fourth",
          "value": 0.25
        },
        "order": 186,
        "side": {
          "id": 3,
          "name": "DBL"
        },
        "type": {
          "id": 1,
          "name": "Standard SP"
        },
        "updated_at": 1652259236895
      },
      "product": {
        "line": {
          "id": 10007,
          "name": "Ready to wear"
        },
        "subline": {
          "id": 100069,
          "name": "Womenswear"
        },
        "type": {
          "id": 1001,
          "name": "Clothing"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 2,
        "total_look": false
      },
      "season": {
        "id": 1081,
        "name": "Fall/winter 2021/2022"
      },
      "sold_brands": [],
      "source": {
        "circulation": 49667,
        "frequency": {
          "id": 7,
          "name": "monthly"
        },
        "id": 110443,
        "language": {
          "iso": "ja",
          "name": "Japanese"
        },
        "name": "PRECIOUS",
        "publisher": {
          "id": 15754,
          "name": "SHOGAKUKAN"
        }
      },
      "stylist_name": "H.Oshida,ph-H.Hisatomi,N.Koike"
    },
    "provider": "dmr",
    "published_at": 1641042000000,
    "title": "bulgari"
  },
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "country": {
      "iso": "JP",
      "name": "JAPAN"
    },
    "id": "16645962670252021737",
    "id_from_provider": "22021737",
    "indexed_at": 1665672235728,
    "inserted_at": 1638251187545,
    "language": {
      "iso": "ja",
      "name": "Japanese"
    },
    "last_updated_at": 1641721866108,
    "miv": {
      "currency": "EUR",
      "source_miv": {
        "conversion_date": "2022-09-13",
        "conversion_rate": 132.7797,
        "currency": "JPY",
        "value": 160000
      },
      "value": 1205.0034756819
    },
    "print": {
      "advertising": {},
      "article": {
        "id": "eff9e8c252cc216b43cecddf78c084a4beaadd1d9aa6087ca8367306302b21f8",
        "title": "STYLE / PORTRAIT MODE",
        "topic": {
          "id": 1,
          "name": "Fashion Matter"
        },
        "type": {
          "id": 1,
          "name": "Mixed collective"
        }
      },
      "brand": {
        "id": 760,
        "name": "CHOPARD"
      },
      "celebrities": [],
      "communication_type": {
        "id": 38,
        "name": "PHOTO OF PRODUCT"
      },
      "company": {
        "id": 416,
        "name": "CHOPARD & CIE S.A."
      },
      "designers": [],
      "extra_clipping": false,
      "holding": {
        "id": 379,
        "name": "KARL SCHEUFELE GMBH"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": true,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10454432/107998877.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10454432/107998877_t.jpg"
          }
        },
        "date": 1641042000000,
        "editorial_completed": true,
        "id": 10454432,
        "number": 5
      },
      "page": {
        "active": true,
        "id": "107999082",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-01-01/10454432/107999082.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-01-01/10454432/107999082_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1638251090944,
        "is_cover": false,
        "numbers": [
          "16"
        ],
        "occupation": {
          "id": 12,
          "name": "Tenth",
          "value": 0.1
        },
        "order": 16,
        "side": {
          "id": 2,
          "name": "LH"
        },
        "type": {
          "id": 1,
          "name": "Standard SP"
        },
        "updated_at": 1638251090944
      },
      "product": {
        "line": {
          "id": 10219,
          "name": "Jewels"
        },
        "subline": {
          "id": 102763,
          "name": "Necklaces Fine Jewellery"
        },
        "type": {
          "id": 1032,
          "name": "Jewels"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 1,
        "total_look": false
      },
      "season": {
        "id": 1081,
        "name": "Fall/winter 2021/2022"
      },
      "sold_brands": [],
      "source": {
        "circulation": 75000,
        "frequency": {
          "id": 3,
          "name": "yearly"
        },
        "id": 192455,
        "language": {
          "iso": "ja",
          "name": "Japanese"
        },
        "name": "HARPER`S BAZAAR Suppl. JEWELLERY & WATCH",
        "publisher": {
          "id": 66669,
          "name": "HEARST FUJINGAHO CO. LTD. "
        }
      }
    },
    "provider": "dmr",
    "published_at": 1641042000000,
    "title": "STYLE / PORTRAIT MODE"
  },
  {
    "channel": {
      "id": 25,
      "name": "print"
    },
    "content": "Asymmetrische jurk, € 2900, spandex\nbodysuit, € 3200, jersey over-de-knie-\nlaarzen, € 1990, alles Balenciaga",
    "country": {
      "iso": "NL",
      "name": "NETHERLANDS"
    },
    "id": "16636505860255034802",
    "id_from_provider": "25034802",
    "indexed_at": 1665672235728,
    "inserted_at": 1663576649737,
    "language": {
      "iso": "nl",
      "name": "Dutch"
    },
    "last_updated_at": 1663576649737,
    "miv": {
      "source_miv": {},
      "value": 2500
    },
    "print": {
      "advertising": {
        "sample": {}
      },
      "article": {
        "id": "e2b79adff447fadeacbcd0583b8ee95294e8799e68b41256ff6120dbe3eeda88",
        "topic": {
          "id": 6,
          "name": "Fashion Article"
        },
        "type": {
          "id": 1,
          "name": "Mixed collective"
        }
      },
      "brand": {
        "id": 147828,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "celebrities": [],
      "communication_type": {
        "id": 9,
        "name": "MAKE-UP ARTIST"
      },
      "company": {
        "id": 88669,
        "name": "CHRISTIAN DIOR PARFUMS"
      },
      "designers": [],
      "event": {},
      "extra_clipping": false,
      "holding": {
        "id": 1017,
        "name": "LVMH"
      },
      "is_advertising": false,
      "issue": {
        "advertising_completed": false,
        "cover_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109147015.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109147015_t.jpg"
          }
        },
        "date": 1662033600000,
        "editorial_completed": false,
        "id": 10489633,
        "number": 4
      },
      "page": {
        "active": true,
        "id": "109146427",
        "image_location": {
          "bucket": "bit-atlas-raw-staging",
          "key": "dataInput/dmr/images/2022-09-01/10489633/109146427.jpg",
          "thumbnail": {
            "bucket": "bit-atlas-raw-staging",
            "key": "dataInput/dmr/images/2022-09-01/10489633/109146427_t.jpg"
          }
        },
        "insert": {},
        "inserted_at": 1663576648300,
        "is_cover": false,
        "linked_image_location": {
          "thumbnail": {}
        },
        "numbers": [
          "174",
          "175"
        ],
        "occupation": {
          "id": 12,
          "name": "Tenth",
          "value": 0.1
        },
        "order": 142,
        "side": {
          "id": 3,
          "name": "DBL"
        },
        "type": {
          "id": 48,
          "name": "DPS"
        }
      },
      "product": {
        "id": 1024620,
        "line": {
          "id": 10120,
          "name": "Face care"
        },
        "name": "Capture Totale Cell Energy Super Potent Serum",
        "subline": {
          "id": 100667,
          "name": "Women`s face care"
        },
        "type": {
          "id": 1010,
          "name": "Cosmetics"
        }
      },
      "reference": {
        "advertorial": false,
        "attributes": [],
        "celebrity": false,
        "fashion_show": false,
        "quantity": 2,
        "total_look": false
      },
      "season": {
        "id": 1121,
        "name": "Fall/winter 2022/2023"
      },
      "sold_brands": [],
      "source": {
        "circulation": 25000,
        "frequency": {
          "id": 5,
          "name": "bi-monthly"
        },
        "id": 190631,
        "language": {
          "iso": "nl",
          "name": "Dutch"
        },
        "name": "HARPER`S BAZAAR",
        "publisher": {
          "id": 719,
          "name": "HEARST MAGAZINES NETHERLANDS B.V. "
        }
      }
    },
    "provider": "dmr",
    "published_at": 1662033600000
  }
]

Authentication ¶

Create a signature ¶

Response ¶

Generic Error codes ¶

Custom error codes ¶

Http status 400 ¶

Http status 500 ¶

Documents Collection ¶

Document retrieval ¶

DocumentsGET/documents/{ids}

Example URI

Headers

Body

Body

Headers

Body

DocumentsPOST/documents/

Example URI

Headers

Body

Headers

Body

Authentication

Create a signature

Response

Generic Error codes

Http status 400

Http status 500

Documents
GET`/documents/{ids}`

Documents
POST`/documents/`