Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/google-display-video-360:google-display-video-360-queries-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: DoubleClick Bid Manager Queries API
version: v2
description: Generated from Google's published Discovery document for DoubleClick Bid Manager API (doubleclickbidmanager v2, revision 20261109). 7 operation(s).
contact:
name: Google
url: https://developers.google.com/
termsOfService: https://developers.google.com/terms
servers:
- url: https://doubleclickbidmanager.googleapis.com
tags:
- name: Queries
paths:
/v2/queries/{queryId}:
delete:
operationId: doubleclickbidmanager.queries.delete
summary: Delete queries
description: Deletes an existing query as well as its generated reports.
parameters:
- name: queryId
in: path
required: true
description: Required. The ID of the query to delete.
schema:
type: string
format: int64
responses:
'200':
description: Successful response
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
get:
operationId: doubleclickbidmanager.queries.get
summary: Get queries
description: Retrieves a query.
parameters:
- name: queryId
in: path
required: true
description: Required. The ID of the query to retrieve.
schema:
type: string
format: int64
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Query'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
/v2/queries:
post:
operationId: doubleclickbidmanager.queries.create
summary: Create queries
description: Creates a new query.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Query'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Query'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
get:
operationId: doubleclickbidmanager.queries.list
summary: List queries
description: Lists queries created by the current user.
parameters:
- name: orderBy
in: query
required: false
description: 'Field to sort the list by. Accepts the following values: * `queryId` (default) * `metadata.title` The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `queryId desc`.'
schema:
type: string
- name: pageSize
in: query
required: false
description: Maximum number of results per page. Must be between `1` and `100`. Defaults to `100` if unspecified.
schema:
type: integer
format: int32
- name: pageToken
in: query
required: false
description: A token identifying which page of results the server should return. Typically, this is the value of nextPageToken, returned from the previous call to the `queries.list` method. If unspecified, the first page of results is returned.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListQueriesResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
/v2/queries/{queryId}:run:
post:
operationId: doubleclickbidmanager.queries.run
summary: Run queries
description: Runs an existing query to generate a report.
parameters:
- name: queryId
in: path
required: true
description: Required. The ID of the query to run.
schema:
format: int64
type: string
- name: synchronous
in: query
required: false
description: Whether the query should be run synchronously. When `true`, the request won't return until the resulting report has finished running. This parameter is `false` by default. Setting this parameter to `true` is **not recommended**.
schema:
type: boolean
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RunQueryRequest'
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Report'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
/v2/queries/{queryId}/reports/{reportId}:
get:
operationId: doubleclickbidmanager.queries.reports.get
summary: Get reports
description: Retrieves a report.
parameters:
- name: queryId
in: path
required: true
description: Required. The ID of the query that generated the report.
schema:
type: string
format: int64
- name: reportId
in: path
required: true
description: Required. The ID of the query to retrieve.
schema:
type: string
format: int64
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Report'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
/v2/queries/{queryId}/reports:
get:
operationId: doubleclickbidmanager.queries.reports.list
summary: List reports
description: Lists reports generated by the provided query.
parameters:
- name: queryId
in: path
required: true
description: Required. The ID of the query that generated the reports.
schema:
format: int64
type: string
- name: orderBy
in: query
required: false
description: 'Field to sort the list by. Accepts the following values: * `key.reportId` (default) The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `key.reportId desc`.'
schema:
type: string
- name: pageSize
in: query
required: false
description: Maximum number of results per page. Must be between `1` and `100`. Defaults to `100` if unspecified.
schema:
format: int32
type: integer
- name: pageToken
in: query
required: false
description: A token identifying which page of results the server should return. Typically, this is the value of nextPageToken returned from the previous call to the `queries.reports.list` method. If unspecified, the first page of results is returned.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/ListReportsResponse'
4XX:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
default:
content:
application/json:
schema:
$ref: '#/components/schemas/GoogleRpcError'
description: Error response (google.rpc.Status)
security:
- oauth2:
- https://www.googleapis.com/auth/doubleclickbidmanager
- apiKey: []
tags:
- Queries
components:
schemas:
QueryMetadata:
description: The metadata of the query.
properties:
dataRange:
$ref: '#/components/schemas/DataRange'
description: The date range the report generated by the query will report on. This date range will be defined by the time zone as used by the advertiser.
sendNotification:
description: Whether an email notification is sent to the query creator when a report generated by the query is ready. This value is `false` by default.
type: boolean
format:
description: The format of the report generated by the query.
enum:
- FORMAT_UNSPECIFIED
- CSV
- XLSX
type: string
title:
type: string
description: The display name of the query. This value will be used in the file name of reports generated by the query.
shareEmailAddress:
description: List of additional email addresses with which to share the query. If send_notification is `true`, these email addresses will receive a notification when a report generated by the query is ready. If these email addresses are connected to Display & Video 360 users, the query will be available to them in the Display & Video 360 interface.
type: array
items:
type: string
type: object
GoogleRpcError:
type: object
description: The error envelope every Google API returns.
properties:
error:
type: object
properties:
code:
type: integer
message:
type: string
status:
type: string
details:
type: array
items:
type: object
ReportMetadata:
properties:
reportDataEndDate:
$ref: '#/components/schemas/Date'
description: The end date of the report data date range.
googleCloudStoragePath:
type: string
readOnly: true
description: Output only. The location of the generated report file in Google Cloud Storage. This field will be absent if status.state is not `DONE`.
status:
$ref: '#/components/schemas/ReportStatus'
description: The status of the report.
reportDataStartDate:
$ref: '#/components/schemas/Date'
description: The start date of the report data date range.
type: object
description: The metadata of a report.
QuerySchedule:
description: Settings on when and how frequently to run a query.
properties:
frequency:
type: string
enum:
- FREQUENCY_UNSPECIFIED
- ONE_TIME
- DAILY
- WEEKLY
- SEMI_MONTHLY
- MONTHLY
- QUARTERLY
- YEARLY
description: How frequently to run the query. If set to `ONE_TIME`, the query will only be run when queries.run is called.
nextRunTimezoneCode:
description: The canonical code for the timezone the query schedule is based on. Scheduled runs are usually conducted in the morning of a given day. Defaults to `America/New_York`.
type: string
startDate:
$ref: '#/components/schemas/Date'
description: The date on which to begin the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored.
endDate:
$ref: '#/components/schemas/Date'
description: The date on which to end the scheduled runs. This field is required if frequency is not set to `ONE_TIME`. Otherwise, it will be ignored.
type: object
Parameters:
type: object
description: Parameters of a generated report.
properties:
groupBys:
type: array
items:
type: string
description: Dimensions by which to segment and group the data. Defined by [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) values.
filters:
items:
$ref: '#/components/schemas/FilterPair'
type: array
description: Filters to limit the scope of reported data.
type:
type: string
enum:
- REPORT_TYPE_UNSPECIFIED
- STANDARD
- INVENTORY_AVAILABILITY
- AUDIENCE_COMPOSITION
- FLOODLIGHT
- YOUTUBE
- GRP
- YOUTUBE_PROGRAMMATIC_GUARANTEED
- REACH
- UNIQUE_REACH_AUDIENCE
- FULL_PATH
- PATH_ATTRIBUTION
description: The type of the report. The type of the report determines the dimesions, filters, and metrics that can be used.
metrics:
description: Metrics to define the data populating the report. Defined by [Metric](/bid-manager/reference/rest/v2/filters-metrics#metrics) values.
items:
type: string
type: array
options:
$ref: '#/components/schemas/Options'
description: Additional report parameter options.
Report:
type: object
description: A single report generated by its parent report.
properties:
key:
$ref: '#/components/schemas/ReportKey'
description: The key information identifying the report.
params:
$ref: '#/components/schemas/Parameters'
description: The parameters of the report.
metadata:
$ref: '#/components/schemas/ReportMetadata'
description: The metadata of the report.
ReportStatus:
type: object
properties:
state:
type: string
enum:
- STATE_UNSPECIFIED
- QUEUED
- RUNNING
- DONE
- FAILED
readOnly: true
description: Output only. The state of the report generation.
finishTime:
readOnly: true
description: Output only. The timestamp of when report generation finished successfully or in failure. This field will not be set unless state is `DONE` or `FAILED`.
type: string
format: google-datetime
format:
type: string
enum:
- FORMAT_UNSPECIFIED
- CSV
- XLSX
description: The format of the generated report file.
description: The status of a report.
Options:
properties:
includeOnlyTargetedUserLists:
description: Whether to include data for audience lists specifically targeted by filtered line items or insertion orders. Requires the use of `FILTER_INSERTION_ORDER` or `FILTER_LINE_ITEM` filters.
type: boolean
description: Report parameter options.
type: object
ReportKey:
description: Identifying information of a report.
properties:
queryId:
type: string
format: int64
readOnly: true
description: Output only. The unique ID of the query that generated the report.
reportId:
readOnly: true
description: Output only. The unique ID of the report.
format: int64
type: string
type: object
Date:
properties:
month:
format: int32
description: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
type: integer
year:
type: integer
description: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
format: int32
day:
type: integer
format: int32
description: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
description: 'Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp'
type: object
Query:
description: A single query used to generate a report.
properties:
metadata:
$ref: '#/components/schemas/QueryMetadata'
description: The metadata of the query.
queryId:
type: string
description: Output only. The unique ID of the query.
format: int64
readOnly: true
params:
$ref: '#/components/schemas/Parameters'
description: The parameters of the report generated by the query.
schedule:
$ref: '#/components/schemas/QuerySchedule'
description: When and how often the query is scheduled to run. If the frequency field is set to `ONE_TIME`, the query will only run when queries.run is called.
type: object
DataRange:
properties:
range:
enum:
- RANGE_UNSPECIFIED
- CUSTOM_DATES
- CURRENT_DAY
- PREVIOUS_DAY
- WEEK_TO_DATE
- MONTH_TO_DATE
- QUARTER_TO_DATE
- YEAR_TO_DATE
- PREVIOUS_WEEK
- PREVIOUS_MONTH
- PREVIOUS_QUARTER
- PREVIOUS_YEAR
- LAST_7_DAYS
- LAST_30_DAYS
- LAST_90_DAYS
- LAST_365_DAYS
- ALL_TIME
- LAST_14_DAYS
- LAST_60_DAYS
type: string
description: The preset date range to be reported on. If `CUSTOM_DATES` is assigned to this field, fields custom_start_date and custom_end_date must be set to specify the custom date range.
customEndDate:
$ref: '#/components/schemas/Date'
description: If `CUSTOM_DATES` is assigned to range, this field specifies the end date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise.
customStartDate:
$ref: '#/components/schemas/Date'
description: If `CUSTOM_DATES` is assigned to range, this field specifies the starting date for the date range that is reported on. This field is required if using `CUSTOM_DATES` range and will be ignored otherwise.
type: object
description: The date range to be reported on.
ListQueriesResponse:
type: object
properties:
queries:
description: The list of queries. This field will be absent if empty.
type: array
items:
$ref: '#/components/schemas/Query'
nextPageToken:
description: A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.list` method to retrieve the next page of results.
type: string
RunQueryRequest:
properties:
dataRange:
$ref: '#/components/schemas/DataRange'
description: The date range used by the query to generate the report. If unspecified, the query's original data_range is used.
description: Details specifying how to run a query.
type: object
FilterPair:
properties:
type:
type: string
description: The type of value to filter by. Defined by a [Filter](/bid-manager/reference/rest/v2/filters-metrics#filters) value.
value:
description: The identifying value to filter by, such as a relevant resource ID.
type: string
type: object
description: Represents a single filter rule.
ListReportsResponse:
type: object
properties:
reports:
type: array
items:
$ref: '#/components/schemas/Report'
description: The list of reports. This field will be absent if empty.
nextPageToken:
type: string
description: A token to retrieve the next page of results. Pass this value in the page_token field in the subsequent call to `queries.reports.list` method to retrieve the next page of results.
securitySchemes:
apiKey:
type: apiKey
in: query
name: key
description: API key; accepted by methods that do not need user data.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://accounts.google.com/o/oauth2/auth
tokenUrl: https://oauth2.googleapis.com/token
scopes:
https://www.googleapis.com/auth/doubleclickbidmanager: View and manage your reports in DoubleClick Bid Manager
externalDocs:
url: https://developers.google.com/bid-manager/
x-provenance:
method: harvested
publisher: Google
source: https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2
note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261109)