List ads
GET {{baseUrl}}/ad_accounts/:ad_account_id/ads?campaign_ids=84772&ad_group_ids=84772&ad_ids=84772&entity_statuses=ACTIVE&entity_statuses=ACTIVE&page_size=25&order=ASCENDING&bookmark=aliqua adipisicing ad ullamco officia
Get a list of the ads in the specified adaccountid, filtered by the specified options.
- The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
campaign_ids | number | List of Campaign Ids to use to filter the results. | |
ad_group_ids | number | List of Ad group Ids to use to filter the results. | |
ad_ids | number | List of Ad Ids to use to filter the results. | |
entity_statuses | string | Entity status | |
entity_statuses | string | Entity status | |
page_size | number | Maximum number of items to include in a single page of the response. See documentation on <a href='/docs/api/v5/#tag/Pagination'>Pagination</a> for more information. | |
order | string | The order in which to sort the items returned: “ASCENDING” or “DESCENDING” | |
| by ID. Note that higher-value IDs are associated with more-recently added | |||
| items. | |||
bookmark | string | Cursor used to fetch the next page of items |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"ad_group_id":"2680059592705","android_deep_link":"sed Excepteur nulla","carousel_android_deep_links":["in anim aliqua ullamco commodo","tempor anim irure dolor"],"carousel_destination_urls":["non",""],"carousel_ios_deep_links":["cillum pariatur aliqua","pariatur"],"click_tracking_url":"id Duis","creative_type":"REGULAR","destination_url":"amet et eu","ios_deep_link":"ea nostrud","is_pin_deleted":false,"is_removable":false,"name":"ipsum","pin_id":"394205773611545468","status":"ACTIVE","tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"view_tracking_url":"Duis officia proident culpa esse","ad_account_id":"549755885175","campaign_id":"626735565838","collection_items_destination_url_template":"laboris non veniam sunt","created_time":1451431341,"id":"687195134316","rejected_reasons":["NAR","WEAPONS"],"rejection_labels":["ex","eu sunt exercitation sed veni"],"review_status":"PENDING","type":"pinpromotion","updated_time":1451431341,"summary_status":"APPROVED"},{"ad_group_id":"2680059592705","android_deep_link":"ut Ut quis anim magna","carousel_android_deep_links":["eiusmod","officia"],"carousel_destination_urls":["deserunt Lorem id","voluptate nulla sed esse exercitation"],"carousel_ios_deep_links":["est l","id exercitation irure incididunt"],"click_tracking_url":"aliquip","creative_type":"REGULAR","destination_url":"culpa f","ios_deep_link":"eu dolore commodo","is_pin_deleted":false,"is_removable":false,"name":"sit commodo occaecat","pin_id":"394205773611545468","status":"ACTIVE","tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"view_tracking_url":"officia ad ex","ad_account_id":"549755885175","campaign_id":"626735565838","collection_items_destination_url_template":"aliqua","created_time":1451431341,"id":"687195134316","rejected_reasons":["LANDING_PAGE_QUALITY","LANDING_PAGE_SPEED"],"rejection_labels":["ut laborum","Lorem nisi elit tem"],"review_status":"PENDING","type":"pinpromotion","updated_time":1451431341,"summary_status":"APPROVED"}],"bookmark":"Excepteur eiusmod"}