# Bid Manager API

The Bid Manager API is a programmatic interface for the [Display \& Video 360
reporting feature](https://support.google.com/displayvideo/topic/2798432). It provides a way to build
report queries, run them, and retrieve the resulting report file
programmatically.

See the [user guides](https://developers.google.com/bid-manager/guides/getting-started-api) and [reference documentation](https://developers.google.com/bid-manager/reference/rest) for
more information about the features of the Bid Manager API.

## How does it work?

Your team can use the Bid Manager API by sending HTTP requests. Each individual
request executes an action, such as creating, running, or retrieving a report.
The API provides [client libraries in a variety of programming
languages](https://developers.google.com/bid-manager/libraries) to help format and execute these requests.

The API uses [OAuth 2.0](https://developers.google.com/identity/protocols/oauth2) to authenticate requests. Credentials for
authentication are generated under a [Google Cloud project](https://cloud.google.com/resource-manager/docs/creating-managing-projects). You
can read more about this in the [Bid Manager API Getting Started
guide](https://developers.google.com/bid-manager/guides/getting-started-api).

Metrics and filters available to supported API versions are occasionally updated
and new versions are released on rare occasions. Earlier versions will be
deprecated and later sunset after new versions are released.

## What can it do?

Using Bid Manager API, your team can programmatically do the following:

- Build scheduled reports in bulk and regularly retrieve the resulting report files.
- Build and run ad hoc reports for one-off uses.
- Retrieve files for previously-generated reports.

> [!CAUTION]
> **Caution:** Due to the number of restrictions and requirements for report dimensions and metrics, the Bid Manager API recommends that you build new reports in the Display \& Video 360 interface first.

## Who is it built for?

Integrating with the Bid Manager API is ideal for teams that need to retrieve
aggregated, structured performance data from Display \& Video 360 on a regular
basis. Teams can use the Bid Manager API to automate the generation and
retrieval of this data, making reports available for review as soon as they are
ready.

Teams will need some engineering resources to build and support an API
integration.

## What products work with it?

[Display \& Video 360 API](https://developers.google.com/display-video/bulk-tools/tools/dv360-api) or [Structured Data Files](https://developers.google.com/display-video/bulk-tools/tools/sdf) can
be used to [update resource settings based on the performance data retrieved
using Bid Manager API](https://developers.google.com/display-video/bulk-tools/use-cases#adjust_settings_based_on_performance). Both of these tools offer the ability to
update settings of existing resources, with the Display \& Video 360 API enabling
programmatic updates of most types of resources and Structured Data Files
enabling manual updates of all resources in bulk.