Obtenir une entreprise

La fiche complète d’une entreprise. Les coordonnées sont masquées, et domain et website sont à null tant que vous ne l’avez pas révélée. Cette lecture ne consomme jamais de quota. Elle consomme une entreprise de votre budget quotidien, sauf si vous l’avez déjà révélée.

GEThttps://findbytown.com/api/v1/businesses/{id}Sans quota

Paramètres de chemin

Nom	Type	Description
id(requis)	integer	Identifiant de l’entreprise, un entier.

Paramètres

Nom	Type	Description
locale	en \| fr \| es	Langue des libellés et des noms de catégories : en, fr ou es. Par défaut, la langue de votre compte.

Exemples

curl "https://findbytown.com/api/v1/businesses/1001" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

const res = await fetch("https://findbytown.com/api/v1/businesses/1001", {
  headers: { Authorization: "Bearer fbt_EXAMPLE_not_a_real_key_0000" },
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);
console.log(body);

import requests

res = requests.get(
    "https://findbytown.com/api/v1/businesses/1001",
    headers={"Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"},
)
body = res.json()
if not res.ok:
    raise RuntimeError(body["error"])
print(body)

Réponse

Exemple avec des valeurs fictives :

{
  "data": {
    "id": 1001,
    "domain": null,
    "name": "Example Plumbing",
    "website": null,
    "zone": "fr_idf",
    "zoneLabels": {
      "en": "Example Region",
      "fr": "Région Exemple",
      "es": "Región Ejemplo"
    },
    "country": "FR",
    "precision": "exact",
    "address": "1 Example Street",
    "city": "Exampleville",
    "quality": 80,
    "provider": "google",
    "providerDetail": "Google Workspace",
    "hasPhone": true,
    "contactsCount": 1,
    "otherEmailsCount": 0,
    "description": "Plumbing and heating repairs.",
    "logoUrl": null,
    "social": {},
    "openingHours": null,
    "activity": "Plumber",
    "categories": [
      "Heating contractor"
    ],
    "websiteTitle": null,
    "postalCode": "00000",
    "adminArea": "Example Region",
    "fullAddress": "1 Example Street, 00000 Exampleville",
    "mapsUrl": null,
    "rating": 4.6,
    "reviews": 25,
    "facts": null,
    "extraPhonesCount": 0,
    "primaryEmailMasked": "c•••@•••",
    "phoneMasked": "+33 1 •• •• •• 00",
    "revealed": false,
    "contact": null
  }
}

Erreurs

Code	Statut HTTP	Signification
validation_error	400	Un paramètre est manquant ou mal formé. details indique lequel.
unknown_parameter	400	Un paramètre de requête n’est pas connu de cet endpoint, en général à cause d’une faute de frappe. details indique lequel.
use_reveal_endpoint	400	Vous avez envoyé reveal= sur une lecture. Les lectures ne consomment jamais de quota : utilisez l’endpoint de révélation.
bad_id	400	L’identifiant de l’entreprise n’est pas un entier positif.
missing_api_key	401	En-tête Authorization absent ou vide.
invalid_api_key	401	La clé n’existe pas ou a été révoquée.
plan_without_api	403	L’offre actuelle du compte n’inclut pas l’API. S’applique dès la fin d’une offre.
suspended	403	Le compte est suspendu. Ses clés refonctionnent si la suspension est levée.
not_found	404	Cette entreprise n’existe pas, ou elle a été retirée à la demande de son propriétaire.
rate_limited	429	Trop de requêtes cette minute. Attendez le nombre de secondes indiqué dans Retry-After.
budget_exhausted	429	Vous avez atteint le budget quotidien d’entreprises distinctes. Les entreprises déjà vues aujourd’hui passent toujours. Retry-After indique quand il se réinitialise.
blocked	429	L’accès aux données d’entreprises est temporairement suspendu en raison d’un usage automatisé, comme le parcours des identifiants. Retry-After indique le temps restant. Écrivez au support s’il s’agit d’une erreur.
internal_error	500	Une erreur s’est produite de notre côté. Indiquez requestId en écrivant au support.

Retour à findbytown