Use Cases

Practical workflows showing how to use the WillItTrack API for common affiliate link management tasks.

1. Single Link Check

Run a full health check on an affiliate link. The API opens the URL in a headless browser, follows all redirects, inspects cookies, detects the affiliate network, and returns a health score (0-100) with specific issues and fix recommendations.

curl

curl -X POST https://api.willittrack.com/v1/checks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pg_live_your_key_here" \
  -d '{"url": "https://www.awin1.com/cread.php?awinmid=1234&awinaffid=5678&p=https://example.com", "check_type": "link"}'

Response (201)

{
  "data": {
    "slug": "abc123",
    "healthScore": 85,
    "network": "Awin",
    "willTrack": true,
    "redirectCount": 3,
    "totalRedirectTimeMs": 1240,
    "trackingParameterPresent": true,
    "firstPartyCookieSet": true,
    "cookieExpiryDays": 30,
    "issues": [
      {
        "code": "third_party_cookie_missing",
        "severity": "info",
        "title": "No third-party cookie",
        "description": "Third-party cookies are blocked by most browsers.",
        "fix": "Rely on first-party cookie tracking instead."
      }
    ],
    ...
  }
}

Check types: link (default) checks redirects, cookies, and tracking. cmp also tests consent management platform interactions. basket additionally navigates to the basket to verify tracking persists.

2. Network Detection

Instantly identify which affiliate network a URL belongs to. This is free, requires no authentication, and does not open a browser — it analyses the URL pattern against known networks (Awin, CJ, Amazon, Impact, ShareASale, Rakuten, Skimlinks, and more).

Single URL

curl -X POST https://api.willittrack.com/v1/detect \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.awin1.com/cread.php?awinmid=1234"}'

Response

{
  "data": {
    "url": "https://www.awin1.com/cread.php?awinmid=1234",
    "isAffiliateLink": true,
    "network": "Awin",
    "trackingParams": ["awc"],
    "cookieNames": ["aw"],
    "tagDomains": ["dwin1.com"]
  }
}

Detect up to 100 URLs at once using the urls array:

Bulk detection

curl -X POST https://api.willittrack.com/v1/detect \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.awin1.com/cread.php?awinmid=1234",
      "https://www.amazon.com/dp/B0123?tag=mysite-20",
      "https://example.com/regular-page"
    ]
  }'

3. Batch Checking

Check up to 500 URLs in a single batch. The batch runs asynchronously — create it, then poll for status. Each URL is checked individually and counts against your usage limits.

Create a batch

curl

curl -X POST https://api.willittrack.com/v1/batches \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pg_live_your_key_here" \
  -d '{
    "urls": [
      "https://www.awin1.com/cread.php?awinmid=1234&awinaffid=5678",
      "https://www.amazon.com/dp/B0123?tag=mysite-20",
      "https://click.linksynergy.com/deeplink?id=abc123&murl=https://example.com"
    ],
    "checkType": "link",
    "name": "February audit"
  }'

Response (201)

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "feb-audit-x7k2",
    "status": "pending",
    "totalUrls": 3,
    "checkType": "link"
  }
}

Poll for status

curl

curl https://api.willittrack.com/v1/batches/feb-audit-x7k2 \
  -H "Authorization: Bearer pg_live_your_key_here"

The response includes status (pending / running / completed / failed), completedCount, failedCount, and the full checks array once complete.

4. Monitoring

Set up recurring health checks that run automatically on a daily, weekly, or monthly schedule. Each run creates a new check and deducts credits (or free tier) as normal.

curl

curl -X POST https://api.willittrack.com/v1/monitors \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pg_live_your_key_here" \
  -d '{
    "name": "Main affiliate link",
    "url": "https://www.awin1.com/cread.php?awinmid=1234&awinaffid=5678",
    "checkType": "link",
    "frequency": "daily"
  }'

Response (201)

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main affiliate link",
    "url": "https://www.awin1.com/cread.php?awinmid=1234&awinaffid=5678",
    "checkType": "link",
    "frequency": "daily",
    "enabled": true,
    "nextCheckAt": "2026-02-15T12:00:00.000Z",
    ...
  }
}

Monitors can be paused with PATCH /v1/monitors/:id by setting {"enabled": false}. After 5 consecutive failures, a monitor is automatically disabled.

5. Dispute Evidence

Generate a structured plain text evidence document from any completed check. Use this when raising disputes with advertisers or affiliate networks about tracking issues.

curl

curl https://api.willittrack.com/v1/reports/abc123/evidence \
  -o evidence.txt

Returns a text/plain file download with metadata, per-issue evidence, redirect chain, cookie snapshots, and reproduction steps.

6. MCP Integration

Use WillItTrack directly from Claude Desktop, Cursor, or any MCP-compatible AI tool. The MCP endpoint provides 7 tools including link checking, network detection, batch checking, credit balance, and dispute evidence generation.

View MCP Setup Guide