Skip to main content
GET
/
reports
/
urls
Get reports for URLs
curl --request GET \
  --url https://api.firstpromoter.com/api/v2/company/reports/urls \
  --header 'Account-ID: <account-id>' \
  --header 'Authorization: Bearer <token>'
[
  {
    "url": "<string>",
    "id": "<string>",
    "data": {
      "clicks_count": 123,
      "revenue_amount": 123,
      "promoter_earnings_amount": 123,
      "referrals_count": 123,
      "customers_count": 123,
      "sales_count": 123,
      "refunds_count": 123,
      "cancelled_customers_count": 123,
      "referrals_to_customers_cr": 123,
      "clicks_to_customers_cr": 123,
      "clicks_to_referrals_cr": 123
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.firstpromoter.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key passed as a Bearer token in the Authorization header. You can find your API Key on Your FirstPromoter Dashboard. Navigate to Settings → Integrations → Manage API Keys

Headers

​
Account-ID
string
required

Account id. You can find your Account ID on Your FirstPromoter Dashboard. Navigate to Settings → Integrations

Example:

"acc_123456"

Query Parameters

​
columns
enum<string>[]
required
Available options:
clicks_count,
revenue_amount,
promoter_earnings_amount,
referrals_count,
customers_count,
sales_count,
refunds_count,
cancelled_customers_count,
referrals_to_customers_cr,
clicks_to_customers_cr,
clicks_to_referrals_cr,
url
​
q
string
​
group_by
enum<string>
required
Available options:
day,
week,
month,
year
​
start_date
string<date-time>
required
​
end_date
string<date-time>
required
​
sorting
object

Response

Successful response

​
url
string
​
id
string
​
data
object