API Documentation

List boards

curl "https://adscan.ai/api/v1/trpc/boards.list" \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

Response:

{
  "result": {
    "data": [
      {
        "id": 1,
        "name": "My Board",
        "order": 0,
        "published": true,
        "createdAt": "2024-01-01T00:00:00.000Z",
        "authorId": "user123",
        "views": 0,
        "parentBoardId": null
      }
    ]
  }
}

Create a board

curl -X POST "https://adscan.ai/api/v1/trpc/boards.create" \
  -H "Authorization: Bearer adscan_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "My New Board" }'

Response:

{
  "result": {
    "data": {
      "id": 42,
      "name": "My New Board",
      "parentId": null
    }
  }
}

Search ads by text

Use searchQuery to search across ad copy, headlines, and advertiser names.

curl "https://adscan.ai/api/v1/trpc/ads.list?input=%7B%22searchQuery%22%3A%22free%20trial%22%2C%22limit%22%3A5%7D" \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

# Decoded input: {"searchQuery":"free trial","limit":5}

Response:

{
  "result": {
    "data": {
      "ads": [
        {
          "id": 12345,
          "platform": "facebook",
          "displayFormat": "video",
          "createdAt": "2025-12-15T10:30:00.000Z",
          "advertiser": { "id": 1, "name": "Acme Corp", "profilePicUrl": "..." },
          "cards": [
            {
              "position": 0,
              "title": "Start Your Free Trial Today",
              "body": "Try Acme for 14 days — no credit card required.",
              "linkUrl": "https://acme.com/trial",
              "ctaText": "Sign Up",
              "mediaUrl": "...",
              "mediaType": "video"
            }
          ],
          "engagement": { "reach": 50000, "likes": 320, "comments": 45 }
        }
      ],
      "nextCursor": 12344,
      "hasMore": true,
      "queryDurationMs": 42
    }
  }
}

Search ads by website

searchQuery also matches landing page URLs, so you can find ads pointing to a specific domain.

curl "https://adscan.ai/api/v1/trpc/ads.list?input=%7B%22searchQuery%22%3A%22shopify.com%22%2C%22platforms%22%3A%5B%22facebook%22%5D%2C%22limit%22%3A10%7D" \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

# Decoded input: {"searchQuery":"shopify.com","platforms":["facebook"],"limit":10}

List ads with filters

Combine filters: board, platform, format, date range, views, and sort order.

curl "https://adscan.ai/api/v1/trpc/ads.list?input=%7B%22boardId%22%3A1%2C%22platforms%22%3A%5B%22facebook%22%2C%22instagram%22%5D%2C%22formats%22%3A%5B%22video%22%5D%2C%22sortBy%22%3A%22views%22%2C%22limit%22%3A20%7D" \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

# Decoded input: {"boardId":1,"platforms":["facebook","instagram"],"formats":["video"],"sortBy":"views","limit":20}

Follow a company

curl -X POST "https://adscan.ai/api/v1/trpc/companies.follow" \
  -H "Authorization: Bearer adscan_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "companyName": "Nike" }'