Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
bulk

Get advertiser entities in bulk

Create an asynchronous report that may include information on campaigns, ad groups, product groups, ads, keywords, schedules,and/or labels; can filter by campaigns. Though the entities may be active, archived, or paused, only active entities will return data.

post/ad_accounts/{ad_account_id}/bulk/download

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

entity_idsBulkDownloadEntityIdsItems[]

All entities specified by these IDs as well as their children and grandchildren will be downloaded if the entity type is one of the types requested to be downloaded.

entity_typesBulkEntityType[]

All entity types specified will be downloaded. Fewer types result in faster downloads.

output_format'CSV' | 'JSON'

Bulk file output format

updated_sincestring

Unix UTC timestamp to retrieve all entities that have changed since this time.

Example request

{
  "campaign_filter": {
    "end_time": "1622848072",
    "name": "campaign name",
    "start_time": "1622848072"
  },
  "entity_types": [
    "CAMPAIGN",
    "AD_GROUP"
  ],
  "updated_since": "1622848072"
}

Response

The request has succeeded.

request_idstring

ID of the bulk request.

Example response

{
  "request_id": "2680059592705"
}