const API_KEY  = 'YOUR_API_KEY';
const BASE_URL = 'https://taprain.com/api/offers/developer';

/**
 * Fetch offers with optional filters.
 * @param {Object} filters  - { countries, devices, search, type, limit, offset, domain }
 */
async function getOffers(filters = {}) {
  const params = new URLSearchParams(
    Object.fromEntries(Object.entries(filters).filter(([, v]) => v !== undefined && v !== ''))
  );
  const res = await fetch(`${BASE_URL}/offers?${params}`, {
    headers: { 'X-API-Key': API_KEY }
  });
  if (!res.ok) throw new Error(`API error ${res.status}: ${await res.text()}`);
  return res.json();
}

// ── Usage examples ────────────────────────────────────────────

// All approved offers
const { total, offers } = await getOffers();
console.log(`${total} offers available`);

// US Android CPI only
const cpiUS = await getOffers({ countries: 'US', devices: 'android', type: 'cpi' });

// All FreeCash variants
const freecash = await getOffers({ search: 'freecash' });
freecash.offers.forEach(o =>
  console.log(`${o.name}  $${o.payout}  ${o.tracking_url}`)
);

// Fetch all pages (full list)
async function getAllOffers(filters = {}) {
  const all = [];
  let offset = 0;
  while (true) {
    const page = await getOffers({ ...filters, limit: 200, offset });
    all.push(...page.offers);
    if (!page.has_more) break;
    offset += 200;
  }
  return all;
}

import requests

API_KEY  = "YOUR_API_KEY"
BASE_URL = "https://taprain.com/api/offers/developer"
HEADERS  = {"X-API-Key": API_KEY}


def get_offers(**filters) -> dict:
    """Fetch offers with optional keyword filters."""
    resp = requests.get(f"{BASE_URL}/offers", params=filters, headers=HEADERS, timeout=15)
    resp.raise_for_status()
    return resp.json()


# ── Usage examples ────────────────────────────────────────────

# All approved offers
data = get_offers()
print(f"{data['total']} offers available")

# US Android CPI offers only
cpi = get_offers(countries="US", devices="android", type="cpi")
for offer in cpi["offers"]:
    print(f"{offer['name']:30s}  ${offer['payout']:.2f}  {offer['tracking_url']}")

# Search: all FreeCash variants
freecash = get_offers(search="freecash")
print(f"FreeCash variants found: {freecash['total']}")

# Offers available in Germany on iOS
de_ios = get_offers(countries="DE", devices="ios")


def get_all_offers(**filters) -> list:
    """Paginate through the full offer catalogue."""
    all_offers, offset = [], 0
    while True:
        page = get_offers(limit=200, offset=offset, **filters)
        all_offers.extend(page["offers"])
        if not page["has_more"]:
            break
        offset += 200
    return all_offers

<?php

define('TAPRAIN_API_KEY',  'YOUR_API_KEY');
define('TAPRAIN_BASE_URL', 'https://taprain.com/api/offers/developer');

function taprain_get_offers(array $filters = []): array {
    $url = TAPRAIN_BASE_URL . '/offers';
    if ($filters) $url .= '?' . http_build_query($filters);

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_HTTPHEADER     => [
            'X-API-Key: '   . TAPRAIN_API_KEY,
            'Accept: application/json',
        ],
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($code !== 200) {
        throw new RuntimeException("API error HTTP $code: $body");
    }
    return json_decode($body, true);
}

// All approved offers
$data = taprain_get_offers();
echo "{$data['total']} offers available\n";

// US + GB CPI on Android
$cpi = taprain_get_offers(['countries' => 'US,GB', 'devices' => 'android', 'type' => 'cpi']);
foreach ($cpi['offers'] as $offer) {
    echo "{$offer['name']}  \${$offer['payout']}  {$offer['tracking_url']}\n";
}

// Search: all TesterUp variants
$tu = taprain_get_offers(['search' => 'testerup']);

// Paginate through everything
function taprain_get_all_offers(array $filters = []): array {
    $all = []; $offset = 0;
    do {
        $page = taprain_get_offers(array_merge($filters, ['limit' => 200, 'offset' => $offset]));
        $all  = array_merge($all, $page['offers']);
        $offset += 200;
    } while ($page['has_more']);
    return $all;
}