pappers.fr APIpappers.fr ↗
Access French company registrations, director profiles, trademark filings, and BODACC legal publications via the Pappers.fr API. 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/678ff973-7c58-403f-8277-fa323b3629b9/search_companies?page=1&limit=3&query=Renault' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for French companies by name, SIREN, or keyword. Returns a paginated list of companies with identifiers, legal form, status, and location.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Results per page. |
| query | string | Search keyword or company name. |
| siren | string | 9-digit SIREN number to search for. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"total": "integer, total number of matching results",
"resultats": "array of company objects with siren, nom_entreprise, forme_juridique, siege, dirigeants, and more"
},
"sample": {
"data": {
"page": 1,
"total": 6,
"resultats": [
{
"siege": {
"ville": "PARIS",
"code_postal": "75009",
"adresse_ligne_1": "8 RUE DE LONDRES"
},
"siren": "443061841",
"capital": 1000000,
"nom_entreprise": "GOOGLE FRANCE",
"forme_juridique": "SARL, société à responsabilité limitée",
"statut_consolide": "actif"
}
]
},
"status": "success"
}
}About the pappers.fr API
The Pappers.fr API provides structured access to French business registry data across 6 endpoints, covering company profiles, director networks, trademark records, and official BODACC publications. The get_company_details endpoint returns SIREN, share capital, legal form, headquarters address, and director lists for any registered French company. Director cartography maps professional connections between individuals and companies across the French registry.
Company Search and Profiles
The search_companies endpoint accepts a free-text query, a 9-digit siren, or both, and returns paginated results with fields including nom_entreprise, forme_juridique, siege (headquarters location), and a dirigeants array. Use page and limit to step through large result sets. For a complete company record, pass the SIREN to get_company_details, which adds capital (share capital in euros) and a fuller director list to the same core fields.
Director Search and Network Cartography
search_directors queries the registry by director name and returns objects containing nom, prenom, qualite (role title), and an entreprises array listing each company the person is associated with. get_director_cartography goes further: given first_name, name, and an optional birth_date (MM/YYYY format) or director_id for disambiguation, it returns a graph structure with personnes nodes, entreprises nodes, and two link arrays — liens_entreprises_personnes and liens_entreprises_entreprises — that describe the full professional network around that individual.
Trademarks and Legal Publications
search_trademarks covers both French INPI and European EUIPO trademark registrations. Results include numero, texte (trademark text), statut, classes (Nice classification), deposants (applicants), and evenements (filing events). search_publications queries the BODACC official gazette and returns publication records with date, type, contenu, SIREN, and associated company details — useful for monitoring insolvency proceedings, mergers, and other legally mandated announcements.
- Enrich a CRM with French company legal form, share capital, and registered address using
get_company_details. - Build a director due-diligence tool by mapping professional networks with
get_director_cartographylink arrays. - Monitor competitor trademark activity by polling
search_trademarksfor INPI and EUIPO filings. - Detect insolvency or restructuring events early by scanning BODACC publications via
search_publications. - Verify company status and registered office address before signing a contract using
search_companieswith a SIREN. - Identify all companies linked to a specific individual using
search_directorsfollowed by cartography lookups. - Aggregate director role history across multiple companies using the
entreprisesfield insearch_directorsresults.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Pappers.fr have an official developer API?+
What does `get_director_cartography` return, and how do I disambiguate directors who share the same name?+
personnes (person nodes with id, prenom, nom, and date_naissance), entreprises (company nodes with siren and nom_entreprise), and two link arrays (liens_entreprises_personnes and liens_entreprises_entreprises) that describe connections. To disambiguate, pass birth_date in MM/YYYY format or supply the director_id returned by search_directors.Does the API return financial statements or annual accounts for French companies?+
How does pagination work across endpoints?+
page (integer) and limit (results per page) parameters. Each response includes a total field with the overall match count and a page field confirming the current page, so you can calculate the number of pages needed to exhaust a result set.