--- title: "Returns a list of creatives for the advertiser." method: GET path: "/api/v3/advertisers/{advertiserId}/creatives" tags: ["Creative"] --- # Returns a list of creatives for the advertiser. `GET /api/v3/advertisers/{advertiserId}/creatives` ## Request - Base URL: `https://ads.nextdoor.com` - URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/creatives` - Auth: HTTP bearer ## Path parameters - `advertiserId` string, required ## Query parameters - `includeArchived` boolean - `cursor` string - `pageSize` integer, required ## Response `200` A list of creatives for the advertiser paginated - object - `creatives` object[]: The list of creatives returned in this paginated call. - `cursor` string: The cursor of the creative. - `data` union: The creative data. - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string: The body text for the creative. - `business_name` string: The creative's advertiser name - `carousel_card` union[]: The metadata of the carousel creative card. - union - object - … - object - … - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'CAROUSEL': The type of this creative - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'FEED': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'FSF_IMAGE': The type of this creative - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `price` string, nullable: Price displayed on the creative. - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string, nullable: The body text for the creative, if any. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'FEED_IMAGE': The type of this creative - `cta` string, nullable: The call to action chosen for the creative, if any - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - … - object - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `business_name` string: The creative's advertiser name - `canvas_image_url` string: The url of the creative's canvas image. - `click_tracking_urls` string[]: list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'RHR_IMAGE': The type of this creative - `cta` string, nullable: The call to action chosen for the creative, if any - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `placement` 'RHR' | 'FEED' | 'FSF' | 'SEARCH' | 'PDV': The placement for the creative. - `post_click_action` object: Post click action for the creative. - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `updated_at` string, date-time: The update time of the creative - object - `advertiser_id` string: The advertiser id of the api caller. - `body_text` string: The body text for the creative. - `business_name` string: The creative's advertiser name - `click_tracking_urls` string[]: A list of click tracking urls. - `created_at` string, date-time: The creation time of the creative. - `creative_type` 'VIDEO': The type of this creative - `cta` string: The call to action chosen for the creative. - `headline` string: The headline text for the creative. - `id` string: The id of the creative. - `impression_tracking_urls` string[]: A list of impression tracking urls. - `logo_image_url` string: The url of the creative's logo image. - `name` string: The name of the creative. - `offer_text` string, nullable: The offer text for the creative, if any. - `placement` 'FEED': The placement for the creative. - `post_click_action` union: Post click action for the creative. - object - `phone_number` string: A phone number to use for post click action - object - `lead_gen_form` object: A lead gen form for post click action - … - object - `clickthrough_url` string: A clickthrough url for the creative - `status` 'PENDING' | 'PENDING_EMAIL_CONFIRMATION' | 'APPROVED' | 'INELIGIBLE' | 'ARCHIVED': The status of the creative. - `thumbnail_url` string: The thumbnail public url of the creative. - `updated_at` string, date-time: The update time of the creative - `video_id` string: The id of the creative's video. - `video_url` string: The public url of the creative's video. - `page_info` object: The pagination info for the api caller to get the rest of the advertiser's creatives. - `end_cursor` string, nullable: The end cursor of the current page result, typically this is the cursor of the last object. - `page_size` integer: The number of results returned in this page. ## Other responses - `400`: Bad Request. Indicates that the server cannot process the request due to client-side error. For example invalid input. - `401`: Unauthorized. The API key is invalid and needs to be re-generated. - `403`: Forbidden. The token passed in has been successfully authenticated, but can’t perform the given action due to not having sufficient permissions. - `500`: Internal server error. - `503`: The server is temporarily unable to handle the request due to maintenance or overload. --- [API](https://skmtc.dev/nextdoor/apis/advertising.md) - [All operations](https://skmtc.dev/nextdoor/apis/advertising/llms.txt) - [OpenAPI document](https://skmtc.dev/nextdoor/apis/advertising/revisions/cdbbecabcffc?raw)