regdata_polish_regon
Fetch Polish company data from GUS REGON by NIP, REGON, or KRS. Get PKD codes, local units, and full reports anonymously without an API key.
Instructions
Polish REGON Scraper - GUS Business Registry (no API key). Scrape Poland's REGON (GUS) registry anonymously: look up by NIP/REGON/KRS, discover companies by address + PKD, and get local units (jednostki lokalne) as separate rows. No API key required. Advanced fields beyond this schema are also accepted (regdata_describe lists them).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fetchPkd | No | Additionally fetch each entity's PKD activity codes (main + secondary). | |
| maxItems | No | Optional cap on billed dataset items returned. | |
| pkdCodes | No | Keep only records whose PKD code starts with one of these (e.g. "10", "62.01"). Requires fetchPkd. | |
| pkdMatch | No | 'main' = only the main (przeważająca) PKD must match; 'any' = any reported PKD may match. | any |
| legalForms | No | Keep only entities whose legal form contains one of these phrases (e.g. "spółka z ograniczoną", "spółka akcyjna"). | |
| maxResults | No | Maximum records to emit (0 = unlimited). Bounds cost on large regions. | |
| searchMode | No | How to look up companies: by NIP, REGON, or KRS number. | nip |
| identifiers | No | The NIP, REGON, or KRS numbers to look up (one search mode at a time). | |
| pkdSections | No | Keep only records with a PKD code in these PKD 2007 sections. C=Manufacturing, G=Trade, H=Transport, etc. Requires fetchPkd. | |
| minIntervalMs | No | Politeness delay between requests. The site allows ~3/s; keep >= 350ms to avoid the conditional CAPTCHA. | |
| fetchFullReport | No | Fetch each entity's full REGON report (legal form, ownership, dates, contact, full address). Adds one request per record. | |
| includeLocalUnits | No | Include each entity's local units (jednostki lokalne) as separate rows (recordType=LOCAL_UNIT, with parentRegon). |