Zum Hauptinhalt springen
POST
/
phone
/
bulk
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'
{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}
POST
https://api.enrow.io/phone/bulk
Führen Sie mehrere Telefonsuchen in einer einzigen Anfrage aus. Bis zu 3.000 Suchen pro Batch. Authentifizieren Sie jede Anfrage mit Ihrem API-Schlüssel im x-api-key-Header. Um eine einzelne Telefonnummer zu finden, verwenden Sie den Endpunkt Telefonnummer finden. Jede Suche muss eines der folgenden Elemente enthalten:
  • Die URL des LinkedIn-Profils einer Person (z. B. https://www.linkedin.com/in/michael-scott/)
  • Die Kombination aus individuellen Informationen: firstname + lastname + (company_name oder company_domain)
Die LinkedIn-URL hat immer Vorrang vor den individuellen Informationen, falls beide vorhanden sind.

Request Body

searches
array of objects
erforderlich
Such-Payloads, für die die entsprechenden Telefonnummern gefunden werden sollen.
custom
object
Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.
settings
object
Einstellungen, die sich auf die gesamte Bulk-Suche beziehen.

Response

201 — Bulk-Suche erstellt

message
string
Bestätigungsnachricht
id
string
Eindeutige Kennung für diesen Batch. Verwenden Sie sie, um die Ergebnisse über den GET-Endpunkt abzurufen.
credits_used
number
Insgesamt verbrauchte Credits. Siehe Credits & Abrechnung für die Kosten pro Endpunkt.
estimated_duration
number
Geschätzte Verarbeitungszeit in Minuten (nicht garantiert)
credits
object
Credit-Aufschlüsselung

Fehlerantworten

CodeMessage
400At least 1 phone search must be present in the payload
400Missing payload
400Too many searches. Limit is currently at 3000 per batch.
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
Wenn nicht genügend Credits vorhanden sind, gibt der Bulk-Endpunkt HTTP 402 mit einem Body der Form { "message": "..." } zurück. Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.
curl --request POST \
  --url https://api.enrow.io/phone/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "searches": [
      {
        "linkedin_url": "https://www.linkedin.com/in/michael-scott"
      },
      {
        "linkedin_url": "https://www.linkedin.com/in/dwight-schrute"
      }
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/phone"
    }
  }'
{
  "credits_used": 80,
  "estimated_duration": 1,
  "id": "e3b61122-d6a6-4ea7-b331-9b734682a76a",
  "message": "Bulk search operating",
  "credits": {
    "amount": 80,
    "source": "sub",
    "split": {
      "fromPaygo": 0,
      "fromSub": 80
    }
  }
}

Nächste Schritte

Bulk-Ergebnisse abrufen

Rufen Sie die gefundenen Telefonnummern über die Batch-id ab.

Einzelne Telefonnummer finden

Führen Sie eine einzelne Telefonsuche aus einer LinkedIn-URL oder Name und Unternehmen aus.

Webhooks

Werden Sie automatisch benachrichtigt, wenn eine Bulk-Suche abgeschlossen ist.

Credits & Abrechnung

Sehen Sie, wie Credits für jeden Endpunkt verbraucht werden.