{"uid":"cap_Hwyvyvk451DzW5NA0yaFt","slug":"pappers-french-company-lookup-api-x402-ea4a511a","name":"Pappers French Company Lookup API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/pappers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude of the center point in geographic mode."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude of the center point in geographic mode."},"mode":{"enum":["search","geo","siren","count"],"type":"string","default":"search","description":"Search companies, find companies near a point, look up SIREN/SIRET identifiers, or preview a match count."},"query":{"type":"string","description":"Company name, address, activity, or other public search terms. Combine with filters to narrow results."},"ca_max":{"type":"integer","minimum":0,"description":"Maximum reported revenue in euros; only companies with available accounts can match. Applies to search and count."},"ca_min":{"type":"integer","minimum":0,"description":"Minimum reported revenue in euros; only companies with available accounts can match. Applies to search and count."},"region":{"type":"string","description":"French region code, such as 11 for Île-de-France. Applies to search and count."},"sirens":{"type":"array","items":{"type":"string"},"default":[],"description":"Nine-digit SIRENs or 14-digit SIRETs for lookup mode. A SIRET is mapped to its parent company SIREN."},"est_bio":{"type":"boolean","default":false,"description":"Include only companies with an organic certification in search and count."},"est_ess":{"type":"boolean","default":false,"description":"Include only social-economy companies in search and count."},"est_rge":{"type":"boolean","default":false,"description":"Include only companies with RGE certification in search and count."},"radiusKm":{"type":"number","default":5,"maximum":50,"minimum":0.1,"description":"Distance from the center point in geographic mode; maximum 50 km."},"maxResults":{"type":"integer","default":100,"maximum":10000,"minimum":1,"description":"Stop after this many distinct companies. For broad searches, narrow filters to stay within the source's 10,000-result query limit."},"code_postal":{"type":"string","description":"Five-digit postal code. Applies to search and count."},"departement":{"type":"string","description":"French department code, such as 75 for Paris or 69 for Rhône. Applies to search and count."},"code_commune":{"type":"string","description":"Five-character INSEE commune code. Applies to search and count."},"est_qualiopi":{"type":"boolean","default":false,"description":"Include only companies with Qualiopi certification in search and count."},"nom_personne":{"type":"string","description":"Surname of a publicly listed company director. Applies to search and count."},"type_personne":{"enum":["dirigeant","elu"],"type":"string","description":"Role type used with a person-name search. Applies to search and count."},"est_association":{"type":"boolean","default":false,"description":"Include only associations in search and count."},"nature_juridique":{"type":"string","description":"INSEE legal form code. Applies to search and count."},"prenoms_personne":{"type":"string","description":"Given name of a publicly listed company director. Applies to search and count."},"resultat_net_max":{"type":"integer","description":"Maximum reported net income in euros. Applies to search and count."},"resultat_net_min":{"type":"integer","description":"Minimum reported net income in euros. Applies to search and count."},"etat_administratif":{"enum":["A","C"],"type":"string","default":"A","description":"A for active companies or C for ceased companies. Applies to search and count."},"activite_principale":{"type":"string","description":"NAF/APE activity code, such as 62.01Z. Also supported in geographic mode."},"est_societe_mission":{"type":"boolean","default":false,"description":"Include only mission-driven companies in search and count."},"categorie_entreprise":{"enum":["PME","ETI","GE"],"type":"string","description":"French company size category. Applies to search and count."},"est_organisme_formation":{"type":"boolean","default":false,"description":"Include only registered training organizations in search and count."},"tranche_effectif_salarie":{"type":"string","description":"INSEE employee bracket code, for example 12 for 20–49 employees. Applies to search and count."},"section_activite_principale":{"type":"string","description":"Single-letter activity section, such as J for information and communication. Also supported in geographic mode."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"siren":null,"acronym":null,"legalName":null,"recordType":null,"companyName":null,"headquartersSiret":null,"requestedIdentifier":null,"administrativeStatus":null}],"product":"pappers"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.16","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.16/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_b0sN0Oum-YsLk8VAQRMeG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.16","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search, geolocate, and retrieve structured data on French companies by name, SIREN/SIRET, geography, or filters via pay-per-call.","exampleAgentPrompt":"Search for active French companies near Paris (48.8566° N, 2.3522° E) within 10 km that have RGE certification — give me up to 50 results with their SIREN numbers and legal names.","exampleUseCases":[{"title":"Find certified contractors near a job site","prompt":"I need to find RGE-certified building companies within 15 km of Lyon (45.7640° N, 4.8357° E) — can you pull up to 30 results with their SIREN and company names?"},{"title":"Due diligence on a French supplier","prompt":"Can you look up the company with SIREN 552032534 and tell me its legal name, administrative status, and headquarters SIRET?"},{"title":"Market research by revenue and region","prompt":"Search for French companies in Île-de-France (region code 11) with reported revenue between 1,000,000 and 10,000,000 euros — I want a count of how many match and the top 100 results."}],"resultDescription":"Returns a JSON object with a count of matched companies and an items array, each item containing SIREN, SIRET, legal name, company name, acronym, record type, headquarters SIRET, requested identifier, and administrative status. Failed or empty runs are not charged.","failureModes":["No companies found matching filters — returns empty items array with count 0 (not charged)","Invalid SIREN/SIRET format — malformed identifier returns error","Radius exceeds 50 km maximum — validation error","Revenue filters applied without available financial records — zero matches","Result cap of 10,000 exceeded — response is truncated to maxResults","Coordinates out of valid range — lat/lon boundary validation error"],"whenToPreferThis":"Use this endpoint when you need structured data specifically from the French company registry (Pappers), including SIREN/SIRET lookups, geographic proximity searches, certification filtering (bio, ESS, RGE), or revenue-based screening. Prefer it over generic web scrapers when you need official French business identifiers and legal status. It is pay-per-call with no charge on empty results, making it cost-effective for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:05.426Z","isFirstParty":false,"canonicalSlug":"pappers-french-company-lookup-api-x402-ea4a511a"}