GET
/
public
/
v1
/
reporting-service
/
interactions
{
  "hasMore": true,
  "interactions": [
    {
      "adSpentAttributedPurchases": 123,
      "adSpentClicks": 123,
      "adSpentExclusiveCampaign": 123,
      "adSpentImpressions": 123,
      "campaignId": "<string>",
      "chargedAttributedPurchases": 123,
      "chargedClicks": 123,
      "chargedImpressions": 123,
      "clicks": 123,
      "impressions": 123,
      "productId": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "totalPurchaseAmount": 123,
      "totalPurchaseCount": 123,
      "totalPurchaseQuantity": 123,
      "vendorId": "<string>"
    }
  ],
  "nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}

Authorizations

Authorization
string
header
required

A valid API key generated in Topsort's UI.

Query Parameters

start_date
string<date-time>
required

The start date for which reports will be generated, specified in RFC 3339.

end_date
string<date-time>
required

The end date for which reports will be generated, specified in RFC 3339.

limit
integer
default:1000

The pagination limit.

Required range: 0 <= x <= 1000
group_by
enum<string>

How to group the results (vendor, campaign, or product).

Available options:
vendor,
campaign,
product
granularity
enum<string>

The time granularity of the report (daily or hourly).

Available options:
daily,
hourly
next_page
string

Pagination cursor as provided in an earlier response. If provided will fetch the next page of results.

Response

Successful Response

Unified response model for both daily and hourly interactions reports.

Contains a list of interaction entries, each representing detailed metrics for a specific entity (vendor, campaign, or product) at a given timestamp. The response is paginated to handle large datasets.