# Makitatools — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Find Makita power tools by searching product catalogs and comparing technical specifications, then locate authorized dealers or online retailers near you. Get detailed information on active model numbers to help choose the right tool for your project.

**Category:** E-commerce | **Website:** [makitatools.com/](https://makitatools.com/) | **Docs:** [parse.bot/marketplace/1cd51127-c1bf-403e-bcc0-421cb9f62c71/makitatools-com-api](https://parse.bot/marketplace/1cd51127-c1bf-403e-bcc0-421cb9f62c71/makitatools-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/makitatools/`
**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

### Find local dealers

Find Makita dealers and retailers near a geographic location. Returns dealers sorted by distance with name, address, phone, distance, and tool specialization. Latitude and longitude are strongly recommended for accurate results; providing only a ZIP code may yield empty results from the upstream API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | string | No | Latitude for precise location (e.g., '40.7128') |
| `lon` | string | No | Longitude for precise location (e.g., '-74.0060') |
| `radius` | integer | No | Search radius in miles |
| `zip_code` | string | Yes | ZIP code for the search area (e.g., '10001') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/makitatools/find-local-dealers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<string>","lon":"<string>","radius":"<integer>","zip_code":"<string>"}'
```

### Get active model numbers

Retrieve a list of all active Makita model numbers, optionally filtered by product type. Returns a flat array of model number strings. Useful for enumerating the full catalog or feeding model numbers into get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_type` | integer | No | Product type filter. 0 returns all types (~6400 models), 1 returns cordless/power tools (~4400 models). Other integer values are accepted but may return empty results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/makitatools/get-active-model-numbers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_type":"<integer>"}'
```

### Get online retailers

Retrieve all authorized Makita online retailers with their website links. No parameters required. Returns the complete list of authorized e-commerce partners.

**Estimated cost:** Metered

_No parameters required._

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

### Get product details

Retrieve comprehensive product details for a single Makita product by model number. Includes specifications, key features, documents (manuals, parts breakdowns), images, videos, and related model numbers. The model_number can be obtained from search_products or get_active_model_numbers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_number` | string | Yes | Product model number (e.g., 'GPH03Z', 'XFD131') |

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

### Search products

Full-text search across Makita's product catalog by keyword. Returns product summaries including model number, title, description, images, and status badges. Useful for discovering products before fetching full details. Results are not paginated; the full matching set is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'drill', 'saw', 'impact') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/makitatools/search-products \
  -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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.