---
title: "Find competitor ads"
method: GET
path: "/ads/competitor-ads"
---

# Find competitor ads

`GET /ads/competitor-ads`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/ads/competitor-ads`
- Auth: HTTP bearer

Longest-running competitor ads (Meta, LinkedIn, TikTok) tracked in the creator's workspace, with advertiser, copy, format and days running. Read-only; requires analytics:read.

## Query parameters

- `platform` 'meta' | 'linkedin' | 'tiktok'
- `q` string
- `creator_id` string
- `limit` integer

## Response `200`

Competitor ads, longest running first

- GenericDataResponse
  - `data` unknown

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)
