API

Overview

The Trcker API lets you programmatically manage offers, partners, conversions, and reports. Use it to integrate Trcker into your existing workflows, build custom dashboards, or automate partner management.

Authentication

All API requests require an API key passed in the Authorization header:

` Authorization: Bearer YOUR_API_KEY `

You can generate an API key from Settings then API Keys in your dashboard. Treat your API key like a password — do not expose it in client-side code or public repositories.

Base URL

All endpoints use the following base URL:

` https://app.trcker.io/api/v1 `

Available endpoints

Offers

• GET /offers — List all offers for the current brand
• POST /offers — Create a new offer

Partners

• GET /partners — List all partners
• GET /partners/:id — Get a specific partner's details

Conversions

• POST /conversions — Record a conversion (server-side postback)
• GET /conversions — List conversions with optional filters

Reports

• GET /reports — Pull report data with filters for date range, offer, partner, and grouping

Example request

`bash curl -X GET https://app.trcker.io/api/v1/offers \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" `

Rate limiting

API requests are limited to 100 requests per minute per API key. If you exceed this limit, the API returns a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait.

Error responses

All errors follow a consistent format:

`json { "error": { "code": "rate_limit_exceeded", "message": "You have exceeded the rate limit. Try again in 30 seconds." } } `

Common error codes:

• 401 — Invalid or missing API key
• 404 — Resource not found
• 422 — Validation error (check the message field for details)
• 429 — Rate limit exceeded

What is next

A full interactive API reference with request/response examples for every endpoint is coming soon. In the meantime, if you have questions about a specific endpoint, reach out to support.