{"uid":"cap_Acu2BYEKQpBS4_FYqbBMw","slug":"sirenic-french-company-count-99efddb8","name":"Sirenic French Company Count","description":"Count French companies matching free cross-criteria on a pre-joined table of the official registries: geography (departement, region, postal-code prefix), NAF activity, legal form, workforce, age, last filed accounts (revenue, net income, margins, ratios, trends, cash items) and public signals (RGE, equality index, ICPE/Seveso, public contracts, authorisations). Active legal persons by default. Returns the exact count and each source's date: size a market before listing it.","url":"https://api.sirenic.eu/v1/entreprises/requete/compter?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"tri":{"type":"string","description":"Accepted without effect by the count route, so that the same query serves both modes. Sort field among identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, prefixed with - for descending order (default identite.siren); missing values come last in both orders."},"page":{"type":"string","description":"Accepted without effect by the count route. Page number, 1 to 100, 100 companies per page; each page is a separate payment (default 1)."},"champs":{"type":"string","description":"Accepted without effect by the count route. Comma-separated catalogue fields to serve (default: identity, head office, last closing date, revenue, net income); the SIREN and the fields of the criteria and of the sort are always served."},"criteres":{"type":"string","description":"JSON array of at most 20 conditions {\"champ\",\"op\",\"valeur\"}, URL-encoded, at most 2048 characters, combined with AND (OR goes through the in operator): champ is a filterable field of the catalogue served by GET /v1/lecture, op one of its operators, valeur typed by the field. Active legal persons by default (identite.etat = A; any criterion on identite.etat replaces it)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XyL1QMA14G0Tv7ZLZtoc7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the exact count of active French companies matching a set of cross-criteria filters (geography, NAF sector, legal form, workforce, financials, public signals) from pre-joined official registries.","exampleAgentPrompt":"How many active French companies are in the plastics manufacturing sector (NAF code 2229B) with between 10 and 49 employees and at least €500k in annual revenue — I want to size this market before building a prospect list.","exampleUseCases":[{"title":"Market sizing before B2B campaign","prompt":"Before we launch our B2B campaign, can you tell me how many active French companies in the IT consulting sector (NAF 6202A) have revenue above €1 million and are based in Île-de-France? I need the count to estimate our addressable market."},{"title":"Identifying RGE-certified contractors by region","prompt":"How many French companies currently hold the RGE energy-efficiency certification and are active in the insulation or roofing trades (NAF 4391A or 4399C) in the Auvergne-Rhône-Alpes region? I want to understand the competitive landscape before entering that market."},{"title":"Screening financially healthy manufacturers","prompt":"Count French manufacturing companies with a positive net income and revenue between €5M and €50M that filed accounts in the last two years — I'm trying to gauge how many targets fit our acquisition criteria in that segment."}],"resultDescription":"A JSON object containing the exact integer count of French legal persons matching all specified criteria, along with the freshness date of each source registry used to build the pre-joined table. No company-level records are returned — only the aggregate count and data provenance timestamps.","failureModes":["Invalid or malformed criteres JSON returns a 400 error","criteres array exceeds 20 conditions or 2048 URL-encoded characters — request rejected","Unknown champ or unsupported operator for a field returns a validation error","Payment not included or invalid x402 payment header results in a 402 response","Overly restrictive criteria combinations may return a count of zero (valid but empty result)","URL encoding issues with the criteres parameter may silently drop conditions"],"whenToPreferThis":"Use this endpoint when you need to size a French B2B market before building a full listing — it costs one cheap call ($0.002) and gives you an exact count against official pre-joined registry data. Prefer it over the listing endpoint when you only need the total count, not company details. Choose it over generic business databases when you need verified official French data (SIREN/SIRET, NAF, legal form, filed accounts, public signals like RGE or ICPE).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:41:53.027Z","isFirstParty":false,"canonicalSlug":"sirenic-french-company-count-99efddb8"}