Skip to developer documentation
Attriboo
Start free
Browse developer documentation
OpenAPI JSONFull Markdown referenceMCP tool referenceCLI command referenceHelp center

Attriboo for developers

Attriboo developer documentation

Choose REST API, MCP or CLI to read revenue reports and build with Attriboo. Find every public REST operation, MCP tool and terminal command with inputs, outputs and examples.

REST base URLhttps://www.attriboo.com/api/v1
Make your first requestOpenAPI JSONMarkdown reference
REST API

Every endpoint, authentication, pagination and cURL, JavaScript and Python examples.

MCP

Connect an assistant and explore all 15 tools, arguments and tool-call examples.

CLI

Install the official CLI and find every command, flag, environment setting and example.

Start with the right access

Reports accept a workspace API key or an approved OAuth token. Server-side event, payment and crawler writes use a workspace key. Website creation, script retrieval and verification require OAuth setup permission from a workspace owner or admin.

Authentication and scopesDates, currency and modelsErrors and rate limits

REST API endpoint reference

Paths below are relative to the REST base URL. Each page explains the accepted credential and the exact response shape. Examples use illustrative values; replace example IDs with the IDs returned by your workspace.

Websites

EndpointWhat it does
GET/sitesFind real website IDs and currencies in the authorized workspace.
POST/sitesAdd a website, or reuse its existing domain, within the workspace's current plan.
GET/sites/{site}/scriptRetrieve an installation snippet for the actual website and its saved privacy choices.
GET/sites/{site}/verificationCheck whether Attriboo has received tracking activity for this website.

Reports

EndpointWhat it does
GET/stats/overviewRead headline revenue, traffic, conversion and advertising metrics with comparison changes.
GET/stats/timeseriesRead traffic and revenue over daily, weekly, monthly or quarterly buckets.
GET/stats/sourcesCompare recorded marketing sources and their attributed revenue.
GET/stats/channelsCompare channel groups such as Organic Search, Paid Ads and AI Referral.
GET/stats/campaignsRead campaign revenue, recorded costs and return on ad spend.
GET/stats/pagesRead landing-page visits, AI referrals, crawler activity and revenue credit.
GET/stats/hostnamesGroup visitors by the hostname where they first arrived.
GET/stats/countriesRead countries audience counts, conversion and revenue.
GET/stats/citiesRead cities audience counts, conversion and revenue.
GET/stats/devicesRead devices audience counts, conversion and revenue.
GET/stats/browsersRead browsers audience counts, conversion and revenue.
GET/stats/osRead operating systems audience counts, conversion and revenue.
GET/stats/goalsRead goal completion counts and the revenue of visitors who completed each goal.
GET/stats/realtimeRead visitors active in the last five minutes.
GET/stats/salesRead recorded payments and refunds, newest first, with observed attribution details.
GET/stats/funnelsRead independent standard stages, list saved definitions, or inspect an ordered saved funnel.
GET/stats/ai-searchKeep crawler activity, referred human visitors and revenue credit separate for each AI engine.
GET/stats/time-to-purchaseGroup purchases by time since a preceding recorded entry visit.

Data collection

EndpointWhat it does
POST/eventsRecord a named goal or identify an existing browser visitor from your server.
POST/webhooks/paymentSend a normalized server-side payment with a stable provider transaction ID.
POST/crawlsReport server-observed AI crawler requests as a batch of daily bot/page/status counts.

Browser tracking

EndpointWhat it does
POST/collectThe standard tracker transport for pageviews, goals and identity calls. Prefer the official t.js installation.
POST/cookielessThe c.js transport for a website already configured for aggregate measurement.
POST/pollThe tracker transport for a post-checkout self-reported source answer.

Public resources

EndpointWhat it does
GET/changelogRead public release notes, newest first, without authentication.
GET/integrations/wordpress-pluginDownload the current WordPress plugin as attriboo.zip.

Find the supported integration path

The tracker and integration route inventory also explains dashboard-only endpoints and provider-managed callbacks. For ordinary website installation, follow the platform setup guides.

For applications, use the OAuth connection guide. For report exports and terminal workflows, use the complete CLI reference. No signup or payment-provider approval is performed silently by the API.