DoubleClick Bid Manager API

Name: DoubleClick Bid Manager API API
Brand: DoubleClick Bid Manager API
Availability: InStock

✓ 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.

Quickstart

Get started with DoubleClick Bid Manager API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"run a DV360 spend report"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with DoubleClick Bid Manager API 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

GET STARTED

Start building with DoubleClick Bid Manager API API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use DoubleClick Bid Manager API 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

Why though 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.

Complementary

Display & Video 360 API

Manages campaigns, line items, and creatives in DV360 itself

Use alongside DBM when the agent needs to change buying setup, not just report on it

Alternative

Search Ads 360 API

Equivalent reporting and conversion upload for paid search

Choose when the channel is search rather than display/video programmatic

Complementary

Real-time Bidding API

Manages authorized buyers RTB endpoints and pretargeting

Use when the agent operates a buyer beneath DV360 and needs RTB-level controls

FAQs

Specific to using DoubleClick Bid Manager API 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.