Bizapedia APIbizapedia.com ↗
Access Bizapedia company profiles via API. Get state filing details, registered agent info, principal addresses, and contacts for US businesses.
What is the Bizapedia API?
The Bizapedia API provides access to US business profile data across 3 endpoints, returning fields like file number, filing date, filing status, registered agent, principal address, and associated contacts. The get_company_details endpoint is the primary workhorse — given a state code and company slug, it returns a structured profile pulled directly from Bizapedia's public company pages, covering both corporate filing metadata and named contacts with roles.
curl -X GET 'https://api.parse.bot/scraper/f1f62669-60b8-4b29-aa56-ebe8fe77d53f/get_company_details?slug=genuine-parts-company&state=ga' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bizapedia-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Bizapedia SDK — fetch company details and list predefined companies."""
from parse_apis.bizapedia_business_scraper_api import Bizapedia, State, CompanyNotFound
bizapedia = Bizapedia()
# Fetch a specific company by state and slug
company = bizapedia.companies.get(state=State.GA, slug="genuine-parts-company")
print(company.business_name, company.file_number)
print(company.filing_state, company.filing_status, company.filing_date)
print(company.principal_address)
print(company.registered_agent.name, company.registered_agent.address)
for contact in company.contacts:
print(contact.name, contact.role)
# Handle a company that no longer exists
try:
bizapedia.companies.get(state=State.GA, slug="nonexistent-company-xyz")
except CompanyNotFound as exc:
print(f"Company not found: {exc}")
# List predefined companies (bulk retrieval)
for item in bizapedia.companies.list_predefined(limit=5):
print(item.business_name, item.filing_state, item.filing_status)
print("exercised: companies.get / companies.list_predefined / CompanyNotFound error handling")
Fetch detailed business information for a specific company by state and URL slug. Returns filing details, principal address, registered agent, and contacts extracted from the company's public profile page. The slug is the URL path component for the company on Bizapedia (e.g. 'genuine-parts-company'). A 410/404 means the company page no longer exists.
| Param | Type | Description |
|---|---|---|
| slugrequired | string | The company's URL slug as it appears in the Bizapedia URL path (e.g. 'genuine-parts-company', 'five-oaks-farm-of-georgia-llc'). |
| staterequired | string | Two-letter US state code, lowercase (e.g. 'ga', 'tn'). |
{
"type": "object",
"fields": {
"url": "string, full URL of the company page",
"contacts": "array of objects with 'name' (string) and 'role' (string or null) fields",
"file_number": "string, state filing number",
"filing_date": "string, date of filing in YYYY-MM-DD format",
"filing_state": "string, two-letter state code",
"business_name": "string, official business name",
"filing_status": "string, current filing status",
"registered_agent": "object with 'name' (string) and 'address' (string) fields",
"principal_address": "string, formatted principal business address"
},
"sample": {
"data": {
"url": "https://www.bizapedia.com/ga/genuine-parts-company.html",
"contacts": [
{
"name": "John Doe",
"role": null
},
{
"name": "Jane Doe",
"role": null
},
{
"name": "John Doe",
"role": null
}
],
"file_number": "J505042",
"filing_date": "1928-05-07",
"filing_state": "GA",
"business_name": "Genuine Parts Company",
"filing_status": "Active/Owes Current Year AR",
"registered_agent": {
"name": "CT CORPORATION",
"address": "106 Colony Park Drive Ste. 800-B, Cumming, GA, 30040"
},
"principal_address": "2999 Wildwood Parkway, Atlanta, GA, 30339"
},
"status": "success"
}
}About the Bizapedia API
What the API Returns
The core endpoint, get_company_details, takes two required parameters — slug (the URL path component identifying the company on Bizapedia, e.g. genuine-parts-company) and state (a lowercase two-letter US state code, e.g. ga). It returns a structured object with business_name, file_number, filing_date (YYYY-MM-DD), filing_status, filing_state, principal_address, a registered_agent object containing name and address, and a contacts array where each entry carries a name and optional role.
Search and Bulk Retrieval
The search_companies endpoint accepts a query string (company name) and returns a results array of matches. Note that search on Bizapedia is heavily rate-limited and may not return results consistently; direct lookup via get_company_details is more reliable when you already know the slug. The get_predefined_companies endpoint requires no inputs and returns profiles for a fixed set of companies across Georgia and Tennessee — useful for testing or bulk retrieval of a known company list without needing individual slugs. Companies whose pages have been removed return error objects in the results array rather than silently dropping entries.
Coverage and Scope
Data reflects the public company profiles on Bizapedia, which aggregates US state business registry information. Current endpoint coverage spans Georgia and Tennessee for the predefined set, while get_company_details works for any state where Bizapedia has a public profile. The contacts array surfaces names and roles as listed on the profile page — the depth varies by company and state filing practices.
The Bizapedia API is a managed, monitored endpoint for bizapedia.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bizapedia.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bizapedia.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Look up registered agent name and address for a US company before initiating legal correspondence
- Verify a company's current filing status and state file number for due diligence workflows
- Build a contact list from the
contactsarray for companies in a specific state - Cross-reference principal address data against your CRM for account enrichment
- Retrieve filing dates to calculate how long a business has been active
- Bulk-fetch profiles for a known set of Georgia and Tennessee businesses using
get_predefined_companies
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bizapedia have an official developer API?+
What does the `registered_agent` field contain?+
name (the registered agent's name) and address (their full formatted address). Both reflect what Bizapedia displays on the company's public profile page.How reliable is the `search_companies` endpoint?+
get_company_details directly is significantly more reliable.Does the API cover companies in all 50 US states?+
get_company_details works for any state where Bizapedia has a public profile, using any lowercase two-letter state code. The get_predefined_companies endpoint currently returns data only for a fixed set of companies in Georgia and Tennessee. You can fork this API on Parse and revise it to expand the predefined list to other states.