# Naco — 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 and explore detailed U.S. county government information, including profiles, economic indicators, funding data, and research resources all in one place. Quickly access bulk county statistics and NACo insights to support planning, analysis, and decision-making at the local government level.

**Category:** Government & Public Data | **Website:** [naco.org/](https://naco.org/) | **Docs:** [parse.bot/marketplace/f539d0a1-c7b3-4071-9d52-c81b2430ecb4/naco-org-api](https://parse.bot/marketplace/f539d0a1-c7b3-4071-9d52-c81b2430ecb4/naco-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-naco-org-api-f539d0a1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_county_profile

Retrieve a full profile for a specific county by its 5-digit FIPS code. Returns government structure, demographics, economy, historical census population, and contact information. Returns input_not_found if the FIPS code does not match any county.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fips` | string | Yes | 5-digit FIPS code of the county (e.g., '06037' for Los Angeles County, '36061' for New York County). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-naco-org-api-f539d0a1/get_county_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fips":"<string>"}'
```

### get_indicator_data

Retrieve bulk indicator data for all ~3,000 U.S. counties in a single request. Each request takes one dataset database name and one indicator name. The response includes FIPS code and indicator value per county. The upstream API may return a 500 for invalid dataset/indicator combinations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dataset_db` | string | Yes | Database name for the dataset. |
| `indicators` | string | Yes | Indicator database name. Must match the dataset_db. Confirmed working combinations: 'FED_PILT_Allocation' with 'Federal_Funding', 'ECON_GDP_Growth' with 'County_Economy'. Only one indicator per request is reliably supported. |
| `year` | integer | No | The year for which to retrieve data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-naco-org-api-f539d0a1/get_indicator_data \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dataset_db":"<string>","indicators":"<string>","year":"<integer>"}'
```

### search_counties

Search for U.S. counties by name, state abbreviation, or FIPS code substring. Returns matching counties sorted alphabetically by state then name. Omitting the query returns all ~3,100 counties. The search is case-insensitive and matches against county name, state abbreviation, and FIPS code.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | No | Search keyword matching county name, state abbreviation, or FIPS code substring. Omitting returns all counties. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-naco-org-api-f539d0a1/search_counties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

### search_resources

Search NACo resources including reports, toolkits, policy documents, and videos. Supports filtering by keyword, topic ID, and resource type ID. Returns paginated results (10 per page) with facet metadata for available filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed). |
| `query` | string | No | Search keyword for full-text search across resource titles and content. |
| `resource_type` | string | No | Filter by resource type ID. Values available from the facets in the response meta. Examples: '19' (Reports & Toolkits), '17' (Policy Document), '21' (Video), '22' (Education On-Demand). |
| `topic` | string | No | Filter by topic ID. Values available from the facets in the response meta. Examples: '37' (Health), '38' (Housing), '41' (Justice & Public Safety), '53' (Transportation & Infrastructure). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-naco-org-api-f539d0a1/search_resources \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","resource_type":"<string>","topic":"<string>"}'
```