Events & ExportProperty discovery

Property discovery

Every event-property and person-property key observed for the location, with an inferred value type, a masked sample value, occurrence and distinct-entity counts, and first/last-seen timestamps. Built for destination field mapping (property_mapping, custom_data_mapping, webhook profile. tokens, Google Ads value_property) so those fields can be chosen from real data instead of typed blind.

When to use it. Call this before creating a destination: mappings match on exact key names, and a key that does not exist fails quietly — the delivery succeeds with the field absent rather than raising a validation error. Filter value_type=number when picking a conversion value, since a value that is really the string "$19.99" instead of 19.99 is the common cause of a conversion recorded as zero. Use entities to tell a broken mapping from a field few visitors fill in, and order_by=first_seen / seen_since to spot keys that recently started or stopped arriving after a site or form change. It is also the discovery surface to build a field picker on.

Backed by a pre-aggregated catalog — one row per key rather than per event — so cost does not scale with event volume. For scope=event, nested objects are exploded one level deep and returned as dot-paths (form_data.email); scope=person returns top-level keys only.

Sample values are masked at ingestion: emails, phone-shaped values and known identity keys are stored as [email], [phone] or [redacted], and objects/arrays are not sampled at all (sample_value: null). Non-identifying values are returned verbatim.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/data/properties?location_id=example_string&scope=event&event=example_string&search=example_string&value_type=string&min_occurrences=42&seen_since=2024-12-25T10%3A00%3A00Z&order_by=occurrences&limit=500&offset=0" \
  -H "Content-Type: application/json" \
  -H "X-Location-Id: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "rows": 42,
  "data": [
    {
      "scope": "event",
      "event": "example_string",
      "key": "example_string",
      "value_type": "example_string",
      "sample_value": "example_string",
      "occurrences": 42,
      "entities": 42,
      "first_seen": "2024-12-25T10:00:00Z",
      "last_seen": "2024-12-25T10:00:00Z"
    }
  ]
}
GET
/properties
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.
query
location_idstring

Alternative to the X-Location-Id header for agency (ak_) keys. Ignored for secret (sk_) keys.

query
scopestring

Restrict to event properties or person properties. Omit for both.

Options: event, person
query
eventstring

Restrict scope=event rows to a single event name.

query
value_typestring

Filter by inferred value type. Use number to find value fields.

Options: string, number, boolean, object, array, null
query
min_occurrencesinteger

Drop keys seen fewer than N times.

Min: 0
query
seen_sincestring

Only keys seen at or after this datetime — hides fields that no longer arrive.

Format: date-time
query
order_bystring

Result ordering.

Options: occurrences, key, last_seen, first_seen
query
limitinteger
Min: 1 • Max: 1000
header
X-Location-Idstring

Location to scope the request to. Required for agency (ak_) keys on the event routes. Ignored for secret (sk_) keys, which resolve their own location, and not used by /export.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key (ak_) or location secret key (sk_) as a bearer token. Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need the read scope of the family the route belongs to (people, events, sessions, replays, exceptions, heatmaps or bigquery_export). See Using an mcp_ key over HTTP.

Query Parameters

location_idstring

Alternative to the X-Location-Id header for agency (ak_) keys. Ignored for secret (sk_) keys.

scopestring

Restrict to event properties or person properties. Omit for both.

Allowed values:eventperson
eventstring

Restrict scope=event rows to a single event name.

value_typestring

Filter by inferred value type. Use number to find value fields.

Allowed values:stringnumberbooleanobjectarraynull
min_occurrencesinteger

Drop keys seen fewer than N times.

seen_sincestring

Only keys seen at or after this datetime — hides fields that no longer arrive.

order_bystring

Result ordering.

Allowed values:occurrenceskeylast_seenfirst_seen

Headers

X-Location-Idstring

Location to scope the request to. Required for agency (ak_) keys on the event routes. Ignored for secret (sk_) keys, which resolve their own location, and not used by /export.

Responses

successboolean
rowsinteger
dataarray