curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
Leads & Formulare
Lead-Analysen abrufen
POST /lead/analytics/
POST
/
lead
/
analytics
/
curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
Gibt aggregierte Analysen (Eintragszahlen, Konversionsaufschlüsselung und Traffic-Quelle) für eine oder mehrere Lead-Listen zurück.
Erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota und die Berechtigung LEAD_GENERATION_ANALYTICS_CAN_VIEW, gesendet als roher Authorization-Header-Wert — siehe die Übersicht über die Management API.array
erforderlich
Ein Array von Strings, die die zu analysierenden Lead-Listen identifizieren — entweder
lead_ids oder QR-url_hashes, abhängig von filter_by.string
Standard:"lead_id"
lead_id (Standard) oder qr_hash.string
Standard:"entries_count"
Kommagetrennte Teilmenge von
entries_count, leads_conversion, source, die berechnet werden soll.string
Startdatum (
YYYY-MM-DD). Standard ist 7 Tage vor to.string
Enddatum (
YYYY-MM-DD). Standard ist heute.curl --request POST \
--url 'https://api.scanova.io/lead/analytics/?type=entries_count,leads_conversion,source&from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "q": ["L9c2f4a1e"], "filter_by": "lead_id" }'
{
"entries_count": {
"total": 14,
"elevation": { "percent": 12, "previous": 12, "type": "+", "period": { "start": "2026-07-01", "end": "2026-08-01" } }
},
"leads_conversion": {
"all": [["2026-08-01", 3], ["2026-08-02", 1]],
"leads": [["2026-08-01", 2], ["2026-08-02", 1]],
"skip": [["2026-08-01", 1], ["2026-08-02", 0]]
},
"source": [["Booth QR", 9.0], ["Flyer QR", 5.0]]
}
elevation ist null, wenn sowohl der angeforderte Zeitraum als auch sein vorheriger Vergleichszeitraum null Einträge haben, um einen irreführenden Prozentsatz zu vermeiden. 400 unter q, wenn es fehlt oder leer ist — der Vertrag dieses Endpunkts lautet {"q": [...], "filter_by": "..."}, nicht {"lead_list": [...], "date_from": "...", "date_to": "..."} aus einer älteren, inkompatiblen Form.
Verwandte Themen
- Lead-Analysen exportieren — dieselben Aufschlüsselungen als Datei herunterladen.
- Lead-Listen auflisten —
lead_id-Werte zur Analyse finden. - Übersicht über die Management API — das Authentifizierungsschema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Antwort
200
Aggregated analytics for the requested lead lists.
War diese Seite hilfreich?