How to access the API

Ad:s Marketing Cloud API Access

To get access to the ad:s Marketing Cloud API you need to contact your Client Solutions Manager. You will be provided with a Client ID and Client Secret, which you can use to authenticate against the API.

Authentication Flow

The authentication flow follows the Auth0 Client Credentials Grant flow (Official documentation). The steps are as follows:

1. Obtain Client ID and Secret: Contact your Client Solutions Manager to get your Client ID and Secret.

2. Request Access Token: Use the Client ID and Secret to request an access token from the token endpoint.

3. Use Access Token: Include the access token in the Authorization header of your API requests.

4. Refresh Token: If your access token expires, you can request a new one using the same Client ID and Secret.

Token lifetimes:

• Client Ids are valid indefinitely.

• Client Secrets are valid for 1 year.

• Access tokens are valid for 1 hour.

If you need to refresh your Client Secret, contact your Client Solutions Manager.

Requesting an Access Token

To request an access token, you need to make a POST request to the token endpoint with your client ID and secret. The request should include the following parameters:

Auth server token endpoint: https://auth.sportradar.com/oauth/token

Required parameters:

• grant_type: client_credentials

• audience: https://marketing-cloud

• client_id: YOUR_CLIENT_ID

• client_secret: YOUR_CLIENT_SECRET

Example curl request:

curl -XPOST \
  'https://auth.sportradar.com/oauth/token' \
  -d "grant_type=client_credentials&audience=https://marketing-cloud&client_id=YOUR_CLIENT_IDD&client_secret=YOUR_CLIENT_SECRET"

Consuming the Marketing Cloud API

When requesting resources from the Marketing Cloud API, you need to authorize yourself using the Authorization header. Use the access token, which you fetched earlier (see Requesting an Access Token) as the "Bearer token" for each request as shown below:

Authorization: "Bearer <your-access-token>"

Reporting Studio API

The Reporting Studio API is part of the Marketing Cloud API and allows you to access reporting data. An OPEN API 3.0 specification is available for the Reporting Studio API, which provides detailed information about the endpoints, request and response formats.

You can access the API documentation page on this site.

Here you will find a detailed description of all the available API endpoints in addition to some live examples you can use to get more familiar with the API. To execute the examples on a specific environment, you need to authorize yourself with your access token.

Reporting Studio API Url: https://api.reporting-studio.ads.sportradar.com