Adsense API

Query Adsense-related site data by domain or publisher ID.

Test API

Endpoint

GET /api/v1/adsense

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

Provide exactly one of the following:

ParameterTypeRequiredDescription
domainstringNoTarget domain
pubIdstringNoAdsense publisher ID, for example pub-3661441281163245

Validation Rules

  • domain and pubId cannot be provided together
  • at least one of them must be provided

Query by Domain

GET /api/v1/adsense?domain=twitter.com
Authorization: Bearer YOUR_API_KEY

Response Example: Domain

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "adsense",
    "costCredits": 3,
    "remainingCredits": 97,
    "query": {
      "domain": "twitter.com"
    },
    "domain": "twitter.com",
    "publisherIds": {
      "direct": [
        "pub-3661441281163245"
      ],
      "reseller": []
    },
    "total": {
      "direct": 1,
      "reseller": 0,
      "all": 1
    }
  }
}

Query by PubId

GET /api/v1/adsense?pubId=pub-3661441281163245
Authorization: Bearer YOUR_API_KEY

Response Example: PubId

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "adsense",
    "costCredits": 3,
    "remainingCredits": 97,
    "query": {
      "pubId": "pub-3661441281163245"
    },
    "adSenseId": "pub-3661441281163245",
    "domains": [
      "x.com",
      "proxy-solutions.net"
    ],
    "count": 2
  }
}

Response Fields

FieldDescription
data.endpointFixed value: adsense
data.costCreditsCredits consumed by this request
data.remainingCreditsRemaining credits after deduction
data.query.domainNormalized domain parameter when querying by domain
data.query.pubIdPublisher ID parameter when querying by pubId
data.domainReturned domain for the domain query
data.publisherIdsPublisher IDs grouped by direct and reseller
data.totalCounts for direct, reseller, and all in the domain query
data.adSenseIdReturned publisher ID for the pubId query
data.domainsDomains associated with the publisher ID
data.countNumber of returned domains

Billing

Each request deducts 3 credits