Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


An example of a request URL which that contains only the basic (required) parts:

  • https://ads-[account]

    • You can find the value of the account attribute in your Adhese subscription information or through our support portal.

  • /json/
    • Adding this part to the URL makes sure that the result you receive is JSON formatted.
    • JSON has a fixed structure and, therefore, fixed fields. Refer to the List of JSON response structure object fields for an explanatory list of the fields.
  • /sl[location code]-[format code]/
    • sl Is the prefix for the section which contains the position information and is followed by two codes, separated by a dash - .
    • The location code has to match the URL code of the corresponding location in Adhese.
    • The format code has to match the code tag of the format you wish to request.
  • ?t=[timestamp]
    • It is necessary to add a timestamp to avoid caching issues.


The request URL can contain additional parameters for Targeting

An URL which that contains targeting will look like this:;OSX/dtdesktop/incars?t=244.18664863333106


The configuration of your Adhese account determines the available targeting parameters and their prefixes.  Please contact Please get in touch with our Support team for team for more details. 

Every account contains the following default parameters:


The request returns a JSON object with the fields described at in the List of JSON response structure object fields. Adhese returns an empty JSON object (just two curly brackets) if it cannot deliver a suitable ad for the request.