Export Events - Appstack

Retrieve all attributed events for your app within a given time window. Supports multiple output formats for data pipeline and analytics integrations.

Authentication

Every request must include an Authorization header containing your Appstack API key. You can find your API key in the Appstack dashboard under your app settings.

Authorization: <your-api-key>

API keys are scoped to a single app. The response will only include events for the app associated with the key.

Endpoint

GET https://data-retriever-api.appstack.tech/api/v1/export

Request

Query Parameters

timestamp

integer

required

Unix timestamp (seconds) defining the start of the export window. Returns all events from this timestamp up to the current time.Example: 1700000000

format

string

default:"json"

Output format for the response. Accepted values:

Value	Description
`json`	Structured JSON object (default)
`ndjson`	Newline-delimited JSON — one event per line
`csv`	Comma-separated values, returned as a file download
`tsv`	Tab-separated values, returned as a file download
`xml`	XML document, returned as a file download
`xlsx`	Excel workbook (.xlsx), returned as a file download
`parquet`	Apache Parquet binary, returned as a file download

Example request

curl -X GET "https://data-retriever-api.appstack.tech/api/v1/export?timestamp=1700000000&format=json" \
  -H "Authorization: <your-api-key>"

Response

For format=json, the endpoint returns a JSON object. For all other formats, the response is streamed as a file download with the appropriate Content-Disposition header.

JSON response

{
  "data": [
    {
      "event_id": "abc123",
      "event_time": "2024-11-14T12:00:00Z",
      "event_name": "appstack_purchase",
      "appstack_id": "as_xyz789",
      "media_source": "meta",
      "campaign_id": "12345678",
      "campaign_name": "iOS - Broad - US",
      "adset_id": "98765432",
      "adset_name": "Interest - Gaming",
      "ad_id": "11223344",
      "ad_name": "Video - 15s",
      "matching_type": "exact_ip",
      "click_to_first_open_hours": 2,
      "confidence_score": "high",
      "country": "US",
      "os": "ios",
      "app_id": "com.example.app",
      "app_name": "My App",
      "install_type": "new_install",
      "revenue": 9.99,
      "currency": "USD"
    }
  ],
  "total_count": 1
}

Response fields

data

array

Array of attributed events.

Show Event object

event_id

string | null

Unique identifier for the event.

event_time

string | null

ISO 8601 timestamp of when the event occurred.

event_name

string | null

Prefixed event name in the format appstack_<event>. For example: appstack_purchase, appstack_level_complete.

appstack_id

string | null

Appstack’s unique installation identifier for the device.

media_source

string | null

The ad network or source attributed to this event. Examples: meta, google, tiktok, organic.

campaign_id

string | null

ID of the attributed campaign.

campaign_name

string | null

Name of the attributed campaign.

adset_id

string | null

ID of the attributed ad set.

adset_name

string | null

Name of the attributed ad set.

ad_id

string | null

ID of the attributed ad.

ad_name

string | null

Name of the attributed ad.

matching_type

string | null

The attribution method used. Possible values: network, geo.

click_to_first_open_hours

integer | null

Number of hours between the attributed click and the user’s first app open.

confidence_score

string | null

Confidence level of the attribution match. Possible values: low, medium, high.

country

string | null

ISO 3166-1 alpha-2 country code of the user at the time of the event.

string | null

Operating system. Possible values: ios, android.

app_id

string | null

Bundle ID or package name of the app (e.g. com.example.app).

app_name

string | null

Human-readable name of the app.

install_type

string | null

iOS only. Indicates whether this was a fresh install or a reinstall. Possible values: new_install, reinstall_same_device.

revenue

number | null

Decrypted revenue amount associated with the event.

currency

string | null

ISO 4217 currency code for the revenue field (e.g. USD, EUR).

total_count

integer

Total number of events returned.

Errors

Status	Code	Description
`401`	Unauthorized	Missing or invalid `Authorization` header.
`422`	Unprocessable Entity	`timestamp` is missing, or `format` is not a valid value.
`500`	Internal Server Error	Unexpected error while fetching or building the export.

Error response shape

{
  "error": "Unauthorized",
  "detail": "Authorization header is required"
}

​Authentication

​Endpoint

​Request

​Query Parameters

​Example request

​Response

​JSON response

​Response fields

​Errors

​Error response shape

Authentication

Endpoint

Request

Query Parameters

Example request

Response

JSON response

Response fields

Errors

Error response shape