Skip to main content

// Docs

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.

2. 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.

3. 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.

4. 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.

5. MCP Integration

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

View MCP Setup Guide