Intelligence API

How to query

You can use the query below to get the latest content matching your API subscription:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/intelligence

You can query the API for specific criteria by adding one or more parameters to the API call. The response will only include intelligence matching at least one of the criteria specified.

Multiple criteria are interpreted using AND condition, whereas multiple values for the same criteria are interpreted with OR condition. For example to get all articles published on or after the 1 May 2019 with dominant country Australia, use:

https://api.acuris.com/intelligence?publishDateFrom=2019-05-01&dominantCountry=prime-AUS

To get all intelligence published where the target entity’s HQ country is the USA and the target’s HQ state is California OR the HQ state is Texas, use:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/intelligence? hqCountryInCompanyRole=prime-USA:target&hqStateInCompanyRole=prime-CA,prime-TX:target

To get a single article, you need to pass the article’s ID to the query:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/intelligence/ intelcms-9wpxbd

Pagination

Results are returned by the API in blocks of 20 items per page. The position of the first item in the active response is identified by the value ‘firstCursor’ and the value ‘lastCursor’ identifies the position of the last item of the active response:

{
    "hits": 72446,
    "results": [
        {…},
        {…}
    ],
    "firstCursor": "MjAyMDA4MTAxMTAwNDIwMDBwcmltZS0zMDg0MjU3.57053024",
    "lastCursor": "MjAyMDA4MTAxMTAwMDkyODdpbnRlbGNtcy1tNGN0Y3g=.34b9330d"
}

To paginate through the whole response you have to use the query parameters ‘pageAfter’ and ‘pageBefore’.

Passing the value of ‘lastCursor’ to ‘pageAfter’ in the API query will yield the next 20 items:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/intelligence?pageAfter= MjAyMDA4MTAxMTAwMDkyODdpbnRlbGNtcy1tNGN0Y3g=.34b9330d

Passing the value of ‘firstCursor’ to ‘pageBefore’ in the API query will yield the previous 20 items:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://api.acuris.com/intelligence?pageBefore= MjAyMDA4MTAxMTAwNDIwMDBwcmltZS0zMDg0MjU3.57053024

When there are no pages left to return, the response will look similar to the following:

[{
   "hits": 2020, 
   "results": [], 
   "lastCursor": "MTU1MzY0NDgwMDAwMF85MjA0OTU=.11ee9c92"
}]