1. Authentication
Mediago API
en
  • en
  • zh
  • Authentication
    • Get the Client-Level Access Token
      POST
    • Get Access Token
      POST
  • Account Management
    • Get the List of Accounts Under the Client
      GET
    • Get Authorized Account List
      GET
  • Campaign Management
    • Get Authorized Campaign List
      GET
    • Get Campaigns Detail
      GET
    • Create Campaign
      POST
    • Update Campaign
      POST
    • Batch Update Campaigns
      POST
    • Batch Active/Pause Campaigns
      POST
    • Batch Archive Campaigns
      POST
  • Ad Management
    • Get Authorized Ad List
      GET
    • Batch Active/Pause Ads
      POST
  • Sites Block Management
    • Get Account Block List
      GET
    • Block/Unblock Sites at Account
      POST
    • Get Campaign Block List
      GET
    • Block/Unblock Sites at Campaign
      POST
  • Report APIs
    • Get Daily Summary Data of All Campaign
      GET
    • Get Daily Report in Campaign Dimension
      GET
    • Get Daily Report in Ad Dimension
      GET
    • Get Hourly Realtime Data in Campaign or Ad Dimension
      GET
    • Get Account Daily Report in Site Dimension
      GET
    • Get Daily Report in Site Dimension
      GET
  1. Authentication

Get the Client-Level Access Token

POST
https://api.mediago.io/data/v1/client/authentication
Last modified:2026-06-12 06:26:25

How to Use Client Level API？#

Step 1: Obtain the client-level Base64-encoded API Token from the AM
Contact your dedicated AM directly to obtain it.
Note: If your system only supports non-Base64-encoded API Tokens, please inform the AM in advance, and they will provide the required API Token accordingly.
Step 2: Obtain the client-level Access Token using the client-level Base64 API Token
Request Interface：https://api.mediago.io/data/v1/client/authentication
Request Example:
图片1
Step 3: Retrieve the account IDs under the client using the client-level Access Token obtained in [Get the List of Accounts Under the Client]
Request Interface：https://api.mediago.io/data/v1/client/accounts
Request Example:
图片2
Step 4: Use the client-level Access Token from Step 2 and the account ID from Step 3 to operate on the corresponding account.
Request Interface：Refer to the operations you need to perform in the API documentation. For example, if you want to create a new Campaign, the request interface is as follows:https://api.mediago.io/manage/v1/campaign/create
For example, if you want to pull the daily-level report at the Campaign dimension, the request interface is as follows:：
https://api.mediago.io/data/v1/report/day/list
When using the Client-Level API for management, the account ID must be included in the request header.

Request

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mediago.io/data/v1/client/authentication' \
--header 'Authorization: Basic Y2xpZW50XzE0Nl_lup_lvIPl...'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
  "access_token": "MTQ2OmNsaWVudF8xNDZf5bqf5byD5rqQ6LiG...",
  "expires_in": 3600,
  "client_id": "146"
}
Modified at 2026-06-12 06:26:25
Previous
Authentication
Next
Get Access Token
Built with