# Getfpv — 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 browse products from GetFPV's catalog of FPV drone components and accessories. Retrieve listings by keyword or category, view detailed product specifications, pricing, and stock status, and explore new arrivals and current sales.

**Category:** E-commerce | **Website:** [getfpv.com/](https://getfpv.com/) | **Docs:** [parse.bot/marketplace/d4644fc5-bc0c-47b4-ad80-70c1f13a8c84/getfpv-com-api](https://parse.bot/marketplace/d4644fc5-bc0c-47b4-ad80-70c1f13a8c84/getfpv-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/getfpv/`
**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 category products

Retrieve paginated product listings for a specific category. Category can be a top-level name like 'Electronics' or a multi-level path using ' /// ' as separator (e.g. 'Electronics /// Flight Controllers'). Omitting category returns all products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category name or hierarchical path using ' /// ' as separator between levels (e.g. 'Electronics', 'Electronics /// Flight Controllers'). Omitting returns all products. |
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Get flight controllers

Retrieve paginated flight controller product listings from the 'Electronics /// Flight Controllers' category. Convenience endpoint equivalent to get_category_products with category='Electronics /// Flight Controllers'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/get-flight-controllers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get motors

Retrieve paginated motor product listings from the 'Motors' category. Convenience endpoint equivalent to get_category_products with category='Motors'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/get-motors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get new products

Retrieve the newest products added to the store from the 'New Products' category. Returns paginated results ordered by recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/get-new-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get product details

Fetch full details for a single product by URL including specifications, images, description, and pricing. The URL can be a full product page URL or just the slug path (e.g. 'product-name.html'). Returns structured data including product name, SKU, brand, formatted price, stock status, description text, specification key-value pairs, and image URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL (e.g. 'https://www.getfpv.com/product-name.html') or slug path (e.g. 'product-name.html'). Obtain from search_products or category listing results. |

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

### Get sale products

Retrieve products currently on sale from the 'On Sale' category. Returns paginated results of discounted items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/get-sale-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Search products

Full-text search across all product categories. Returns paginated product listings matching the query keyword. Each result includes name, SKU, price, stock status, URL, thumbnail, brand, and category hierarchy. Paginated zero-indexed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number (zero-indexed). |
| `query` | string | Yes | Search keyword to match against product names and descriptions. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/getfpv/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","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.