[{"id":"fr-suppliers","version":"1.0.0","title":"Fournisseurs et entreprises françaises","description":"Entreprises françaises répondant à vos critères (mots-clés, codes NAF, départements, catégorie), depuis la source officielle (API Recherche d'entreprises), en liste structurée avec SIREN, siège, activité, taille et lien vers la fiche officielle. Facultatif : classement de pertinence sur un critère en texte libre (match / no_match / undetermined).","mode":"sync","endpoints":{"quote":"https://304notfound.com/v1/services/fr-suppliers/quote","run":"https://304notfound.com/v1/services/fr-suppliers/run"},"input_schema":{"properties":{"query":{"anyOf":[{"maxLength":200,"minLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Mots-clés cherchés dans la dénomination et l'adresse (ex. « emballage carton »).","title":"Query"},"naf_codes":{"description":"Codes NAF rév. 2 de l'activité principale (ex. 17.21A). Filtre exact.","items":{"type":"string"},"maxItems":10,"title":"Naf Codes","type":"array"},"departements":{"description":"Départements (ex. 60, 2A, 974). Filtre sur les établissements, pas seulement le siège.","items":{"type":"string"},"maxItems":20,"title":"Departements","type":"array"},"categories":{"description":"Catégories INSEE.","items":{"enum":["PME","ETI","GE"],"type":"string"},"title":"Categories","type":"array"},"active_only":{"default":true,"description":"Seulement les entreprises en activité.","title":"Active Only","type":"boolean"},"max_results":{"default":20,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"},"relevance_criterion":{"anyOf":[{"maxLength":300,"minLength":5,"type":"string"},{"type":"null"}],"default":null,"description":"Facultatif : critère en texte libre que chaque entreprise doit remplir (classé par Jev). Coûte un supplément ; sans clé Jev, le résultat est livré sans ce classement et n'est pas facturé.","title":"Relevance Criterion"},"drop_no_match":{"default":false,"description":"Retirer les entreprises classées no_match (les « undetermined » restent).","title":"Drop No Match","type":"boolean"}},"title":"SuppliersIn","type":"object"},"output_schema":{"$defs":{"Company":{"properties":{"siren":{"title":"Siren","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"naf_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naf Code"},"naf2025_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Naf2025 Code"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"employee_band":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employee Band"},"employee_band_year":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Employee Band Year"},"created_on":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created On"},"active":{"title":"Active","type":"boolean"},"open_establishments":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Open Establishments"},"head_office":{"anyOf":[{"$ref":"#/$defs/HeadOffice"},{"type":"null"}]},"matching_establishment":{"anyOf":[{"$ref":"#/$defs/MatchingEstablishment"},{"type":"null"}],"default":null},"address_withheld":{"title":"Address Withheld","type":"boolean"},"source_url":{"title":"Source Url","type":"string"},"relevance":{"$ref":"#/$defs/Relevance"}},"required":["siren","name","naf_code","naf2025_code","category","employee_band","employee_band_year","created_on","active","open_establishments","head_office","address_withheld","source_url","relevance"],"title":"Company","type":"object"},"HeadOffice":{"properties":{"siret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siret"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"departement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Departement"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"}},"required":["siret","address","postal_code","city","departement","region"],"title":"HeadOffice","type":"object"},"MatchingEstablishment":{"properties":{"siret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Siret"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"is_head_office":{"title":"Is Head Office","type":"boolean"}},"required":["siret","address","postal_code","city","is_head_office"],"title":"MatchingEstablishment","type":"object"},"Relevance":{"properties":{"verdict":{"enum":["match","no_match","undetermined","not_evaluated"],"title":"Verdict","type":"string"},"probability":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Probability"}},"required":["verdict"],"title":"Relevance","type":"object"},"RelevanceInfo":{"properties":{"requested":{"title":"Requested","type":"boolean"},"evaluated":{"title":"Evaluated","type":"boolean"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Model"},"accept_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Accept Threshold"},"reject_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Reject Threshold"},"calibrated":{"default":false,"title":"Calibrated","type":"boolean"}},"required":["requested","evaluated"],"title":"RelevanceInfo","type":"object"}},"properties":{"companies":{"items":{"$ref":"#/$defs/Company"},"title":"Companies","type":"array"},"count":{"title":"Count","type":"integer"},"total_available":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Available"},"truncated":{"title":"Truncated","type":"boolean"},"relevance":{"$ref":"#/$defs/RelevanceInfo"}},"required":["companies","count","total_available","truncated","relevance"],"title":"SuppliersOut","type":"object"},"pricing":"Prix ferme donné par le devis : 0.02 € par appel, + 0.01 € avec relevance_criterion. Facturé seulement si status=completed (version d'essai : décompté du quota de la clé, aucun encaissement réel).","typical_latency_seconds":"1 à 3 ; 3 à 8 avec classement de pertinence","freshness":"Données officielles mises à jour chaque jour ; un même résultat est resservi 24 h au plus.","limits":["50 entreprises au plus par appel.","Aucune coordonnée (téléphone, e-mail, site) : la source officielle n'en donne pas.","Aucune donnée personnelle des dirigeants n'est renvoyée.","Information générale : vérifiez la fiche officielle avant tout engagement."],"errors":{"422":"Paramètres refusés (format NAF, département, aucun filtre).","402":"Prix supérieur à max_price_eur, ou plafond de dépense journalier de la clé atteint.","404 / 409 / 410":"Devis inconnu / déjà utilisé ou pour d'autres paramètres / expiré.","status=failed":"Source indisponible (reason : timeout, busy, provider_error, bad_request) ; non facturé, retryable indique s'il faut réessayer.","status=partial":"Livré avec un manque signalé dans missing ; non facturé."},"capabilities":{"collection":{"provider":"API Recherche d'entreprises (DINUM, data.gouv.fr)","available":true},"relevance":{"provider":"TypeSafe Jev (jev-1.13.0)","available":false}}}]