List ads
GET {{baseUrl}}/ad_accounts/:ad_account_id/ads?campaign_ids=9699788418&ad_group_ids=5291&ad_ids=5291&entity_statuses=ACTIVE&entity_statuses=PAUSED&page_size=25&order=ASCENDING&bookmark=ut aliqua enim magna
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 | 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/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_account_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"campaign_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"collection_items_destination_url_template":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"created_time":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"rejected_reasons":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"rejection_labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"review_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"type":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"updated_time":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"summary_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"ad_account_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"campaign_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"collection_items_destination_url_template":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"created_time":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"rejected_reasons":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"rejection_labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"review_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"type":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"updated_time":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"summary_status":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"bookmark":"quis sunt"}