Click-Level Conversion Report
Publisher APIThe Click-Level Conversion Report API is an HTTP POST endpoint on statsapi.pubadhub.com. Partners pass report filters as form data and authenticate using an AccessKey request header. PubAdHub returns a JSON object containing a data array of click-level conversion records and pagination details. The date range between start_date and end_date must not exceed 2 days.
https://statsapi.pubadhub.com
/api/reporting/clicklevel
Authentication
Authenticate each request by including an AccessKey in the HTTP request headers. Replace {AccessKey} with a valid access key provided by your Account Manager.
AccessKey: {AccessKey}
Headers
AccessKey
REQUIRED
{AccessKey}
Replace {AccessKey} with a valid access key provided by your Account Manager.
| Name | Value | Required | Description |
|---|---|---|---|
| AccessKey | {AccessKey} | REQUIRED | Replace {AccessKey} with a valid access key provided by your Account Manager. |
Request Body
Request body (form data). Required: start_date, end_date. Optional: page (default 1). Date format: YYYY-MM-DD. Maximum date range: 2 days.
start_date
Location: form
Start date for the report in YYYY-MM-DD format. The selected date range between start_date and end_date must not exceed 2 days.
Example: YYYY-MM-DD
end_date
Location: form
End date for the report in YYYY-MM-DD format. The API supports a maximum date range of 2 days per request.
Example: YYYY-MM-DD
page
Location: form
Optional. Page number used to retrieve paginated report data. If omitted, page 1 is returned.
Example: 1
Default: 1
| Name | Type | Required | Location | Description | Example | Default |
|---|---|---|---|---|---|---|
| start_date | String | REQUIRED | form | Start date for the report in YYYY-MM-DD format. The selected date range between start_date and end_date must not exceed 2 days. | YYYY-MM-DD | |
| end_date | String | REQUIRED | form | End date for the report in YYYY-MM-DD format. The API supports a maximum date range of 2 days per request. | YYYY-MM-DD | |
| page | Number | OPTIONAL | form | Optional. Page number used to retrieve paginated report data. If omitted, page 1 is returned. | 1 | 1 |
API format
https://statsapi.pubadhub.com/api/reporting/clicklevelRequest example
POST /api/reporting/clicklevel HTTP/1.1
Host: statsapi.pubadhub.com
AccessKey: {AccessKey}
Content-Type: application/x-www-form-urlencoded
start_date=YYYY-MM-DD&end_date=YYYY-MM-DD&page=1Response
JSON object with a data array of click-level conversion records and pagination fields (page, limit, total_records, total_pages). HTTP status code: NEEDS_REVIEW (not specified in the PDF).
{
"data": [
{
"click_id": "643646346hhffh",
"revenue": "0.20",
"click_date": "2025-03-17"
},
{
"click_id": "643646346hhHHA",
"revenue": "0.40",
"click_date": "2025-03-17"
},
{
"click_id": "Test990",
"revenue": "0.25",
"click_date": "2025-03-17"
}
],
"page": 1,
"limit": 1000,
"total_records": 5,
"total_pages": 1
}Response fields
click_id
String
Unique click ID provided by the publisher.
Example: 643646346hhffh
revenue
String
Revenue generated from the click, shown in USD.
Example: 0.20
click_date
String
Date of the click in YYYY-MM-DD format.
Example: 2025-03-17
page
Number
Current page number returned in the response.
Example: 1
limit
Number
Number of records returned per page. The default limit is 1000 records.
Example: 1000
Default: 1000
total_records
Number
Total number of records available across all pages.
Example: 5
total_pages
Number
Total number of pages available for the requested report.
Example: 1
| Name | Type | Description | Example | Default |
|---|---|---|---|---|
| click_id | String | Unique click ID provided by the publisher. | 643646346hhffh | |
| revenue | String | Revenue generated from the click, shown in USD. | 0.20 | |
| click_date | String | Date of the click in YYYY-MM-DD format. | 2025-03-17 | |
| page | Number | Current page number returned in the response. | 1 | |
| limit | Number | Number of records returned per page. The default limit is 1000 records. | 1000 | 1000 |
| total_records | Number | Total number of records available across all pages. | 5 | |
| total_pages | Number | Total number of pages available for the requested report. | 1 |
Notes
Original PDF
This page is sourced from the official API PDF. The original file remains available.
Click-Level Conversion Report.pdf