Integrate Blogur's powerful analytics and link management into your applications
The Blogur API allows you to programmatically manage your tracking links, access analytics data, and integrate our platform with your applications.
All API responses are returned in JSON format with consistent structure:
All API requests require authentication using your API key. Include your API key in the request headers:
Retrieve all your tracking links
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1) |
| limit | integer | Items per page (default: 20, max: 100) |
| advertiser | string | Filter by advertiser domain |
{
"success": true,
"data": {
"links": [
{
"id": "abc123",
"short_code": "Kx9mN2",
"original_url": "https://example.com/product",
"advertiser": "example.com",
"clicks": 245,
"created_at": "2024-01-15T10:30:00Z"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20
}
}
}Create a new tracking link
Get analytics summary for a date range
| Parameter | Type | Required | Description |
|---|---|---|---|
| start_date | date | Yes | Start date (YYYY-MM-DD) |
| end_date | date | Yes | End date (YYYY-MM-DD) |
| group_by | string | No | Group by: day, advertiser, link |
Set up webhooks to receive real-time notifications about clicks, conversions, and payments.
link.clicked - When a tracking link is clickedconversion.tracked - When a conversion is recordedpayment.processed - When a payment is processedAPI requests are limited to ensure platform stability:
| Code | Message | Description |
|---|---|---|
| 400 | Bad Request | Invalid request parameters |
| 401 | Unauthorized | Invalid or missing API key |
| 403 | Forbidden | Insufficient permissions |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error occurred |