Google AdSense Host API
Browse all Google APIs✓ Official Vendor SpecMarketingAdvertisingoauth22 EndpointsREST
For Agents
Start and verify AdSense association sessions so an AdSense host platform can onboard a publisher account programmatically.
Use for: I want to start an AdSense association session for a new publisher, Verify an AdSense association token returned to my callback, Check whether a publisher has finished associating their AdSense account with my host platform, Get the URL a publisher should visit to link their AdSense account
Not supported: Does not handle ad code generation, earnings reporting, or ad unit configuration — use for AdSense host association sessions only.
The AdSense Host API gives AdSense host partners programmatic access to publisher onboarding workflows, ad code generation, and reporting on host-managed publisher accounts. It is intended for platforms that embed AdSense for content into their own products and need to associate end-publisher accounts. The interface is narrow by design and centres on starting and verifying association sessions between the host and a publisher's AdSense account.
Install Jentic One Beta
Connect the AdSense Host API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AdSense Host API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with AdSense Host API.
Start an AdSense association session that hands a publisher off to Google to link their account to the host platform
Verify a returned association token so the host platform can confirm the publisher account binding succeeded
Onboard publisher accounts into a host's content monetisation product without scraping the AdSense console
Generate redirect URLs for the AdSense Host association flow within an existing signup pipeline
Confirm association session state before enabling ad serving for a publisher in the host product
Use Cases
Patterns agents use AdSense Host API for, with concrete tasks.
★ Programmatic Publisher Onboarding
Hosting platforms that monetise third-party content with AdSense use the Host API to link an end-publisher's AdSense account to the host without scraping the AdSense web console. The flow has two calls: start an association session, then verify the resulting token after the publisher is redirected back. End-to-end onboarding can be automated inside an existing publisher signup pipeline rather than requiring manual account linking.
Call POST /adsensehost/v4.1/associationsessions/start with the host's productCode and websiteUrl, return the redirect URL to the publisher, then verify the returned token via /adsensehost/v4.1/associationsessions/verify.
Association State Verification
Once a publisher returns from the AdSense association screen, the host platform must verify the token attached to the redirect before enabling ad serving. The verify endpoint confirms whether the association completed and returns the bound AdSense account ID. This lets the host distinguish between aborted, in-progress, and completed associations and only flip the publisher's monetisation flag when the association is final.
Call associationsessions/verify with the token from the redirect query string and persist the returned AdSense accountId only if the response indicates the association succeeded.
Agent-Driven Publisher Activation
An agent integrating AdSense Host through Jentic searches for the association operation, loads the schema, and executes the start and verify calls during a publisher signup. Jentic isolates the host's OAuth credentials so the agent never sees the refresh token, and surfaces only the parameters needed to redirect the publisher and confirm the result. Integration time drops from a multi-day OAuth implementation to under an hour.
Use the Jentic search query 'start an AdSense host association session' to discover the operation, then execute the start and verify calls with the host productCode and the publisher's website URL.
Key Endpoints
2 endpoints — the adsense host api gives adsense host partners programmatic access to publisher onboarding workflows, ad code generation, and reporting on host-managed publisher accounts.
METHOD
PATH
DESCRIPTION
GET
/adsensehost/v4.1/associationsessions/start
Start an AdSense host association session and return the publisher redirect URL
GET
/adsensehost/v4.1/associationsessions/verify
Verify the token returned after the publisher completes the association screen
GET
/adsensehost/v4.1/associationsessions/start
Start an AdSense host association session and return the publisher redirect URL
GET
/adsensehost/v4.1/associationsessions/verify
Verify the token returned after the publisher completes the association screen
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
AdSense Host requires an OAuth 2.0 refresh token with the adsensehost scope. Jentic stores the refresh token encrypted in the MAXsystem vault and issues short-lived access tokens to the agent, so the raw refresh token never enters agent context.
Intent-based discovery
Agents search Jentic with intents like 'start an AdSense host association session' and Jentic returns the matching operation with its input schema, so the agent calls the right endpoint without reading Google's reference docs.
Time to first call
Direct AdSense Host integration usually takes 2-3 days for the OAuth dance plus association handling. Through Jentic, search-load-execute brings this to under an hour.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using AdSense Host API through Jentic.
What authentication does the AdSense Host API use?
The AdSense Host API uses OAuth 2.0 with the adsensehost scope. Through Jentic, the host platform's OAuth refresh token is stored encrypted in the Jentic vault and the agent receives only short-lived scoped access tokens, never the raw refresh token.
Can I onboard a publisher's AdSense account through the API without using the AdSense console?
Yes. Call associationsessions/start to obtain a redirect URL, send the publisher to that URL, and call associationsessions/verify with the returned token to confirm and capture the AdSense accountId.
What are the rate limits for the AdSense Host API?
The API is governed by the standard Google AdSense host quota and the per-project Cloud quota. Monitor usage in the Google Cloud Console quotas page for the AdSense Host API and request additional quota if a host platform expects high signup throughput.
How do I start an association session for a new publisher through Jentic?
Search Jentic for 'start an AdSense host association session', load the schema for /adsensehost/v4.1/associationsessions/start, and execute it with productCode, websiteUrl, and userLocale. Run pip install jentic and use the async search, load, execute pattern.
Is the AdSense Host API free?
API calls themselves are free; revenue share terms apply only to the underlying AdSense host product agreement. Google does not bill per request to the Host API surface.
How few endpoints does this API really have?
Just two: associationsessions/start and associationsessions/verify. The Host API only covers the association handoff; reporting and ad unit management live in other AdSense surfaces.
GET STARTED