# Adscan

> Adscan is a competitive ad intelligence platform. Search, save, and analyze ads from Facebook, Instagram, LinkedIn, TikTok, and YouTube. Build AI-powered ad creatives with AdMachine. Collaborate with teams.

## Website

- **App:** https://adscan.ai
- **API:** https://api.adscan.ai

## API Documentation

The complete API reference with every endpoint, input schemas, and sample requests/responses is available at:

- [https://api.adscan.ai/llms.txt](https://api.adscan.ai/llms.txt)

## Quick Reference

- **Base URL:** `https://api.adscan.ai`
- **Alt Base URL:** `https://adscan.ai/api/v1/trpc` (same API, web route)
- **Protocol:** tRPC v11 over HTTP
- **Auth:** `Authorization: Bearer adscan_live_xxx`
- **Queries:** `GET /<router>.<procedure>?input={"json":{...}}`
- **Mutations:** `POST /<router>.<procedure>` with body `{"json":{...}}`

Both raw JSON and `{"json": {...}}`-wrapped input are accepted on all endpoints.

### Key concepts

- **`ads.list`** — returns only ads you've previously saved to boards (via the Chrome extension or `ads.addToBoard`). It does NOT discover new ads.
- **`brandSpy.*`** — the ad discovery and competitor research endpoints. These search the entire AdScan database.
- **Company name matching** — `brandSpy` matching is case-insensitive but must match the stored name (e.g. `"madgicx.com"` not `"Madgicx"`). Use `ads.listTopCompanies` first to look up the correct name.

## Full API Reference

- [api.adscan.ai/llms.txt](https://api.adscan.ai/llms.txt) — Complete endpoint reference with sample requests and responses