Google DoubleClick Bid Manager API
Browse all Google APIs✓ Official Vendor SpecMarketingAdvertisingoauth27 EndpointsREST
For Agents
Create, run, and download Display & Video 360 reports that aggregate programmatic spend, impressions, clicks, and conversions across campaigns, line items, and creatives.
Use for: Create a daily report of impressions and spend per advertiser in DV360, List all queries my service account has access to, I need to run yesterday's spend report right now, Get the download URL for the latest run of report 12345
Not supported: Does not manage campaigns, line items, creatives, or audience targeting — use for DV360 reporting query and report file access only.
The DoubleClick Bid Manager API (DBM, part of Display & Video 360) lets advertisers create, run, and download reports that aggregate spend, impressions, clicks, and conversions across DV360 campaigns, line items, and creatives. Reports are defined as queries with metrics, dimensions, filters, and a schedule, then run on demand or on a recurring cadence. The API exposes the full query lifecycle plus access to historical report files. It is the canonical reporting interface for programmatic display and video buying inside Display & Video 360.
Install Jentic One Beta
Connect the DoubleClick Bid Manager API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the DoubleClick Bid Manager 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 DoubleClick Bid Manager API.
Create a saved report query with chosen metrics, dimensions, filters, and schedule
List existing report queries belonging to the authenticated DV360 partner or advertiser
Run a saved query on demand and receive a report ID for download
List historical report files generated for a query and download their CSV results
Delete a saved query that is no longer needed and stop its recurring runs
Get a single report by ID to retrieve metadata, status, and signed download URL
Use Cases
Patterns agents use DoubleClick Bid Manager API for, with concrete tasks.
★ Programmatic Spend Reconciliation
Media operations teams pull DV360 spend, impressions, and clicks daily into their data warehouse to reconcile with finance and performance dashboards. The API lets them define a query once with the dimensions and metrics they need, schedule it, and download CSV outputs as they are produced. End-to-end pipeline setup typically takes a day or two, replacing manual UI exports.
Create a query with metrics IMPRESSIONS, REVENUE_USD and dimension ADVERTISER for the last 30 days, run it, and return the download URL once the report file is READY.
Campaign Performance Dashboards
Analytics teams feed DBM CSVs into BI tools to build dashboards showing campaign and line item performance against pacing and goal CPA. Recurring queries deliver the latest data on a schedule; the API surfaces the file URL for each run, which pipelines can fetch without UI access. Adding a new dashboard typically takes hours rather than waiting on manual exports.
List queries via GET /queries, identify the daily campaign performance query, fetch the latest report from /queries/{queryId}/reports, and load the CSV into BigQuery.
Conversion Attribution Audits
When marketers compare DV360 reported conversions against third-party measurement, they pull both raw and modelled conversions from DBM and join them on click and conversion IDs. The API supports the conversion-rich dimensions and metrics needed for attribution reconciliation, and historical report files remain accessible by ID for re-pulls during audits.
Create a query with conversion metrics and click_id dimension for the audit window, run it, then GET /queries/{queryId}/reports/{reportId} to retrieve the file metadata and signed download URL.
Agent-Generated Performance Briefings via Jentic
An AI agent producing a weekly programmatic performance brief calls DBM through Jentic to fetch the latest spend and conversion numbers, summarise them, and email the team. The agent does not need to wire up OAuth, query polling, or CSV parsing manually; Jentic returns the matching DBM operation and its schema for each step.
Search Jentic for 'run a DV360 report', load the schema for POST /queries/{queryId}:run, execute it, then poll the reports endpoint until the file is ready and download the CSV.
Key Endpoints
7 endpoints — the doubleclick bid manager api (dbm, part of display & video 360) lets advertisers create, run, and download reports that aggregate spend, impressions, clicks, and conversions across dv360 campaigns, line items, and creatives.
METHOD
PATH
DESCRIPTION
POST
/queries
Create a saved report query
GET
/queries
List existing report queries
POST
/queries/{queryId}:run
Run a saved query on demand
GET
/queries/{queryId}/reports
List report runs for a query
GET
/queries/{queryId}/reports/{reportId}
Get a single report file's metadata and download URL
DELETE
/queries/{queryId}
Delete a saved query
POST
/queries
Create a saved report query
GET
/queries
List existing report queries
POST
/queries/{queryId}:run
Run a saved query on demand
GET
/queries/{queryId}/reports
List report runs for a query
GET
/queries/{queryId}/reports/{reportId}
Get a single report file's metadata and download URL
DELETE
/queries/{queryId}
Delete a saved query
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Google OAuth client credentials and refresh tokens are stored encrypted in the Jentic vault. Agents receive scoped Bearer tokens with the doubleclickbidmanager scope only; full client secrets never enter the agent context.
Intent-based discovery
Agents search by intent (e.g. 'pull DV360 spend report') and Jentic returns the create-query, run-query, and get-report operations with input schemas, so the agent can wire up the full flow without browsing DBM docs.
Time to first call
Direct DBM integration: 2-3 days for OAuth, query schema, run polling, and CSV download from GCS. Through Jentic: under 1 hour for a one-shot 'run and download' flow.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using DoubleClick Bid Manager API through Jentic.
What authentication does the DoubleClick Bid Manager API use?
DBM uses Google OAuth 2.0 with the doubleclickbidmanager scope. Both end-user OAuth and service account flows are supported. Through Jentic the credentials are stored in the encrypted vault and the agent receives scoped Bearer tokens only.
Can I create scheduled reports with the DoubleClick Bid Manager API?
Yes. POST /queries accepts a schedule object with frequency and start/end dates so the report runs automatically. You can also call POST /queries/{queryId}:run to trigger an out-of-cycle run on demand.
What are the rate limits for the DoubleClick Bid Manager API?
DBM enforces per-project quotas in the Google Cloud Console (typical default 4 queries per second per project) plus DV360-side limits on concurrent report generation per partner. Large reports may be queued behind the partner's concurrency limit.
How do I download a DV360 report through Jentic?
Search Jentic for 'download a DV360 report', load the schema for GET /queries/{queryId}/reports/{reportId}, and execute it with the IDs returned by the run step. Jentic returns the report metadata including the signed Google Cloud Storage URL where the CSV can be fetched.
Is the DoubleClick Bid Manager API free?
The API itself is free to use, but it requires an active DV360 (Display & Video 360) account, which is sold to advertisers and agencies and priced via direct contracts with Google.
How do I run a saved query on demand?
POST /queries/{queryId}:run starts a new report run for an existing query and returns immediately. Poll GET /queries/{queryId}/reports until the latest entry has metadata.status == DONE, then read its googleCloudStoragePath.
GET STARTED