Ads API •References / Ads / Get Ads by Ad Account
Get Ads by Ad Account
Returns a list of ads for a specific ad account.
Request
- ad_account_idstring [uuid]Required
- idsstring
- statusesstring
- namestring
- ad_set_idsstring
- sort_fieldstring
- sort_directionstring
- page_sizeinteger
- offsetinteger
- fieldsstring
Response
- advertiser_idstring [uuid]
The unique ID returned when a new advertiser is created.
- landing_page_domainstring [uri]
URL the campaign will direct to
- clickthrough_urlstring [uri]
The link to the ads desired landing page activated by a button labelled CTA below and also the cover art image.
- createdstring [date-time]
Date the ad was created Time is in ISO-8601 format
- idstring [uuid]
ID for the actual ad ad that will be displayed to the user. It is a container for assets and metadata for the ad. It contains asset IDs which are generated via the asset endpoint.
- namestring
Name given to identify your ad.
- statusstring [ad-status]Example value:
"ACTIVE"
Allowed values:"ACTIVE"
,"PENDING"
,"PENDING_USER_APPROVAL"
,"PENDING_ADMIN_APPROVAL"
,"APPROVED"
,"REJECTED"
,"ARCHIVED"
,"UNRECOGNIZED"
- reject_reasonstring
- brand_namestring
- taglinestring
- versioninteger [int64]
When a campaign is created or updated, it is assigned a new version.
Response sample
{ "ads": [ { "advertiser_id": "za66a2eb-35cf-46a4-8d2e-0j95dfc133r4", "assets": { "audio_asset_id": "2f5488b7-0a48-4751-b3b8-701df2d8cd90", "asset_id": "2f5488b7-0a48-4751-b3b8-701df2d8cd90", "audio_asset_url": "www.spotify.com", "asset_url": "www.spotify.com", "companion_asset_id": "2g5488b7-0a48-4751-b3b8-701df2d8cd91", "companion_asset_url": "www.spotify.com" }, "landing_page_domain": "www.spotify.com", "clickthrough_url": "www.spotify.com", "created": "2022-02-07T21:00:00Z", "id": "pa66a2eb-35cf-46a4-8d2e-0j95dfc133r7", "name": "Spotify Discover Weekly feature ad", "status": "ACTIVE", "reject_reason": "Rejected reason", "brand_name": "This is a brand", "tagline": "This is a tagline", "third_party_viewability_tracking": { "measurement_partner": "IAS", "url": "www.spotify.com" }, "version": 1 }, { "advertiser_id": "za66a2eb-35cf-46a4-8d2e-0j95dfc133r4", "assets": { "audio_asset_id": "2f5488b7-0a48-4751-b3b8-701df2d8cd90", "asset_id": "2f5488b7-0a48-4751-b3b8-701df2d8cd90", "audio_asset_url": "www.spotify.com", "asset_url": "www.spotify.com", "companion_asset_id": "2g5488b7-0a48-4751-b3b8-701df2d8cd91", "companion_asset_url": "www.spotify.com" }, "landing_page_domain": "www.spotify.com", "clickthrough_url": "www.spotify.com", "created": "2022-02-07T21:00:00Z", "id": "pa66a2eb-35cf-46a4-8d2e-0j95dfc133r7", "name": "Spotify Discover Weekly feature ad", "status": "ACTIVE", "reject_reason": "Rejected reason", "brand_name": "This is a brand", "tagline": "This is a tagline", "third_party_viewability_tracking": { "measurement_partner": "IAS", "url": "www.spotify.com" }, "version": 1 } ]}