Naar hoofdinhoud gaan
POST
/
phone
/
single
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'
{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}
POST
https://api.enrow.io/phone/single
Voer een asynchrone zoekopdracht uit om een telefoonnummer en het bijbehorende land te vinden. Authenticeer elk verzoek met je API-sleutel in de x-api-key-header. De zoekopdracht moet een van de volgende bevatten:
  • De URL van het LinkedIn-profiel van een persoon (bijv. https://www.linkedin.com/in/michael-scott/)
  • De combinatie van individuele gegevens: firstname + lastname + (company_name of company_domain)
De LinkedIn-URL krijgt altijd voorrang op de individuele gegevens als beide aanwezig zijn, omdat dit de beste manier is om één persoon te onderscheiden en problemen met naamgenoten te voorkomen.

Request Body

Optie 1 (aanbevolen):
linkedin_url
string
LinkedIn-profiel-URL van de persoon.Opmerking: Krijgt voorrang op de individuele gegevens als beide worden opgegeven.
Optie 2:
firstname
string
Voornaam van de persoon
lastname
string
Achternaam van de persoon
company_domain
string
Bedrijfsdomein (bijv. "dundermifflin.com")
company_name
string
Bedrijfsnaam (alternatief voor company_domain)
Aanvullend:
custom
string
Een aangepaste waarde die je kunt gebruiken om naar een interne ID te verwijzen. Deze is aanwezig in de resultaten.
settings
object
Instellingen voor deze zoekopdracht.

Response

201 — Eén zoekopdracht aangemaakt

message
string
Bevestigingsbericht
id
string
Unieke identifier voor deze zoekopdracht. Gebruik deze om resultaten op te halen via het GET-endpoint.
credits_used
number
Aantal verbruikte credits (standaard 50; kan per abonnement verschillen). Zie Credits & facturatie voor de kosten per endpoint.
credits
object
Creditspecificatie

Foutmeldingen

CodeMessage
400Invalid linkedin_url format
401No apikey found in the x-api-key headers
401This apikey is not valid
401This account is not allowed to use the phone search feature
402Insufficient credits
Bij onvoldoende credits (402) is de response body { "reason": "...", "success": false }. Zie Foutafhandeling voor de volledige lijst met statuscodes en responseformaten.
curl --request POST \
  --url https://api.enrow.io/phone/single \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "linkedin_url": "https://www.linkedin.com/in/michael-scott/",
    "custom": "#u84hde941Jdx"
  }'
{
  "credits_used": 40,
  "id": "94cbc13b-7d77-4f41-83f0-60106daa7182",
  "message": "Single search operating",
  "credits": {
    "amount": 40,
    "source": "sub",
    "split": { "fromPaygo": 0, "fromSub": 40 }
  }
}

Volgende stappen

Resultaat ophalen

Haal het gevonden telefoonnummer op met de zoek-id.

Telefoonnummers in bulk zoeken

Voer meerdere telefoonzoekopdrachten uit in één verzoek.

Authenticatie

Hoe je je API-sleutel meegeeft in de x-api-key-header.

Webhooks

Word automatisch geïnformeerd wanneer een zoekopdracht is voltooid.