# w14n.dev Data API

> High-performance structured open data APIs for Brazilian business intelligence, CNAE establishment counts, historical vehicle depreciation, and geographic coordinates.

Note: All datasets are partial samples. No authentication is required. The API is free during the test period, may change.

## Endpoints

### 1. Company Profile Lookup
- **URL**: `GET /api/v1/company/{cnpj}`
- **Description**: Look up a Brazilian company by CNPJ in agribusiness, mining and meat-processing sectors. Returns status, size, share capital, activity and location.
- **Example**: https://w14n.dev/api/v1/company/00043463000483
- **Example with punctuation**: https://w14n.dev/api/v1/company/02.591.772/0001-70

### 2. Economic Activity Establishments by Municipality
- **URL**: `GET /api/v1/analytics/cnae/{cnae}/municipalities?state={UF}`
- **Description**: Count active establishments of a Brazilian economic activity (CNAE) by municipality, with age and size mix.
- **Supported CNAEs**: 0115600 (Soybean), 0134200 (Coffee), 0710301 (Iron ore), 0710302 (Pelletizing), 1011201 (Beef slaughter), 1012101 (Poultry processing).
- **Example**: https://w14n.dev/api/v1/analytics/cnae/0115600/municipalities?state=MT

### 3. Economic Activity State Totals
- **URL**: `GET /api/v1/analytics/cnae/{cnae}/states`
- **Description**: State-level totals and municipality counts for a supported Brazilian economic activity.
- **Example**: https://w14n.dev/api/v1/analytics/cnae/0115600/states

### 4. Vehicle Depreciation History (FIPE)
- **URL**: `GET /api/v1/fipe/{fipe_code}/depreciation`
- **Description**: Historical year-over-year depreciation of Brazilian vehicle prices (FIPE), up to Sep 2023.
- **Example**: https://w14n.dev/api/v1/fipe/001001-4/depreciation

### 5. Geographic Municipality Resolver
- **URL**: `GET /api/v1/geo/municipality?name={name}&state={UF}`
- **Description**: Resolve a Brazilian municipality name and state to coordinates.
- **Example**: https://w14n.dev/api/v1/geo/municipality?name=Sorriso&state=MT
- **Example DF region**: https://w14n.dev/api/v1/geo/municipality?name=plano-piloto&state=DF

## Machine-Readable Specifications
- OpenAPI 3.1: https://w14n.dev/api/v1/openapi.json
- Full Context: https://w14n.dev/llms-full.txt