---
title: "Get ads for a comet configuration"
method: GET
path: "/v1/comet/{id}/ads"
tags: ["Comet"]
---

# Get ads for a comet configuration

`GET /v1/comet/{id}/ads`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/comet/{id}/ads`
- Auth: HTTP bearer

Retrieves Meta ads collected for a specific comet configuration.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number
- `page` number
- `order_by` 'created_at' | 'page_like_count'
- `sort` 'asc' | 'desc'

## Response `200`

Successfully retrieved ads

- CometAdsResponseDto
  - `data` CometAdsDataDto, required
    - `custom_niche_id` string, required
    - `custom_niche_name` string
    - `total` number, required
    - `limit` number, required
    - `offset` number, required
    - `ads` CometAdItemDto[], required
      - `id` number, required
      - `ad_archive_id` string, nullable, required
      - `page_id` string, nullable, required
      - `page_profile_url` string, nullable
      - `page_profile_picture_url` string, nullable
      - `is_active` boolean, nullable
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `url` string, nullable
      - `caption` string, nullable
      - `body` string, nullable
      - `cta_type` string, nullable
      - `page_like_count` number, nullable
      - `title` string, nullable
      - `video_url` string, nullable
      - `created_at` string, required
      - `linked_at` string, required

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `404`: Comet configuration not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)