Passer au contenu principal
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
Lancez une recherche asynchrone pour trouver un numéro de téléphone et le pays associé. Authentifiez chaque requête avec votre clé API dans l’en-tête x-api-key. La recherche doit contenir soit :
  • L’URL du profil LinkedIn d’une personne (par exemple, https://www.linkedin.com/in/michael-scott/)
  • La combinaison d’informations individuelles : firstname + lastname + (company_name ou company_domain)
L’URL LinkedIn prévaudra toujours sur les informations individuelles si les deux sont présentes, car c’est le meilleur moyen d’identifier une personne unique et d’éviter les problèmes liés aux homonymes.

Corps de la requête

Option 1 (Recommandée) :
linkedin_url
string
URL du profil LinkedIn de la personne.Remarque : Prend le pas sur les informations individuelles si les deux sont fournies.
Option 2 :
firstname
string
Prénom de la personne
lastname
string
Nom de la personne
company_domain
string
Domaine de l’entreprise (par exemple, "dundermifflin.com")
company_name
string
Nom de l’entreprise (alternative à company_domain)
Complémentaire :
custom
string
Une valeur personnalisée que vous pouvez utiliser pour référencer un identifiant interne. Elle sera présente dans les résultats.
settings
object
Paramètres liés à cette recherche.

Réponse

201 — Recherche unique créée

message
string
Message de confirmation
id
string
Identifiant unique de cette recherche. Utilisez-le pour récupérer les résultats via le point de terminaison GET.
credits_used
number
Nombre de crédits consommés (50 par défaut ; peut varier selon le forfait). Voir Crédits et facturation pour les coûts par point de terminaison.
credits
object
Détail des crédits

Réponses d’erreur

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
En cas de crédits insuffisants (402), le corps de la réponse est { "reason": "...", "success": false }. Voir Gestion des erreurs pour la liste complète des codes de statut et des formats de réponse.
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 }
  }
}

Étapes suivantes

Obtenir le résultat

Récupérez le numéro de téléphone trouvé à l’aide de l’id de recherche.

Trouver des téléphones en masse

Lancez plusieurs recherches de téléphone en une seule requête.

Authentification

Comment transmettre votre clé API dans l’en-tête x-api-key.

Webhooks

Soyez notifié automatiquement à la fin d’une recherche.