Transparency Keyword API

Endpoint

GET /api/v1/transparency?keyword=ai%20image

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

Parameter	Type	Required	Description
`keyword`	string	Yes	Keyword for advertiser and domain suggestion lookup

Validation Rules

keyword is required
domain and creativeIds cannot be provided together with keyword

Example

GET /api/v1/transparency?keyword=ai%20image
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "transparency",
    "costCredits": 2,
    "remainingCredits": 98,
    "query": {
      "keyword": "ai image"
    },
    "keyword": "ai image",
    "advertisers": [
      {
        "country": "BR",
        "name": "AIMER IMAGE LTDA",
        "id": "AR05962718198141812737",
        "adsCount": 2
      },
      {
        "country": "AT",
        "name": "ImageTwin AI GmbH",
        "id": "AR15865318654066294785",
        "adsCount": 2
      }
    ],
    "domains": [
      "maiimage.com",
      "everyaiimage.com",
      "aiimagetovideo.ai"
    ],
    "count": 13
  }
}

Response Fields

Field	Description
`data.endpoint`	Fixed value: `transparency`
`data.costCredits`	Credits consumed by this request
`data.remainingCredits`	Remaining credits after deduction
`data.query.keyword`	Original keyword parameter
`data.keyword`	Normalized keyword returned by the API
`data.advertisers`	Advertiser suggestions related to the keyword
`data.domains`	Domain suggestions related to the keyword
`data.count`	Number of returned suggestion records

Transparency Keyword API

On this page