Create Entity Snapshot

You can create file-based snapshot for all the campaign entities for an advertiser using this method.

📘

URL: POST/api/v1/snapshot/entity

Query Parameters

ParameterDescriptionTypeRequiredPossible Values
advertiserIdThe ID of the advertiserintegerYUnique numeric identifier
entityStatusThe status of the entity  Note: The default status is “enabled”. Disabled entities won’t be part of the snapshot unless you request “disabled” and/or “all”stringYPossible values: enabled, disabled, all
entityTypesThe type of entity for which the snapshot should be generated.string arrayYPossible values:
  • campaign
  • adGroup
  • keyword
  • adItem
  • bidMultiplier
  • placement
    • If you select this value, the entity snapshot will return which placements have been included or excluded for a given keyword campaign. The placements are:
    • For a keyword campaign: Search In-grid, Carousel, Buybox, Others
    • For an Auto campaign: Search In-grid, Carousel, Buybox, Browse In-Grid, Stock Up, Home Page, Others
  • sbaProfile: only for Sponsored Brands, previously known as Search Brand Amplifier (SBA)
  • adGroupMedia: only for Sponsored Video campaigns
  • category: only for Sponsored Brand campaigns
formatChoose the format type for your snapshotstringNTypes of Format: gzip, zip Note: gzip allows decompression while file is being transferred over the network, hence it is a faster and simpler way to download the reports.  You will receive snapshot in zip format if no specific format is selected

Note: There is no limit on number of snapshot requests for an advertiser.