{"uid":"cap_i2IHXtFp8J_bICGCpkhSo","slug":"pappers-french-company-search-api-9250566a","name":"Pappers French Company Search API","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_ylhQF0VTve6mZQevSGg0D","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 look up French companies by name, location, SIREN/SIRET identifier, or filters via the Pappers data source","exampleAgentPrompt":"Search for organic-certified companies in Île-de-France (region 11) using Pappers — return up to 50 results for businesses involved in food production.","exampleUseCases":[{"title":"Find certified contractors near a job site","prompt":"Find all RGE-certified companies within 10 km of latitude 48.8566, longitude 2.3522 in Paris — I need a list of up to 20 contractors for a renovation project."},{"title":"Look up a supplier by SIREN number","prompt":"Look up the French company with SIREN 552032534 and tell me their legal name, headquarters SIRET, and administrative status."},{"title":"Market research by revenue and region","prompt":"Search for companies in Brittany with annual revenue between 1 million and 10 million euros — I want up to 100 results to analyze the regional market."}],"resultDescription":"Returns a JSON object with a count of matching companies and an array of company records, each containing SIREN, company name, legal name, headquarters SIRET, record type, administrative status, and the requested identifier used for the lookup.","failureModes":["Empty result set when no companies match the filters (not charged)","Invalid SIREN/SIRET format returns an error","Radius exceeding 50 km rejected by schema validation","Revenue filter (ca_min/ca_max) only applies to companies with publicly available accounts — many SMEs have no filed accounts","Region code must be a valid French INSEE region code or the filter is ignored","maxResults above 10,000 is capped by source limitations"],"whenToPreferThis":"Use this endpoint when you need structured French company data from the Pappers registry, especially for SIREN/SIRET lookups, geographic proximity searches, or filtered searches by certification (bio, ESS, RGE) or revenue. Prefer this over generic web scraping when you need clean, structured fields like legal name, administrative status, and headquarters SIRET for French entities specifically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:51.998Z","isFirstParty":false,"canonicalSlug":"pappers-french-company-search-api-9250566a"}