---
title: "GET /v1/projects/{project_id}/visibility/ads"
method: GET
path: "/v1/projects/{project_id}/visibility/ads"
tags: ["visibility"]
---

# GET /v1/projects/{project_id}/visibility/ads

`GET /v1/projects/{project_id}/visibility/ads`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/visibility/ads`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `audit_id` string, uuid, nullable
- `audit_ids` string[], nullable
- `market` string, uuid, nullable
- `engine` string, nullable
- `cohort` 'core' | 'comparison' | 'all'
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- VisibilityAdsResponse
  - `state` 'value' | 'not_applicable' | 'unavailable' | 'no_answers', required
  - `source_audit_ids` string[], required
  - `parser_versions` string[], required
  - `metrics_version` string, required
  - `presence` object, required
    - `answers` integer, required
    - `answers_with_ads` integer, required
    - `rate` number, nullable, required
  - `engines` object[], required
    - `engine` string, required
    - `applicability` 'applicable' | 'unavailable' | 'not_applicable', required
    - `answers` integer, required
    - `presence` object, nullable, required
      - `answers` integer, required
      - `answers_with_ads` integer, required
      - `rate` number, nullable, required
  - `brand` object, required
    - `appearances` integer, required
    - `share` number, nullable, required
    - `best_rank` integer, nullable, required
  - `advertisers_seen` integer, required
  - `advertisers` object[], required
    - `name` string, required
    - `domain` string, required
    - `ownership` 'owned' | 'competitor' | 'other', required
    - `appearances` integer, required
    - `prompts` integer, required
    - `share` number, required
    - `first_seen_at` string, required
    - `last_seen_at` string, required
  - `creatives` object, required
    - `items` object[], required
      - `advertiser_name` string, required
      - `advertiser_domain` string, required
      - `ownership` 'owned' | 'competitor' | 'other', required
      - `title` string, required
      - `snippet` string, required
      - `landing_url` string, required
      - `appearances` integer, required
      - `prompts` integer, required
      - `first_seen_at` string, required
      - `last_seen_at` string, required
    - `total` integer, required
    - `next_cursor` string, nullable, required
  - `prompts` object[], required
    - `prompt` string, required
    - `topic` string, required
    - `presence` object, required
      - `answers` integer, required
      - `answers_with_ads` integer, required
      - `rate` number, nullable, required
    - `ads_seen` integer, required
    - `top_advertiser` object, nullable, required
      - `name` string, required
      - `domain` string, required
    - `competitor_ad_answers` object, required
      - `brand_mentioned` integer, required
      - `brand_not_mentioned` integer, required
  - `topics` object[], required
    - `key` string, required
    - `label` string, required
    - `presence` object, required
      - `answers` integer, required
      - `answers_with_ads` integer, required
      - `rate` number, nullable, required
  - `runs` object[], required
    - `key` string, required
    - `label` string, required
    - `presence` object, required
      - `answers` integer, required
      - `answers_with_ads` integer, required
      - `rate` number, nullable, required

---

[API](https://skmtc.dev/citeladder/apis/citeladder-api.md) · [All operations](https://skmtc.dev/citeladder/apis/citeladder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/citeladder/apis/citeladder-api/revisions/8c9f6aea40c2?raw)