Naar hoofdinhoud gaan
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
Voer meerdere telefoonzoekopdrachten uit in één verzoek. Tot 3.000 zoekopdrachten per batch. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header. Gebruik het Find Single Phone-endpoint om één telefoonnummer te vinden. Elke zoekopdracht moet een van de volgende bevatten:
  • De URL van iemands LinkedIn-profiel (bijv. https://www.linkedin.com/in/michael-scott/)
  • De combinatie van individuele informatie: firstname + lastname + (company_name of company_domain)
De LinkedIn-URL heeft altijd voorrang op de individuele informatie als beide aanwezig zijn.

Request Body

searches
array of objects
vereist
Zoekpayloads waarvoor de bijbehorende telefoonnummers moeten worden gevonden.
custom
object
Aangepaste parameters die worden teruggegeven in de GET-respons en in de webhook-notificatie.
settings
object
Instellingen die betrekking hebben op de volledige bulkzoekopdracht.

Response

201 — Bulkzoekopdracht aangemaakt

message
string
Bevestigingsbericht
id
string
Unieke identifier voor deze batch. Gebruik deze om resultaten op te halen via het GET-endpoint.
credits_used
number
Totaal aantal verbruikte credits. Zie Credits & facturering voor kosten per endpoint.
estimated_duration
number
Geschatte verwerkingstijd in minuten (niet gegarandeerd)
credits
object
Uitsplitsing van credits

Foutresponsen

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
Wanneer er onvoldoende credits zijn, retourneert het bulk-endpoint HTTP 402 met een body in de vorm { "message": "..." }. Zie Foutafhandeling voor de volledige lijst met statuscodes en responsformaten.
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
    }
  }
}

Volgende stappen

Bulkresultaten ophalen

Haal de gevonden telefoonnummers op met de batch-id.

Eén telefoonnummer vinden

Voer één telefoonzoekopdracht uit op basis van een LinkedIn-URL of naam en bedrijf.

Webhooks

Word automatisch genotificeerd wanneer een bulkzoekopdracht is voltooid.

Credits & facturering

Bekijk hoe credits per endpoint worden verbruikt.