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
object
Show properties
Show properties
object
Show filter fields
Show filter fields
string[]
Free-text search terms (e.g. company name).
string[]
NAF/APE activity codes (e.g.
["62.01Z", "62.02A"]).string
Administrative status.
"A" for active, "C" for closed.string[]
Employee count ranges. Allowed values:
"0", "1-9", "10-49", "50-199", "200-499", "500+".string[]
French department codes (e.g.
["75", "92", "93"]).string
French region code (e.g.
"11" for Ile-de-France).string[]
Postal codes (e.g.
["75001", "75002"]).string[]
Legal form categories. Allowed values:
"Entreprises individuelles", "Sociétés commerciales", "Sociétés civiles", "Associations", "Autres".integer
default:"1"
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)"
}