insee.search_establishments
mock data$0.002 / callSearch French Establishments in Sirene
Search French establishments (physical sites, branches, stores) in the INSEE Sirene registry using a Lucene-style filter query. Supports filtering by postal code (codePostalEtablissement, e.g. "75008"), city name (libelleCommuneEtablissement, e.g. "PARIS"), NAF activity code (activitePrincipaleEtablissement, e.g. "47.11B" for supermarkets), status (etatAdministratifEtablissement: A=active, F=closed), and parent company name (denominationUniteLegale). Combine clauses with AND / OR operators. Returns SIRET, address, status, NAF code, head-office flag, and parent company summary for each matching establishment. Use insee.establishment.by_siret to retrieve full details for a specific SIRET.
Input schema
Lucene-style filter expression on establishment fields. Examples: "codePostalEtablissement:75008" searches by French postal code; "libelleCommuneEtablissement:PARIS" searches by city name; "activitePrincipaleEtablissement:47.11B" searches by NAF activity code; "etatAdministratifEtablissement:A" returns only active establishments (A=active, F=closed); "denominationUniteLegale:CARREFOUR" filters by parent company name. Combine with AND / OR operators.
Maximum number of results to return (1–20, default 10).
Zero-based starting offset for pagination (default 0).
Call via REST
curl -X POST https://unifyapi.pro/api/call/insee.search_establishments \
-H "Authorization: Bearer uak_live_..." \
-H "Content-Type: application/json" \
-d '{"q":"<q>","max":0,"offset":0}'