AdSense Host API
googleapis · Analytics
Generates performance reports, generates ad codes, and provides publisher management capabilities for AdSense Hosts.
Authentication
Sample Requests
List hosted accounts associated with this AdSense account by ad client id.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts?alt=csv&key=YOUR_API_KEY&fields=example&userIp=example"aUser=example&oauth_token=example&prettyPrint=true&filterAdClientId=example"
import requests
params = {
"alt": "csv",
"key": "YOUR_API_KEY",
"fields": "example",
"userIp": "example",
"quotaUser": "example",
"oauth_token": "example",
"prettyPrint": "true",
"filterAdClientId": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts');
url.searchParams.set('alt', 'csv');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('userIp', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('filterAdClientId', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts")
q := baseURL.Query()
q.Set("alt", "csv")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("userIp", "example")
q.Set("quotaUser", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("filterAdClientId", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts")
uri.query = URI.encode_www_form({
"alt" => "csv",
"key" => "YOUR_API_KEY",
"fields" => "example",
"userIp" => "example",
"quotaUser" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"filterAdClientId" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/accounts?" . http_build_query([
"alt" => "csv",
"key" => "YOUR_API_KEY",
"fields" => "example",
"userIp" => "example",
"quotaUser" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"filterAdClientId" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));List all host ad clients in this AdSense account.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients?alt=csv&key=YOUR_API_KEY&fields=example&userIp=example&pageToken=example"aUser=example&maxResults=1&oauth_token=example&prettyPrint=true"
import requests
params = {
"alt": "csv",
"key": "YOUR_API_KEY",
"fields": "example",
"userIp": "example",
"pageToken": "example",
"quotaUser": "example",
"maxResults": "1",
"oauth_token": "example",
"prettyPrint": "true"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients');
url.searchParams.set('alt', 'csv');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('userIp', 'example');
url.searchParams.set('pageToken', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('maxResults', '1');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients")
q := baseURL.Query()
q.Set("alt", "csv")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("userIp", "example")
q.Set("pageToken", "example")
q.Set("quotaUser", "example")
q.Set("maxResults", "1")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients")
uri.query = URI.encode_www_form({
"alt" => "csv",
"key" => "YOUR_API_KEY",
"fields" => "example",
"userIp" => "example",
"pageToken" => "example",
"quotaUser" => "example",
"maxResults" => "1",
"oauth_token" => "example",
"prettyPrint" => "true"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/adclients?" . http_build_query([
"alt" => "csv",
"key" => "YOUR_API_KEY",
"fields" => "example",
"userIp" => "example",
"pageToken" => "example",
"quotaUser" => "example",
"maxResults" => "1",
"oauth_token" => "example",
"prettyPrint" => "true"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Generate an AdSense report based on the report request sent in the query parameters. Returns the result as JSON; to retrieve output in CSV format specify "alt=csv" as a query parameter.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports?alt=csv&key=YOUR_API_KEY&sort=desc&fields=example&filter=example&locale=en-US&metric=example&userIp=example&endDate=example&dimension=example"aUser=example&startDate=example&maxResults=1&startIndex=1&oauth_token=example&prettyPrint=true"
import requests
params = {
"alt": "csv",
"key": "YOUR_API_KEY",
"sort": "desc",
"fields": "example",
"filter": "example",
"locale": "en-US",
"metric": "example",
"userIp": "example",
"endDate": "example",
"dimension": "example",
"quotaUser": "example",
"startDate": "example",
"maxResults": "1",
"startIndex": "1",
"oauth_token": "example",
"prettyPrint": "true"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports');
url.searchParams.set('alt', 'csv');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('sort', 'desc');
url.searchParams.set('fields', 'example');
url.searchParams.set('filter', 'example');
url.searchParams.set('locale', 'en-US');
url.searchParams.set('metric', 'example');
url.searchParams.set('userIp', 'example');
url.searchParams.set('endDate', 'example');
url.searchParams.set('dimension', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('startDate', 'example');
url.searchParams.set('maxResults', '1');
url.searchParams.set('startIndex', '1');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports")
q := baseURL.Query()
q.Set("alt", "csv")
q.Set("key", "YOUR_API_KEY")
q.Set("sort", "desc")
q.Set("fields", "example")
q.Set("filter", "example")
q.Set("locale", "en-US")
q.Set("metric", "example")
q.Set("userIp", "example")
q.Set("endDate", "example")
q.Set("dimension", "example")
q.Set("quotaUser", "example")
q.Set("startDate", "example")
q.Set("maxResults", "1")
q.Set("startIndex", "1")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports")
uri.query = URI.encode_www_form({
"alt" => "csv",
"key" => "YOUR_API_KEY",
"sort" => "desc",
"fields" => "example",
"filter" => "example",
"locale" => "en-US",
"metric" => "example",
"userIp" => "example",
"endDate" => "example",
"dimension" => "example",
"quotaUser" => "example",
"startDate" => "example",
"maxResults" => "1",
"startIndex" => "1",
"oauth_token" => "example",
"prettyPrint" => "true"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/adsensehost/v4.1/reports?" . http_build_query([
"alt" => "csv",
"key" => "YOUR_API_KEY",
"sort" => "desc",
"fields" => "example",
"filter" => "example",
"locale" => "en-US",
"metric" => "example",
"userIp" => "example",
"endDate" => "example",
"dimension" => "example",
"quotaUser" => "example",
"startDate" => "example",
"maxResults" => "1",
"startIndex" => "1",
"oauth_token" => "example",
"prettyPrint" => "true"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with AdSense Host API?
AdSense Host API is a Analytics API. Developers commonly use analytics APIs for:
- tracking product usage and user behaviour
- building custom reporting and BI dashboards
- measuring marketing and campaign performance
- running funnel, retention, and cohort analysis
- aggregating metrics from multiple data sources
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. AdSense Host API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide