curl -X POST https://search.leads-siren.com/enrichment-service/search_companies \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_companies",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}
)
print(resp.json())
{
"total": 1520,
"page": 1,
"results": [
{
"siren": "123456789",
"nom_complet": "Example SARL",
"siege": { ... },
"activite_principale": "62.01Z",
"tranche_effectif_salarie": "10-49"
}
]
}
{
"detail": "Insufficient credits (have 0, need 5)"
}
Search
Search Companies
POST
/
enrichment-service
/
search_companies
curl -X POST https://search.leads-siren.com/enrichment-service/search_companies \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_companies",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}
)
print(resp.json())
{
"total": 1520,
"page": 1,
"results": [
{
"siren": "123456789",
"nom_complet": "Example SARL",
"siege": { ... },
"activite_principale": "62.01Z",
"tranche_effectif_salarie": "10-49"
}
]
}
{
"detail": "Insufficient credits (have 0, need 5)"
}
Search French companies by location, sector, legal form, employee count, and more. All filter fields are optional — you can pass any combination of them, or even an empty
filters object.
Request Body
Show properties
Show properties
Show filter fields
Show filter fields
Free-text search terms (e.g. company name).
NAF/APE activity codes (e.g.
["62.01Z", "62.02A"]).Administrative status.
"A" for active, "C" for closed.Employee count ranges. Allowed values:
"0", "1-9", "10-49", "50-199", "200-499", "500+".French department codes (e.g.
["75", "92", "93"]).French region code (e.g.
"11" for Ile-de-France).Postal codes (e.g.
["75001", "75002"]).Legal form categories. Allowed values:
"Entreprises individuelles", "Sociétés commerciales", "Sociétés civiles", "Associations", "Autres".Page number for paginated results.
Credit Cost
A fixed number of credits is deducted per request.curl -X POST https://search.leads-siren.com/enrichment-service/search_companies \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_companies",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"filters": {
"departement": ["75"],
"activite_principale": ["62.01Z"],
"tranche_effectif_salarie": ["10-49", "50-199"],
"nature_juridique": ["Sociétés commerciales"],
"etat_administratif": "A"
},
"page": 1
}
}
)
print(resp.json())
{
"total": 1520,
"page": 1,
"results": [
{
"siren": "123456789",
"nom_complet": "Example SARL",
"siege": { ... },
"activite_principale": "62.01Z",
"tranche_effectif_salarie": "10-49"
}
]
}
{
"detail": "Insufficient credits (have 0, need 5)"
}
⌘I