Query Beacons Records
Row-level drill-down: return individual beacons matching the filter.
Paired with /analytics/query (which aggregates). A dashboard click on an
aggregate row sends the same filters here to get the specific beacons behind
it. No metric aggregation: raw column values only, projected through the
fields whitelist.
Response is uncached (rows change every ingest). Total-count is fetched in the same round-trip via asyncio.gather so the UI knows whether pagination is worth showing.
Authentifizierung
bearerAuth API token generated from the fastmon dashboard (Account → API Token). Send as Authorization: Bearer fm_... or paste the full token (including the fm_ prefix) into the Authorize dialog.
In: header
Pfad-Parameter
uuidRequest-Body
application/json
Row-level drill-down request: individual beacons matching filters.
Response shape is row-per-beacon (no metric aggregation). Pair with /analytics/query when the user needs to go from an aggregate row to the specific beacons behind it.
Response-Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/analytics/beacons" \ -H "Content-Type: application/json" \ -d '{ "time_range": { "from": "2019-08-24T14:15:22Z", "to": "2019-08-24T14:15:22Z" } }'{ "rows": [ { "started_at": "2019-08-24T14:15:22Z", "ended_at": "2019-08-24T14:15:22Z", "session_id": "string", "stitch": "string", "pvid": "string", "url": "string", "site_id": "72771e6a-6f5e-4de4-a5b9-1266c4197811", "version": 0, "tracker_version": "string", "lifecycle": "string", "delivery_method": "string", "domain": "string", "referrer_source": "string", "referrer_medium": "string", "utm_source": "string", "utm_medium": "string", "utm_campaign": "string", "utm_term": "string", "utm_content": "string", "click_id_param": "string", "browser": "string", "browser_version": "string", "device_type": "string", "os": "string", "country": "string", "connection_type": "string", "viewport_class": "string", "lcp": 0, "fcp": 0, "cls": 0, "inp": 0, "tbt": 0, "ttfb": 0, "page_load_time": 0, "dom_interactive": 0, "start_render": 0, "content_transfer_duration": 0, "dns_lookup": 0, "tcp_connection": 0, "total_byte_weight": 0, "cache_hit_rate": 0, "cached_resources": 0, "page_cached": 0, "service_worker_active": 0, "error_count": 0, "errors": [ { "fingerprint": "string", "type": "string", "is_first_party": true, "count": 0, "sample_message": "string", "frames": [ { "host": "string", "path": "", "line": 0, "column": 0 } ], "error_class": "" } ], "slowest_resource_duration": 0, "resource_count": 0, "bfcache_hit": 0, "nav_type": "string", "protocol": "string", "lcp_element": "string", "lcp_url": "string", "cls_element": "string", "third_party_duration": 0, "third_party_count": 0, "connection_rtt": 0, "connection_downlink": 0, "visibility_dirty": 0, "prerendered": 0, "activation_delta": 0, "lcp_is_image": 0, "lcp_discovered_via": "string", "dominant_third_party_category": "string", "loaf_count": 0, "loaf_total_duration": 0, "error_origin": "string", "cdn_cache_status": "string", "origin_cache_status": "string", "edge_dur": 0, "origin_dur": 0, "backend_dur": 0, "db_dur": 0, "cache_dur": 0, "external_dur": 0, "render_dur": 0, "page_type": "string", "fetch_xhr_total_calls": 0, "fetch_xhr_total_errors": 0, "fetch_xhr_worst_ms": 0, "fetch_xhrs": [ { "method": "string", "host": "string", "path": "string", "calls": 0, "sum_ms": 0, "max_ms": 0, "errors": 0, "status_errors": { "property1": 0, "property2": 0 }, "duration_buckets": { "property1": 0, "property2": 0 }, "sync_calls": 0, "aborts": 0, "blocked": 0, "sum_bytes": 0, "max_bytes": 0, "sum_offset_ms": 0 } ], "fetch_xhr_outliers": [ { "method": "string", "host": "string", "path": "string", "duration_ms": 0, "status": 0, "ttfb_ms": 0, "server_timing": { "property1": 0, "property2": 0 } } ], "server_timing": [ { "key": "string", "dur": 0, "desc": "" } ], "loaf": [ { "script_host": "string", "script_path": "string", "invoker_type": "", "total_ms": 0, "frames": 0 } ], "third_party_by_category": { "property1": 0, "property2": 0 }, "third_parties": { "property1": 0, "property2": 0 }, "resource_counts": { "property1": 0, "property2": 0 }, "resource_sizes": { "property1": 0, "property2": 0 }, "resource_durations": { "property1": 0, "property2": 0 } } ], "total_matched": 0, "has_more": true, "execution_time_ms": 0}{ "error": { "code": "string", "message": "string", "request_id": "string", "doc_url": "string", "details": {} }}{ "error": { "code": "string", "message": "string", "request_id": "string", "doc_url": "string", "details": {} }}{ "error": { "code": "string", "message": "string", "request_id": "string", "doc_url": "string", "details": {} }}{ "error": { "code": "string", "message": "string", "request_id": "string", "doc_url": "string", "details": {} }}{ "error": { "code": "string", "message": "string", "request_id": "string", "doc_url": "string", "details": {} }}