---
title: "Get performance"
method: GET
path: "/google-ads/performance"
tags: ["Google Ads"]
---

# Get performance

`GET /google-ads/performance`

## Request

- Base URL: `https://www.fandom.ai/api/v1`
- URL: `https://www.fandom.ai/api/v1/google-ads/performance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api/docs/google-ads/performance/get.ts> (a function with typed inputs; its response is checked against the schema)

Impressions, clicks, cost and conversions for the Fandom campaigns in one account.

Scope: `google-ads:read`.

## Query parameters

- `customerId` string, required
- `dateRange` 'LAST_7_DAYS' | 'LAST_14_DAYS' | 'LAST_30_DAYS' | 'LAST_90_DAYS'

## Response `200`

Success

- object
  - `customerId` string, required
  - `dateRange` object, required
    - `preset` string, required
    - `startDate` string, required
    - `endDate` string, required
  - `campaigns` object[], required
    - `campaignId` string, required: Fandom campaign id.
    - `name` string, required
    - `googleAdsCampaignId` string, nullable, required
    - `campaignType` string, nullable, required
    - `status` string, required: Google's status, `NOT_LINKED` or `NO_DATA`.
    - `impressions` number, required
    - `clicks` number, required
    - `cost` number, required: In the account's currency.
    - `conversions` number, required
    - `ctr` number, required: Click-through rate, in percent.
    - `cpc` number, required
    - `costPerConversion` number, required
    - `roas` number, required
  - `daily` object[], required
    - `date` string, required
    - `impressions` number, required
    - `clicks` number, required
    - `cost` number, required
    - `conversions` number, required

## Other responses

- `400`: The request is missing something or has a bad value. The message says what.
- `401`: No API key, or the key is wrong or revoked.
- `402`: The workspace's plan doesn't include this.
- `403`: The key doesn't have the scope, or isn't allowed this campaign or account.
- `429`: More than 120 requests in a minute. Wait and retry.
- `502`: Google Ads didn't answer as expected. The message says whether anything changed.

## Changes

- **2026-10-07** `dfe5b1c3d84f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api/changes/google-ads/performance/get.md)

---

[API](https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api.md) - [All operations](https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/skilledstars/apis/super-fans-enterprise-api/revisions/6c1a68a75970?raw)