# Bizapedia — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for detailed business profiles and contact information from Bizapedia, including company details, employee data, and communication channels. Access comprehensive business intelligence to research companies and build targeted contact lists.

**Category:** Business Directories | **Website:** [bizapedia.com/](https://bizapedia.com/) | **Docs:** [parse.bot/marketplace/386e6869-c651-461a-abf5-9e082b9483a5/bizapedia-com-api](https://parse.bot/marketplace/386e6869-c651-461a-abf5-9e082b9483a5/bizapedia-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bizapedia/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get company details

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The company's URL slug as it appears in the Bizapedia URL path (e.g. 'genuine-parts-company', 'five-oaks-farm-of-georgia-llc'). |
| `state` | string | Yes | Two-letter US state code, lowercase (e.g. 'ga', 'tn'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bizapedia/get-company-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","state":"<string>"}'
```

### Get predefined companies

Retrieve business details for a predefined set of companies across Georgia and Tennessee. Returns an array of company profiles (or error objects for companies whose pages have been removed). Useful for bulk retrieval without needing to know individual slugs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bizapedia/get-predefined-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search companies

Search for companies by name. Note: Search is highly protected and may be blocked. direct details fetching is preferred if the slug is known.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | The company name to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/bizapedia/search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.