Bulk-Enrichment und Ergebnisabruf

enrichment.start akzeptiert 1–100 unabhängige Elemente pro Anfrage über POST /api/v1/operations/enrichment.start. MCP-Clients nutzen enrichment_start mit denselben Argumenten. Jedes Element enthält eine eindeutige id, bekannte Fakten in input, eine question und ein typisiertes output. Fragen und Ergebnistypen dürfen sich innerhalb eines Batches unterscheiden.

Die Antwort enthält batchId und jobs; eine Annahme bedeutet noch keine abgeschlossenen Aufträge oder Treffer für jedes Element. Behalte deine Datensatz-ID in der Element-ID, damit du Antworten wieder zuordnen kannst. Liegen Daten als CSV vor, kann deine Anwendung oder dein KI-Client die Zeilen ohne App-Import in Elemente überführen.

Geschäftliche E-Mails und direkte Telefonnummern gemeinsam anfragen

Das Beispiel reicht vier Elemente ein: je eine E-Mail- und Telefonanfrage für zwei Personen. Ersetze CONTACT_ONE und CONTACT_TWO durch die tatsächlichen beruflichen Profile, die du recherchieren möchtest, hinterlege LEADBASE_API_KEY in deiner Shell und wähle einen stabilen Schlüssel für diesen Batch. Die Ausführung startet möglicherweise kostenpflichtige Recherche.

curl https://www.leadbase.io/api/v1/operations/enrichment.start \  -H "x-api-key: $LEADBASE_API_KEY" \  -H 'Content-Type: application/json' \  --data-binary @- <<'JSON'{  "idempotencyKey": "contact-pilot-001",  "items": [    {      "id": "contact-1-email",      "input": {        "profileUrl": "https://www.linkedin.com/in/CONTACT_ONE"      },      "question": "Finde die geschäftliche E-Mail-Adresse der Person mit diesem beruflichen Profil.",      "output": {        "type": "email"      }    },    {      "id": "contact-1-phone",      "input": {        "profileUrl": "https://www.linkedin.com/in/CONTACT_ONE"      },      "question": "Finde eine direkte Telefonnummer der Person mit diesem beruflichen Profil.",      "output": {        "type": "phone"      }    },    {      "id": "contact-2-email",      "input": {        "profileUrl": "https://www.linkedin.com/in/CONTACT_TWO"      },      "question": "Finde die geschäftliche E-Mail-Adresse der Person mit diesem beruflichen Profil.",      "output": {        "type": "email"      }    },    {      "id": "contact-2-phone",      "input": {        "profileUrl": "https://www.linkedin.com/in/CONTACT_TWO"      },      "question": "Finde eine direkte Telefonnummer der Person mit diesem beruflichen Profil.",      "output": {        "type": "phone"      }    }  ]}JSON

E-Mail- und Telefonergebnisse sind Arrays mit zurückgegebenen Werten. Ein leeres Array ist kein gelieferter Kontakt. Zwei Elemente pro Person erlauben getrennte Fragen, Status- und Kostenberichte: Ein Batch fasst 50 Personen mit beiden Feldern oder 100 Personen mit jeweils einem Feld. Teile größere Mengen in weitere Batches mit eigenen Schlüsseln und IDs auf. Jeder Eingabewert darf ein String, eine Zahl, ein boolescher Wert oder null sein; ergänze relevante bekannte Namen, Firma und Domain.

Leadbase verbindet die Identitätsrecherche und Quellenauswahl im selben Batch-Workflow. Unter Kontaktdaten findest du passende Identifikatoren und Beispielfragen für nutzbare Ergebnisse.

Denselben Batch abrufen

curl https://www.leadbase.io/api/v1/operations/enrichment.get \  -H "x-api-key: $LEADBASE_API_KEY" \  -H 'Content-Type: application/json' \  -d '{"batchId":"BATCH_ID_FROM_START"}'

Ersetze den Platzhalter durch die zurückgegebene UUID. Rufe in MCP enrichment_get mit derselben batchId auf. Die Antwort enthält Aufträge mit jobId, itemId, status, result, errorCode, billingStatus und credits. Ergebnisse stehen in result.value, Erklärungen in result.summary und Quellen in result.sources.

Frage mit angemessenem Abstand und zunehmenden Pausen ab, solange Aufträge queued oder running sind. Bei completed, failed oder cancelled ist die Ausführung beendet. Ein abgeschlossener Auftrag mit leerem E-Mail- oder Telefonarray hat diesen Kontakt nicht geliefert. Prüfe jeden Auftrag einzeln und verfolge pending oder reconciliation_pending weiter. Melde endgültige Kosten erst nach dem Abgleich; credits: null bedeutet unbekannt, nicht null Kosten.

Kontakte in einem vorhandenen Sheet anreichern

Rufe für gespeicherte Zeilen sheets_enrich in MCP oder POST /api/v1/operations/sheets.enrich über HTTP auf. Nutze column: {"columnId":"COLUMN_UUID"} für eine konfigurierte Spalte oder column: {"name":"Geschäftliche E-Mail","question":"Finde die geschäftliche E-Mail-Adresse dieser Person.","type":"email"} für eine neue. Die vollständige Anfrage benötigt zusätzlich sheetId und idempotencyKey. Übergib rowIds für eine Teilmenge; lasse sie nur für alle vorhandenen Zeilen weg, bis zu 10.000. Gefüllte und aktive Zellen werden übersprungen.

E-Mail und Telefon sind getrennte Spalten und getrennte Anfragen mit eigenen Wiederholungsschlüsseln. Prüfe Fortschritt, gespeicherte Werte und Belege mit sheets_get_enrichment_status und sheets_query. Die entsprechenden HTTP-Operationen verwenden Punkte. Für den Sheet-Ablauf gelten eigene Zielgrenzen; die Grenze von 100 Elementen oben gehört zu enrichment.start.

Wiederaufnehmen, ohne neue kostenpflichtige Arbeit zu erzeugen

Speichere vor dem Versand den vollständigen Start-Body und idempotencyKey. Geht die Antwort verloren, rufe den Auftrag mit identischem Body und demselben Schlüssel wieder auf. Erzeuge zur Wiederaufnahme keinen neuen Schlüssel. Eine neue Frage, Eingabe oder ein bewusst neuer Batch braucht einen neuen Schlüssel.

Beachte die JSON-Body-Grenze von 1 MiB und erhöhe die Menge anhand beobachteter Geschwindigkeit und Kosten. Batchgröße, Anfragerate und gleichzeitige Ausführung sind unterschiedliche Grenzen; 100 eingereichte Elemente müssen nicht gleichzeitig starten. Siehe Activity und Credits.