---
title: "Returns the reporting stats of the campaign for the requested time window."
method: GET
path: "/api/v3/advertisers/{advertiserId}/campaigns/{campaignId}/stats"
tags: ["Campaign"]
---

# Returns the reporting stats of the campaign for the requested time window.

`GET /api/v3/advertisers/{advertiserId}/campaigns/{campaignId}/stats`

## Request

- Base URL: `https://ads.nextdoor.com`
- URL: `https://ads.nextdoor.com/api/v3/advertisers/{advertiserId}/campaigns/{campaignId}/stats`
- Auth: HTTP bearer

## Path parameters

- `advertiserId` string, required
- `campaignId` string, required

## Query parameters

- `endTime` string, date
- `startTime` string, date

## Response `200`

The stats of the campaign for the specified time window

- object
  - `add_to_cart_conversions` integer, nullable: The total add to cart conversions
  - `add_to_wishlist_conversions` integer, nullable: The total add to wishlist conversions
  - `billable_spend` string: The total billable spend
  - `clicks` integer: The total clicks delivered
  - `cost_per_result` string, nullable: The cost per result based on the optimization goal
  - `cpc` string: The cost of a click
  - `cpm` string: The cost of a thousand impressions
  - `ctr` number, float: The percentage of clicks to impressions i.e. (clicks/impressions) * 100
  - `end_time` string, date-time: The end time of the window metrics are aggregated over
  - `impressions` integer: The total impressions delivered
  - `initiate_checkout_conversions` integer, nullable: The total initiate checkout conversions
  - `lead_conversions` integer, nullable: The total lead conversions
  - `other_conversions` integer, nullable: The total other/custom conversions
  - `purchase_conversions` integer, nullable: The total purchase conversions
  - `result` integer, nullable: The result count based on the optimization goal
  - `roas` number, double, nullable: Return on Ad Spend (Total Conversion Value / Total Ad Spend)
  - `search_conversions` integer, nullable: The total search conversions
  - `sign_up_conversions` integer, nullable: The total sign up conversions
  - `start_time` string, date-time: The start time of the window metrics are aggregated over
  - `subscribe_conversions` integer, nullable: The total subscribe conversions
  - `total_conversion_value` string, nullable: The total monetary value of all attributed conversions
  - `total_conversions` integer: The total conversions delivered
  - `view_content_conversions` integer, nullable: The total view content conversions

## 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)