Query events (web_event)

get

https://api.delivr.ai/api/v3/events/web_event

Base event columns only, with no identity resolution. The cheapest tier, and the one to use for volume, scoping and trend work.

Bills the web_event meter. The route fixes both the price and the field set, so what a call costs is legible before you make it.

Selecting a field above this tier is rejected with a 400 naming the field and the tier that carries it, rather than being silently dropped or silently billed higher. Call this tier's /schema route to see exactly which fields it admits: the allowed set is derived from the event schema and the billing catalogue, so a field that becomes billable leaves the cheaper tiers automatically.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

source

string

enum

Defaults to pixel

Event source type: pixel or dsp. Defaults to pixel if omitted.

Allowed:

pixel_id

string

Pixel identifier. Use with source=pixel.

project_id

string

Project identifier. Queries all pixels in the project (source=pixel). Also required alongside campaign_id for Bearer token auth (source=dsp).

campaign_id

string

Campaign identifier. Use with source=dsp. Bearer token auth requires project_id alongside campaign_id.

start_ms

int64

Inclusive start timestamp in milliseconds since epoch.

end_ms

int64

Inclusive end timestamp in milliseconds since epoch.

limit

integer

≥ 1

Maximum number of rows to return.

offset

integer

≥ 0

Number of rows to skip before returning results.

select

string

Comma-separated column list to project specific fields.

filter

string

Filter expression using <field>:<op>:<value> syntax.

distinct

string

Comma-separated list of fields to deduplicate the result set.

include_cold

boolean

Defaults to false

When true, also read date partitions older than the event store's local retention window from cold storage (S3), and allow a longer time window. Works for any source (pixel or dsp). Off by default.

Responses

400

Invalid query, or a select naming a field above this tier.

401

Missing or invalid API key.

500

Query failed.

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Matching events, projected to this tier.