GET /admin/offerClicks  API documentation

Get the list of clicks (similar to the clicks log) with optional filters.

GET https://demo.trafficmanager.com/api/v1/admin/offerClicks/{startTime}/{endTime}/?fields={fields}

Authentication:

The request must be authenticated with the following HTTP headers:

• x-api-key: Your API key, found on the Security page
• x-user-id: Your User ID, found on the Security page

GET Parameters:

• Required:
• startTime: Start time. Unix timestamp or any value accepted by strtotime. For example: 2023-01-01, today, -10 minutes...
• endTime: End time. Unix timestamp or any value accepted by strtotime. For example: 2023-01-01 23:59:59, today 23:59:59, -5 minutes...
• fields: comma-separated list of the fields to be returned. See below.
• Optional:
• user_id: affiliate ID filter
• offer_id: offer ID filter
• utm_source: UTM source value filter
• utm_medium: UTM medium value filter
• utm_campaign: UTM campaign value filter
• utm_term: UTM term value filter
• utm_content: UTM content value filter
• UTM filter matching uses the platform's standard case- and accent-insensitive comparison. Values are limited to the configured UTM storage length (100 characters by default). Multiple UTM filters are combined with AND logic.
• clickid: clickid. If this value is set, all the other filters will be ignored. With this filter, the API will return only one result, or none.
• limit: maximum number of results. If greater than 100000, it will be set to 100000. Default: 10000
• offset: first row of the dataset to return. For example, to retrieve the “3th page” of records (records 101 - 150) where you are using limit to page 50 records at a time, you’d ask for an offset of 100. Default: 0.
• csv: if set, the response will be returned in CSV format instead of JSON

Returned values:

• The returned values depend on the selected fields. See below.

Fields:

• By using the fields parameter, you can select which fields you want to receive in the response. The following ones are available:
• timestamp: date and time of the click
• clickid: TrafficManager clickid
• user_id: ID of the affiliate
• username: Username of the affiliate
• offer_id: ID of the offer
• offer_name: name of the offer
• lp_id: ID of the offer landing page
• cc: country code
• ip: full IPv4 or IPv6
• device_id: device ID (see this reference table)
• subid: parameter passed by the affiliate in the tracking link
• subid2: parameter passed by the affiliate in the tracking link
• subid3: parameter passed by the affiliate in the tracking link
• subid4: parameter passed by the affiliate in the tracking link
• pubid: parameter passed by the affiliate in the tracking link
• utm_source: parameter passed by the affiliate in the tracking link
• utm_medium: parameter passed by the affiliate in the tracking link
• utm_campaign: parameter passed by the affiliate in the tracking link
• utm_term: parameter passed by the affiliate in the tracking link
• utm_content: parameter passed by the affiliate in the tracking link

Request example

GET https://demo.trafficmanager.com/api/v1/admin/offerClicks/2026-01-01/yesterday 23:59:59/?fields=timestamp,offer_id,user_id,clickid,subid2&limit=5

Response example

[
    {
        "timestamp": "2026-09-04 10:51:00",
        "offer_id": "8",
        "user_id": "2",
        "clickid": "DEV0F212727A8310BC62106235091029B9D",
        "subid2": "fb"
    },
    {
        "timestamp": "2026-09-04 10:48:11",
        "offer_id": "8",
        "user_id": "2",
        "clickid": "DEV9D15DFAE356DD7F937A7F37723DB3A3D",
        "subid2": "insta"
    },
    {
        "timestamp": "2026-09-04 10:22:24",
        "offer_id": "8",
        "user_id": "2",
        "clickid": "DEVC49B6CA6C7EC6DB1703C370BCFBBB0B4",
        "subid2": null
    },
    {
        "timestamp": "2026-09-04 09:51:35",
        "offer_id": "5",
        "user_id": "2",
        "clickid": "DEVC34AF1F2B0D1ECF98E0C30DF4A11C94E",
        "subid2": null
    },
    {
        "timestamp": "2026-09-04 09:06:49",
        "offer_id": "8",
        "user_id": "2",
        "clickid": "DEV296A982D650C7EAC9A287EB64263AB5E",
        "subid2": null
    }
]
    

---

CSV

You can also get the response in CSV instead of JSON. Simply add csv=1 as a GET parameter.

Request example:

GET https://demo.trafficmanager.com/api/v1/admin/offerClicks/2026-01-01/yesterday 23:59:59/?fields=timestamp,offer_id,user_id,clickid,subid2&limit=10&csv=1

Response example:

timestamp,offer_id,user_id,clickid,subid2
"2026-09-04 10:51:00",8,2,DEV0F212727A8310BC62106235091029B9D,fb
"2026-09-04 10:48:11",8,2,DEV9D15DFAE356DD7F937A7F37723DB3A3D,insta
"2026-09-04 10:22:24",8,2,DEVC49B6CA6C7EC6DB1703C370BCFBBB0B4,
"2026-09-04 09:51:35",5,2,DEVC34AF1F2B0D1ECF98E0C30DF4A11C94E,
"2026-09-04 09:06:49",8,2,DEV296A982D650C7EAC9A287EB64263AB5E,
"2026-09-04 09:06:34",8,2,DEV6E3ED8F031E8E85D04B3112950DA7800,
"2026-09-03 10:57:33",8,2,DEVD4D16CDD8388E53BCF0269B523C782D0,
"2026-09-03 10:57:17",8,2,DEV1145E7DCF77F918409D418F470E4FF8D,
"2026-09-03 09:05:32",7,2,DEVE74203BA56BE3BB5CD72A0B595C48B44,