Get Impressions Report

POST /networks/reporting/impressions/stream

Get Impressions Report

cURL

curl --request POST \
  --url https://api.eflow.team/v1/networks/reporting/impressions/stream \
  --header 'Content-Type: application/json' \
  --header 'X-Eflow-Api-Key: <api-key>' \
  --data '
{
  "from": "2026-03-01",
  "to": "2026-03-08",
  "timezone_id": 90
}
'

200

{
  "impressions": [
    {
      "transaction_id": "<string>",
      "unix_timestamp": 123,
      "is_unique": 123,
      "tracking_url": "<string>",
      "url": "<string>",
      "source_id": "<string>",
      "sub1": "<string>",
      "sub2": "<string>",
      "sub3": "<string>",
      "sub4": "<string>",
      "sub5": "<string>",
      "sub6": "<string>",
      "sub7": "<string>",
      "sub8": "<string>",
      "sub9": "<string>",
      "sub10": "<string>",
      "user_ip": "<string>",
      "referer": "<string>",
      "payout": 123,
      "payout_type": "<string>",
      "revenue": 123,
      "revenue_type": "<string>",
      "error_code": 123,
      "error_message": "<string>",
      "error_filter_id": "<string>",
      "is_view_through": true,
      "is_test_mode": true,
      "is_async": true,
      "is_sdk_click": true,
      "is_pass_through": true,
      "has_conversion": true,
      "creative_id": 123,
      "currency_id": "<string>",
      "coupon_code": "<string>",
      "idfa": "<string>",
      "idfa_md5": "<string>",
      "idfa_sha1": "<string>",
      "google_ad_id": "<string>",
      "google_ad_id_md5": "<string>",
      "google_ad_id_sha1": "<string>",
      "android_id": "<string>",
      "android_id_md5": "<string>",
      "android_id_sha1": "<string>",
      "category_id": 123,
      "project_id": "<string>",
      "previous_network_offer_id": 123,
      "custom_landing_page_id": 123,
      "redirect_method": "<string>",
      "server_side_url": "<string>",
      "server_side_output": "<string>",
      "relationship": {
        "offer": {
          "network_offer_id": 123,
          "network_id": 123,
          "network_advertiser_id": 123,
          "network_offer_group_id": 123,
          "network_tracking_domain_id": 123,
          "name": "<string>",
          "offer_status": "<string>",
          "visibility": "<string>",
          "currency_id": "<string>"
        },
        "affiliate": {
          "network_affiliate_id": 123,
          "network_id": 123,
          "network_traffic_source_id": 123,
          "name": "<string>",
          "account_status": "<string>"
        },
        "advertiser": {
          "network_advertiser_id": 123,
          "network_id": 123,
          "name": "<string>",
          "account_status": "<string>"
        },
        "account_manager": {
          "network_employee_id": 123,
          "network_id": 123,
          "first_name": "<string>",
          "last_name": "<string>",
          "full_name": "<string>",
          "account_status": "<string>"
        },
        "affiliate_manager": {
          "network_employee_id": 123,
          "network_id": 123,
          "first_name": "<string>",
          "last_name": "<string>",
          "full_name": "<string>",
          "account_status": "<string>"
        },
        "geolocation": {
          "country_code": "<string>",
          "country_name": "<string>",
          "region_code": "<string>",
          "region_name": "<string>",
          "city_name": "<string>",
          "postal_code": "<string>",
          "dma": 123,
          "dma_name": "<string>",
          "timezone": "<string>",
          "isp_name": "<string>",
          "organization": "<string>",
          "carrier_code": "<string>",
          "carrier_name": "<string>",
          "is_mobile": true,
          "is_proxy": true
        },
        "device_information": {
          "platform_name": "<string>",
          "browser_name": "<string>",
          "browser_version": "<string>",
          "device_type": "<string>",
          "model": "<string>",
          "brand": "<string>",
          "os_version": "<string>",
          "language": "<string>",
          "http_accept_language": "<string>",
          "is_mobile": true,
          "is_tablet": true,
          "is_robot": true,
          "is_filter": true
        },
        "forensiq_score": "<string>",
        "http_accept_language": "<string>",
        "query_parameters": {}
      }
    }
  ]
}

Extract raw impressions. Max 10,000 per request, 14-day date range limit. Requires Impressions package. Raw data retained 3 months.

Exceeding the 14-day limit returns 200 with {"table": []}, not an error — indistinguishable from a period that genuinely has no impressions. With date-only values to is the end of that day, so the range must span at most 14 calendar days inclusive.

The response array is named impressions when there are rows and table when empty — read both. The 10,000-impression limit truncates silently; if a request returns exactly 10,000 rows, narrow the range and page through.

Authorizations

X-Eflow-Api-Key · string · header · required

The Everflow API key generated from the Control Center > Security.

Body

application/json

from · string · required

Start date in YYYY-MM-DD HH:MM:SS format.

to · string · required

End date in YYYY-MM-DD HH:MM:SS format.

timezone_id · integer · required

Timezone identifier.

query · object

Show child attributes

Response

200 - application/json

impressions · object[]

Array of impression records. NOTE: this key is named impressions on a populated response; the endpoint emits table only when the result set is empty ({"table": []}). Handle both.

Show child attributes