NEnextdoor
Ad

Returns the reporting stats of the ad for the requested time window.

get/api/v3/advertisers/{advertiserId}/ads/{adId}/stats

Request

  • Base URL
    https://ads.nextdoor.com
  • URL
    https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/ads/{adId}/stats
  • Auth
    HTTP bearer

Path parameters

adIdstring required

The ad id for which to fetch the info

advertiserIdstring required

The id of advertiser that owns the particular ad whose stats will be returned

Query parameters

endTimestring date

The end date, inclusive, used in the stats query in [LocalDate] format e.g. '2021-01-01'. Defaults to yesterday's date.

startTimestring date

The start date used in the stats query in [LocalDate] format e.g. '2021-01-01'. Defaults to 7 days before the endTime.

Response

The stats of the ad for the specified time window

add_to_cart_conversionsinteger nullable

The total add to cart conversions

add_to_wishlist_conversionsinteger nullable

The total add to wishlist conversions

billable_spendstring

The total billable spend

clicksinteger

The total clicks delivered

cost_per_resultstring nullable

The cost per result based on the optimization goal

cpcstring

The cost of a click

cpmstring

The cost of a thousand impressions

ctrnumber float

The percentage of clicks to impressions i.e. (clicks/impressions) * 100

end_timestring date-time

The end time of the window metrics are aggregated over

impressionsinteger

The total impressions delivered

initiate_checkout_conversionsinteger nullable

The total initiate checkout conversions

lead_conversionsinteger nullable

The total lead conversions

other_conversionsinteger nullable

The total other/custom conversions

purchase_conversionsinteger nullable

The total purchase conversions

resultinteger nullable

The result count based on the optimization goal

roasnumber double nullable

Return on Ad Spend (Total Conversion Value / Total Ad Spend)

search_conversionsinteger nullable

The total search conversions

sign_up_conversionsinteger nullable

The total sign up conversions

start_timestring date-time

The start time of the window metrics are aggregated over

subscribe_conversionsinteger nullable

The total subscribe conversions

total_conversion_valuestring nullable

The total monetary value of all attributed conversions

total_conversionsinteger

The total conversions delivered

view_content_conversionsinteger nullable

The total view content conversions

Changes

No recorded changes to this operation across all 1 revision of this API.