Business Registry & Ownership Intel - KYB, Officers
Pricing
from $8.00 / 1,000 company records
Unifies US Secretary-of-State business registries into one normalized entity schema: status, type, formation date, registered agent, officers, addresses. KYB value layer: cross-state entity resolution, officer linking, and an ownership graph. Logged-out public records. For KYB/AML and PE/M&A.
patchright, bundled) in headful mode, which passes the Cloudflare/Imperva managed challenges that block plain headless Chromium (verified live). For Cloudflare-fronted JSON APIs it calls the API from inside the warmed page via fetch() so the request carries cf_clearance + the real browser TLS (a Playwright APIRequestContext does not - it 403s).coverage: full, validated end-to-end through the actor (PA: bizfile POST API in-page; MI: webSearch GET API in-page; both return real entities, MI with agents). Fully-parsed count: 11 http + PA + MI = 13.BROWSER_HEADLESS override (default headful, required to pass Cloudflare); GET support in the api-recipe mode; do not override the browser user_agent (keeps patchright's stealth fingerprint consistent). via: "browser" tags browser-sourced rows.browser_cdp_url input or BROWSER_CDP_URL env) - inheriting its session/fingerprint to pass the Cloudflare/Imperva managed-challenge states (PA, OH, NC, MI, NV, ...) that block a plain headless Chromium. Falls back to launching headless when unset.browser_search: navigate -> fill -> (optional CAPTCHA solve) -> submit -> capture the search XHR JSON or rendered HTML, plus an api-after-warmup mode (PA replays the bizfile JSON API on the cf_clearance'd session). PA + AZ have specific recipes; the other passable SPA states use a generic search-and-extract recipe (rows tagged parse_confidence: "generic").captcha_solver.py, off by default): set CAPTCHA_SOLVER_PROVIDER (2captcha|capsolver) + CAPTCHA_SOLVER_KEY env secrets to clear the per-search-CAPTCHA states (AZ worked example). Genuinely gated states (CAPTCHA/login/Enterprise-reCAPTCHA: GA, NE, SC, LA, WY, DC, DE, VA) stay fail-soft with documented reasons and make no doomed generic attempt.access_notes.browser_tier reports whether the CDP endpoint + solver are configured. Validated end-to-end on the real runtime: OR returns data; PA/OH execute the browser tier (0 rows headless without the warm browser -> fail-soft); AZ reports "CAPTCHA-gated, solver disabled"; GA stays pending. The actor now ships playwright so the CDP path works in production.RegistryClient.fetch_form_flow runs the GET + POST on one cookie-persistent session so the __RequestVerificationToken round-trips). NJ free path returns name/id/city/type/formation date; status/agent/officers are paid and kept out of scope (like TX/DE). Fully-parsed set is now CA, NY, FL, TX, CO, CT, OR, WI, NJ, ID, ND (11).http_json to browser_required.browser_fetch fetched FL Sunbiz headless and parsed 20 real entities. But no browser_required state is cleanly automatable headless (PA/OH/GA/NC/MI Cloudflare managed challenge blocks headless Chromium; AZ search CAPTCHA; VA/NV/NE/SC/LA/WY reCAPTCHA/Imperva; DC login) - per the no-CAPTCHA/no-login posture these stay fail-soft with documented reasons.hold -> suspended (OH), dead -> dissolved (OH), past due -> suspended (IN).tckn-sxa6 - multi-row-per-entity, grouped by registry_number to assemble agent + principal + mailing + authorized representatives) and WI (Wisconsin DFI Corporate Records - plain GET HTML, no ViewState). Fully-parsed set is now CA, NY, FL, TX, CO, CT, OR, WI, ID, ND (10).browser_required (SPA / Imperva / CAPTCHA / login), corrected portal URLs (KS -> sos.ks.gov/eforms, UT -> secure.utah.gov/bes), and recorded why each http_json-pending state can't be name-searched (IA Socrata 404 post-migration; MI TLS; MS Kendo filter returns the full DB; MT API 500s).BizFilePlatformConnector. Fully-parsed set is now CA, NY, FL, TX, CO, CT, ID, ND (8).browser_required (Cloudflare JS-challenge or SPA - need the Playwright residential tier: AK, AZ, DC, DE, GA, HI, NC, NM, NV, OH, PA, SC, VA, WA), 27 http_html ViewState-pending (need a per-state POST+ViewState builder), 2 http_json pending (MI TLS, MT API 500s). Per-state cost_note now states the specific blocker.tests/fixtures/.registry_client: httpx (datacenter) -> curl_cffi Chrome TLS impersonation (residential) -> optional Playwright headless browser (residential) -> fail-soft fetch_error. Defeats the TLS/JA3-fingerprint WAFs registries use (verified: FL Sunbiz 403s plain httpx but returns 200 + real data via curl_cffi from the same IP).use_browser_fallback input (default on). Per-tier escalation telemetry in access_notes.anti_bot_escalation.state_pending note). New states: ["ALL"] / all_states to query every jurisdiction.entity_search, entity_profile, officer_lookup, ownership_graph.entity_cluster rollups, officer-to-company linking with multi_entity flag, and an inferred ownership/association graph (shared officer/agent/address/name-root edges + connected components).difflib fallback (no hard dependency).fetch_error with per-state access notes; access_notes record with the live access matrix on every run; Delaware gated off by default (never spends its per-search fee silently); proxy auto-selection (RESIDENTIAL when DE active, else DATACENTER)._RunBudget guard, demo-mode soft-fail, hardcoded PPE prices.