Tap Rain - Dashboard

Link Splitters

Splitter Name

Link A Configuration

Link Type

Template

Selected: None

Link B Configuration

Link Type

Template

Selected: None

Traffic Split

50%

Link A

50%

Link B

Traffic will be split evenly between both links

Ranks & Perks

Earn more by increasing your lifetime earnings to unlock higher ranks and exclusive perks.

Custom Stats Report

Date Range

Start Date

End Date

Template/Locker

Country

Timezone

Current timezone: Auto-detect

Offer

Total Earnings

$0.00

Total Clicks

0

Total Leads

0

Daily Performance

Date	Earnings	Clicks	Leads	EPC	Conv. Rate

Lead Distribution by Country

Lead Distribution by Template

Merchandise Rewards

Rewards for your lifetime earnings milestones

Loading your rewards…

Stats API

Pull your data into any tool or script

Your API Key

Keep this key private. Regenerating it immediately invalidates the old one.

Endpoint

GET https://yourdomain.com/api/v1/stats

Authentication

Pass your API key using either method:

Recommended — Header

X-Api-Key: your_key_here

Alternative — Query param

?api_key=your_key_here

Avoid passing keys in URLs for production integrations — they can appear in server logs.

Parameters

Parameter	Required	Values / Notes
range	optional	`hour` · `today` · `yesterday` · `7days` · `30days` · `custom` Default: `today`
start	if custom	Start date — `YYYY-MM-DD` e.g. `2026-01-15`
end	if custom	End date — `YYYY-MM-DD` · max 365-day span e.g. `2026-01-31`
timezone	optional	Any IANA timezone string Default: `America/New_York` · e.g. `UTC`, `Europe/London`
country	optional	Comma-separated ISO-3166-1 alpha-2 country codes e.g. `US,GB,CA`
offer	optional	Comma-separated offer names (exact, as shown in dashboard) e.g. `Freecash CPI,KashKick`
source	optional	Comma-separated campaign source / s2 values. Append `` for a case-insensitive prefix match* — e.g. `ca1_` matches ca1_ig, ca1_tt, etc. Mix exact and prefix values freely. Exact: `tiktok_1,ig_bio` · Prefix: `ca1_` · Mixed: `ig_bio,ca1_,ca2_`

Rate limit: 600 requests / hour per API key. Remaining count returned in the RateLimit-Remaining response header and meta.requests_remaining.

Example Requests

Basic — today's stats

curl -X GET "https://yourdomain.com/api/v1/stats?range=today" \
  -H "X-Api-Key: YOUR_API_KEY"

Prefix search — all sources starting with ca1_

curl -X GET "https://yourdomain.com/api/v1/stats?range=7days&source=ca1_*" \
  -H "X-Api-Key: YOUR_API_KEY"

Custom range, filtered by country + source

curl -X GET "https://yourdomain.com/api/v1/stats?range=custom&start=2026-03-01&end=2026-03-17&country=US,GB&source=tiktok_bio&timezone=America/New_York" \
  -H "X-Api-Key: YOUR_API_KEY"

Example Response range=today, granularity=hour

HTTP 200 OK

{
  "success": true,
  "meta": {
    "range":               "today",
    "timezone":            "America/New_York",
    "granularity":         "hour",
    "period_start":        "2026-03-18T05:00:00.000Z",
    "period_end":          "2026-03-18T17:43:12.000Z",
    "generated_at":        "2026-03-18T17:43:12.418Z",
    "requests_remaining":  58,
    "filters": { "country": null, "offer": null, "source": null }
  },
  "data": {
    "summary": {
      "clicks":  214,
      "leads":   27,
      "revenue": 138.24,
      "cvr":     12.6168,
      "epc":     0.645981
    },
    "time_series": [
      { "period": "2026-03-18 00:00", "granularity": "hour", "clicks": 18, "leads": 2, "revenue": 10.40, "cvr": 11.1111, "epc": 0.577778 },
      { "period": "2026-03-18 01:00", "granularity": "hour", "clicks": 31, "leads": 5, "revenue": 26.75, "cvr": 16.1290, "epc": 0.862903 }
    ],
    "by_country": [
      { "country": "US", "clicks": 180, "leads": 24, "revenue": 125.40, "cvr": 13.3333, "epc": 0.696667 },
      { "country": "GB", "clicks": 34,  "leads": 3,  "revenue": 12.84,  "cvr": 8.8235,  "epc": 0.377647 }
    ],
    "by_source": [
      { "source": "tiktok_bio", "clicks": 141, "leads": 19, "revenue": 98.80, "cvr": 13.4752, "epc": 0.700709 },
      { "source": "Direct",     "clicks": 73,  "leads": 8,  "revenue": 39.44, "cvr": 10.9589, "epc": 0.540274 }
    ],
    "by_offer": [
      { "offer": "Freecash CPI", "clicks": 120, "leads": 16, "revenue": 88.00, "cvr": 13.3333, "epc": 0.733333 },
      { "offer": "KashKick",     "clicks": 94,  "leads": 11, "revenue": 50.24, "cvr": 11.7021, "epc": 0.534468 }
    ]
  }
}

Error Codes

Status	Meaning
200	Success
400	Bad request — invalid parameter (see `error` field)
401	Missing or invalid API key
403	Account suspended
429	Rate limit hit — check `reset_at` in response body
500	Server error — try again shortly

Chat

Your Rank

Today

Countries (0)

Traffic Sources (0)

Top Offers (0)

Recent Conversions

Link Splitters

Link A Configuration

Link B Configuration

Traffic Split

Ranks & Perks

Custom Stats Report

Daily Performance

Lead Distribution by Country

Lead Distribution by Template

Merchandise Rewards

Shipping Address (applies to all unshipped rewards)

Stats API

Your API Key

Endpoint

Authentication

Parameters

Example Requests

Example Response range=today, granularity=hour

Error Codes

Chat

Your Rank

Today

Countries (0)

Traffic Sources (0)

Top Offers (0)

Recent Conversions

Link Splitters

Link A Configuration

Link B Configuration

Traffic Split

Username

Share Stats

Ranks & Perks

Custom Stats Report

Daily Performance

Lead Distribution by Country

Lead Distribution by Template

Merchandise Rewards

Shipping Address (applies to all unshipped rewards)

Stats API

Your API Key

Endpoint

Authentication

Parameters

Example Requests

Example Response range=today, granularity=hour

Error Codes