List ads
GET {{baseUrl}}/ad_accounts/:ad_account_id/ads?campaign_ids=000442886&ad_group_ids=54369096104&ad_ids=54369096104&entity_statuses=ACTIVE&entity_statuses=PAUSED&page_size=25&order=ASCENDING&bookmark=<string>
List ads that meet the filters provided: - Listed campaign ids or ad group ids or ad ids - Listed entity statuses
If no filter is provided, all ads in the ad account are returned.
Note:
Provide only campaignid or adgroupid or adid. Do not provide more than one type.
Review status is provided for each ad; if reviewstatus is REJECTED, the rejectedreasons field will contain additional information. For more, see Pinterest advertising standards.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
campaign_ids | string | 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/getting-started/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":"AG356241","android_deep_link":"\u003cstring\u003e","carousel_android_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_destination_urls":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_ios_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"click_tracking_url":"\u003cstring\u003e","creative_type":"REGULAR","destination_url":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","is_pin_deleted":"\u003cboolean\u003e","is_removable":"\u003cboolean\u003e","name":"\u003cstring\u003e","status":"ARCHIVED","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"view_tracking_url":"\u003cstring\u003e","lead_form_id":"AG74294617","grid_click_type":"DIRECT_TO_DESTINATION","customizable_cta_type":"REQUEST_DEMO","quiz_pin_data":{"questions":[{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]},{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]}],"results":[{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"},{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"}]},"pin_id":"37","ad_account_id":"37","campaign_id":"72890","collection_items_destination_url_template":"\u003cstring\u003e","created_time":"\u003cinteger\u003e","id":"623","rejected_reasons":["IMAGE_LOW_QUALITY","IMAGE_BUSY"],"rejection_labels":["\u003cstring\u003e","\u003cstring\u003e"],"review_status":"PENDING","type":"\u003cstring\u003e","updated_time":"\u003cinteger\u003e","summary_status":"REJECTED"},{"ad_group_id":"49","android_deep_link":"\u003cstring\u003e","carousel_android_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_destination_urls":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_ios_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"click_tracking_url":"\u003cstring\u003e","creative_type":"IDEA","destination_url":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","is_pin_deleted":"\u003cboolean\u003e","is_removable":"\u003cboolean\u003e","name":"\u003cstring\u003e","status":"DRAFT","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"view_tracking_url":"\u003cstring\u003e","lead_form_id":"36857985","grid_click_type":"DIRECT_TO_DESTINATION","customizable_cta_type":"LEARN_MORE","quiz_pin_data":{"questions":[{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]},{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]}],"results":[{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"},{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"}]},"pin_id":"735","ad_account_id":"462827215","campaign_id":"60","collection_items_destination_url_template":"\u003cstring\u003e","created_time":"\u003cinteger\u003e","id":"69237845425","rejected_reasons":["LANDING_PAGE_HARDWALL","INCONSISTENT_LANG_FR"],"rejection_labels":["\u003cstring\u003e","\u003cstring\u003e"],"review_status":"REJECTED","type":"\u003cstring\u003e","updated_time":"\u003cinteger\u003e","summary_status":"PAUSED"}],"bookmark":"\u003cstring\u003e"}