Pappers French Company Data Scraper

Search and look up French company registry data from Pappers.fr — legal identity (SIREN/SIRET), legal form, registered address, activity (NAF/APE code), workforce size, share capital, and available financial figures. Data comes from official French registries (RCS, RNE, INSEE) as published by Pappers. No login, no API key, no cookies required.

What this actor does

• Two modes: search (find companies by name/keyword with filters) and companyLookup (fetch a company profile directly by its SIREN number)
• Filters: postal code, department (dropdown — all 101 French departments incl. Corsica's 2A/2B and overseas), region (mainland + overseas), city, activity (NAF/APE code — full 732-code dropdown), legal form, collective bargaining agreement (IDCC code), workforce range, turnover range, share-capital range, creation-date range, active vs. ceased status
• Rich company data: legal identity, registered address, activity, workforce, share capital, turnover / net income / net margin (when disclosed), recent official BODACC legal announcements (creation, modification, sale, deregistration, insolvency proceedings, accounts filing), and the company's recent filed legal acts / annual accounts on record at the RCS/RNE
• Empty fields are omitted — every record only contains fields Pappers actually publishes for that company

Output per company

search mode

• siren — 9-digit French company identifier
• name, entityType (company / individual — companies & associations vs. sole-trader/entrepreneur individuel registrations), legalFormCode, legalFormName
• status (active / ceased, derived from the company's actual RCS/RNE registration status and any filed cessation date — omitted for the rare foreign entity with no French registration to check against), dateOfCreation, cessationDate
• purpose — declared business purpose
• activityCode, activityName — NAF/APE activity classification
• shareCapital, shareCapitalCurrency
• workforceMin, workforceMax, workforceDate — INSEE workforce bracket
• addressLine1, addressLine2, postalCode, city, country
• regionCode, region — French administrative region (INSEE code + name), derived from the postal code
• registrationStatus, registrationLocation, registrationDate — RCS/RNE registration status, registry office, and registration date
• turnover, netIncome, netMarginPercent — when the latest filed financial statement discloses them (net margin computed from the two)
• recentPublications[] — up to 5 most recent official BODACC legal announcements for the company (date, category — Création / Modification / Vente / Radiation / Procédure collective / Dépôt des comptes, and the full official announcement text)
• recentDocuments[] — up to 5 most recent legal acts / annual accounts filed and on record at the RCS/RNE (date, type — Acte / Comptes annuels, and a description of the filing when Pappers has classified it, e.g. "Statuts mis à jour", "Procès-verbal d'assemblée générale ordinaire")
• pappersUrl — link to the full company profile on pappers.fr
• recordType: "company", scrapedAt

companyLookup mode

• siren, name, siretHeadOffice
• legalFormName, vatNumber, rcsNumber
• activityCode, activityName, activityDescription, activityDomain — broader industry domain the declared activity belongs to (e.g. "Publicité et études de marché" for an advertising agency's specific "Activités des agences de publicité" activity)
• address, workforceText, dateOfCreation, status
• shareCapital, shareCapitalCurrency
• rcsInscriptionStatus, rneInscriptionStatus — registration status with the Trade and Companies Register (RCS) and the National Business Register (RNE), typically Inscrit
• fiscalYearEndDate — the company's recurring annual accounting-period closing date, DD/MM (e.g. 31/12)
• executives[] — named company officers/directors, where publicly listed
• establishments[] — every registered location on file (head office + secondary establishments): siret, type (headquarters / secondary), status (active / closed), address, dateOfCreation
• pappersUrl
• recordType: "company", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / companyLookup
searchQuery	string	boulangerie	Company name or keyword (mode=search)
sirens	array	–	9-digit SIREN numbers (mode=companyLookup). A 14-digit SIRET is also accepted and truncated to its SIREN.
postalCode	string	–	French postal code, e.g. 75001
departement	string	–	French department (dropdown): all 101 departments, e.g. 75 Paris, 69 Rhône, 13 Bouches-du-Rhône, 2A/2B Corsica, plus overseas departments
region	string	–	French region (dropdown): Île-de-France, Auvergne-Rhône-Alpes, PACA, Occitanie, Nouvelle-Aquitaine, Grand Est, Hauts-de-France, Normandie, Bretagne, Pays de la Loire, Bourgogne-Franche-Comté, Centre-Val de Loire, Corse, plus overseas regions (Guadeloupe, Martinique, Guyane, La Réunion, Mayotte)
city	string	–	City name, e.g. Paris
nafCode	string	–	Activity (NAF/APE) code — dropdown covering all 732 official INSEE NAF Rev. 2 codes, e.g. 10.71C (bakeries)
legalForm	string	–	Legal form (dropdown): EI, SNC, SCS, EURL, SARL, SA, SAS, SASU, GIE, SCI, Association, Fondation
conventionCollective	string	–	Collective bargaining agreement (convention collective) IDCC code, e.g. 1596 (Syntec), 1517 (bâtiment)
workforceMin	int	–	Minimum employee count
workforceMax	int	–	Maximum employee count
turnoverMin	int	–	Minimum latest filed annual turnover, in EUR
turnoverMax	int	–	Maximum latest filed annual turnover, in EUR
shareCapitalMin	int	–	Minimum declared share capital, in EUR
shareCapitalMax	int	–	Maximum declared share capital, in EUR
dateCreationMin	string	–	Only companies created on/after this date (YYYY-MM-DD)
dateCreationMax	string	–	Only companies created on/before this date (YYYY-MM-DD)
includeCeased	bool	false	Include closed/dissolved companies
maxItems	int	50	Hard cap (1–1000)

Example: bakeries in Paris (75)

{
  "mode": "search",
  "searchQuery": "boulangerie",
  "departement": "75",
  "maxItems": 50
}

Example: active SAS companies founded since 2022

{
  "mode": "search",
  "searchQuery": "consulting",
  "legalForm": "5710",
  "dateCreationMin": "2022-01-01",
  "includeCeased": false
}

Example: mid-sized restaurants by turnover and share capital

{
  "mode": "search",
  "searchQuery": "restaurant",
  "turnoverMin": 1000000,
  "turnoverMax": 5000000,
  "shareCapitalMin": 50000,
  "maxItems": 50
}

Example: bakeries across the Auvergne-Rhône-Alpes region

{
  "mode": "search",
  "searchQuery": "boulangerie",
  "region": "84",
  "maxItems": 50
}

Example: consulting companies under the Syntec collective agreement

{
  "mode": "search",
  "searchQuery": "conseil",
  "conventionCollective": "1596",
  "maxItems": 50
}

Example: look up specific companies by SIREN

{
  "mode": "companyLookup",
  "sirens": ["322120916", "331517938"]
}

Use cases

• Sales & lead generation — find companies in a target city, sector, or size band
• Due diligence & KYC — pull legal identity, address, and status before onboarding a French counterparty
• Market research — count and profile companies by activity code or legal form
• Supplier/vendor verification — confirm a SIREN corresponds to an active, registered company
• Data enrichment — attach official registry fields to an existing company list

FAQ

What's Pappers? A free French platform aggregating official company registry data (RCS, RNE, INSEE, BODACC) for every registered business in France. See pappers.fr.

What's a SIREN? A unique 9-digit identifier assigned by INSEE to every legal entity registered in France. A SIRET extends it with a 5-digit establishment suffix — pasting a 14-digit SIRET into the sirens input still works, it's automatically truncated to the SIREN.

Why are some fields missing on some companies? Pappers only publishes what's officially disclosed. Small or recently created companies often don't have a filed workforce bracket, financial statement, or listed executives yet — those fields are simply omitted for that record.

Does legalForm cover every legal form in France? It covers the most common ones (EI, SNC, SCS, EURL, SARL, SA, SAS, SASU, GIE, SCI, Association, Fondation). Leave it blank to search across all legal forms.

What's conventionCollective? France's collective bargaining agreements (conventions collectives nationales) apply industry-specific labor rules to a company's employees. Each one has a 4-digit IDCC identifier (findable via travail-emploi.gouv.fr or a company's own Pappers profile); pass it to conventionCollective to restrict results to companies covered by that agreement.

What's the difference between departement and region? A department (e.g. 75 Paris) is a smaller administrative unit; a region (e.g. 11 Île-de-France) groups several departments. Use region for a broader geographic sweep, or combine both for a precise, narrower area within a region.

Can I filter to only active companies? Yes — includeCeased defaults to false, returning only currently registered/active companies. Set it to true to include closed or dissolved companies too.

What does status actually mean? active means the company is currently registered with the RCS/RNE and has no filed cessation date; ceased means it's been deregistered or has a filed cessation date. For the small number of foreign entities with no French RCS registration to check (e.g. a foreign parent company), status is omitted rather than guessed.

Is this data official? Yes — it originates from the French commercial court registries (RCS), the National Business Register (RNE), and INSEE, republished by Pappers.

What's in recentPublications? Official legal announcements published in the BODACC (Bulletin officiel des annonces civiles et commerciales) — France's public gazette for company creations, changes of management/capital/address, sales, deregistrations, insolvency proceedings, and annual accounts filings. Up to the 5 most recent are included per company, when Pappers has any on file.

What's in recentDocuments? The company's own filed documents on record at the RCS/RNE registry — legal acts (Acte, e.g. meeting minutes, updated bylaws) and annual accounts filings (Comptes annuels). This is distinct from recentPublications: publications are the public BODACC gazette announcement about an event, while documents are the underlying filing itself. Up to the 5 most recent are included per company, when Pappers has any on file.

What's in establishments (companyLookup mode)? Every physical location registered under the company's SIREN — the head office plus any secondary establishments (branches, stores, warehouses) — each with its own 14-digit SIRET, activity status, address, and registration date. Useful for mapping a company's footprint beyond its headquarters address.

What are rcsInscriptionStatus / rneInscriptionStatus? Whether the company is currently registered with France's Trade and Companies Register (RCS, for commercial entities) and/or the National Business Register (RNE, which replaced the old RNCS/CMA/Agriculture registries in 2023). Most active companies show Inscrit for both.

What's fiscalYearEndDate? The company's declared annual accounting-period closing date (e.g. 31/12 for a calendar-year close), as DD/MM — this is a recurring date, not tied to a specific year.

How fresh is the data? Pappers re-syncs from RCS, RNE, and INSEE on a rolling basis (often daily), as shown on each company's profile page.

Why did I get fewer companies than maxItems? Pappers' free/unauthenticated search only exposes the first ~400 raw matches for any given searchQuery + filter combination. If your query is broad, narrow it (add a postalCode, departement, or nafCode filter) to bring more of the results you care about within that window, or split a broad query into several narrower ones.