Agenten-API
Eine Verbindung. Jede Aktion, die deine Liste bietet.
REST und MCP auf demselben Token. Ein GET liefert Spalten, Typen, erlaubte Aktionen und Filterbedingungen. Ein Agent arbeitet mit der echten Struktur statt mit Dokumentation.
Selbstbeschreibend
GET auf die Verbindung liefert Schema, Aktionen, Bedingungen und Limits.
MCP & REST
Claude, ChatGPT oder jeder MCP-Client auf /mcp, jeder HTTP-Client auf /d.
Rechte
Sichtbare Spalten, beschreibbare Felder, erlaubte Aktionen und Limits, pro Verbindung.
Drei Aufrufe.
Lege eine Verbindung auf einer Liste an, kopiere den Token, und der Endpunkt erklärt deinem Agenten den Rest.
# 1. Discover what the connection exposes
curl https://listplus.ai/d/{token}
# 2. Query records with a condition-based filter
curl -X POST https://listplus.ai/d/{token} \
-H "Content-Type: application/json" \
-d '{ "action": "query",
"filter": { "email": { "condition": "disposable_email" } },
"limit": 50 }'
# 3. Fill empty job titles without touching existing values
curl -X POST https://listplus.ai/d/{token} \
-H "Content-Type: application/json" \
-d '{ "action": "update", "only_empty": true, "dry_run": true,
"records": [ { "id": "ar_000042", "job_title": "Head of RevOps" } ] }'Jeder Aufruf wird mit Aktion, Zeilen, Credits und Dauer protokolliert.
Was der Endpunkt bereitstellt.
Gruppiert nach Zweck. Jede Aktion lässt sich pro Verbindung erlauben oder sperren.
| Gruppe | Aktionen | Hinweise |
|---|---|---|
| Lesen | query, count, find, column_summary, credit_balance | 34 Filterbedingungen, z. B. c_level_executive, disposable_email, fuzzy_match |
| Schreiben | add_records, update, set_tags, set_status, send_to_pipeline, ignore, restore, create_columns | add_records bis 1.000 pro Aufruf; update unterstützt dry_run und only_empty |
| Qualität | run_checks, fix_check, clean_values, dedup_merge, derive | run_checks und clean_values sind kostenlos; derive füllt eine Spalte per KI |
| Anreichern | enrich (company, contact, person_lookup) | E-Mail und Telefon: Credits nur bei Treffer |
| Recherche | google_search, website_scrape, hackernews_search, company_lookup, twitter_search, reddit_search | Google, Scrape und Hacker News kostenlos; der Rest pro Aufruf |
Die Verbindung entscheidet, nicht der Prompt.
Einstellungen pro Verbindung. Presets: Read Only, Data Assistant, Enrichment, Data Collector, Full Access, Custom.
- hiddenColumns, allowedSublists
- Was der Agent lesen darf. Ausgeblendete Spalten verlassen ListPlus nie.
- writableColumns, onlyFillEmpty
- Was der Agent ändern darf, und ob gefüllte Werte geschützt sind.
- maxEnrichPerRequest, rateLimitPerMinute, expiresAt
- Volumen pro Anfrage, Anfragen pro Minute (Standard 60) und ein Ablaufdatum.
Was ein Aufruf kostet.
1 Credit ist €0,03 mit Pro oder Premium, €0,05 mit Basic. Lesen, Checks und Korrekturen sind kostenlos.
| Vorgang | Credits |
|---|---|
| query, count, find, run_checks, fix_check, clean_values | kostenlos |
| google_search, website_scrape, hackernews_search | kostenlos |
| company_lookup | 0,25 |
| twitter_search (pro 100 Tweets) | 3 |
| reddit_search | 10 |
| enrich: company | 0,25 |
| enrich: contact (Prospeo / FullEnrich) | 2 / 4 |
| enrich: person_lookup (Name + Firma) | 6 |
Der Agenten-API-Zugang ist in jedem Plan enthalten — auch im kostenlosen.
Gut zu wissen.
Brauche ich ein SDK?
Nein. Die API ist reines HTTP mit JSON. curl, Python, JavaScript oder jeder MCP-Client funktionieren. Die GET-Antwort dokumentiert die Verbindung.
Wie funktioniert die Authentifizierung?
Der Token in der URL identifiziert die Verbindung und ihre Rechte. Lege pro Liste und pro Agent einen an, setze ein Ablaufdatum und deaktiviere ihn, wenn die Aufgabe erledigt ist.
Kann ich Schreibvorgänge sicher testen?
Ja. update akzeptiert dry_run und zeigt, was sich ändern würde, ohne zu schreiben. only_empty schützt gefüllte Felder.
Welcher Plan enthält die API?
Premium. Recherche, Anreicherung und Verifizierung folgen ihren Credit-Regeln; Lesen, Checks und Korrekturen sind kostenlos.
Egal womit du startest. Du weißt, was bereit ist.
Probiere die Beispielliste oder bring deinen eigenen Startpunkt mit.