API Documentation

Competitive analysis workflow

Step 1: Find the exact company name using ads.listTopCompanies.

curl 'https://adscan.ai/api/v1/trpc/ads.listTopCompanies?input={"name":"madgicx"}' \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

# Response includes: { "companies": [{ "name": "madgicx.com", "adCount": 322, ... }] }

Step 2: Use the exact name with Brand Spy to get competitor overview.

curl 'https://adscan.ai/api/v1/trpc/brandSpy.getOverview?input={"companyName":"madgicx.com","status":"active"}' \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

Response:

{
  "result": {
    "data": {
      "stats": { "totalAds": 322, "totalReach": 1500000, "imageAds": 200, "videoAds": 122 },
      "mediaTypeBreakdown": { "image": 62, "video": 38 },
      "demographics": { "gender": [...], "country": [...] },
      "topLandingPages": [{ "url": "https://madgicx.com/pricing", "adCount": 45 }],
      "topAds": [{ "id": 1234, "reach": 250000, "body": "..." }]
    }
  }
}

Get top performing ad copy

curl 'https://adscan.ai/api/v1/trpc/brandSpy.getAdCopies?input={"companyName":"madgicx.com","sortBy":"performanceScore","limit":5}' \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

Response:

{
  "result": {
    "data": {
      "copies": [
        {
          "body": "Stop wasting ad spend. Madgicx optimizes your campaigns automatically.",
          "adCount": 12,
          "totalReach": 800000,
          "daysRunning": 90,
          "performanceScore": 95.2
        }
      ],
      "total": 48,
      "hasMore": true,
      "nextCursor": 10
    }
  }
}

Discover top advertisers globally

curl 'https://adscan.ai/api/v1/trpc/brandSpy.listTopAdvertisers?input={"limit":5}' \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

Response:

{
  "result": {
    "data": [
      {
        "advertiserId": 100,
        "company": "nike.com",
        "adCount": 2400,
        "totalViews": 50000000,
        "brandLogo": "https://media.adscan.ai/...",
        "platforms": ["facebook", "instagram"]
      }
    ]
  }
}

List boards

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

Search your saved ads

ads.listsearches only ads you've saved to boards. Use searchQuery to search across ad copy, headlines, and advertiser names.

curl 'https://adscan.ai/api/v1/trpc/ads.list?input={"searchQuery":"free trial","boardId":"ALL","limit":5}' \
  -H "Authorization: Bearer adscan_live_your_api_key_here"

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" }'

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" }'