# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-getfpv-com-api-d4644fc5/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/get_flight_controllers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/get_motors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/get_new_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/get_sale_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-getfpv-com-api-d4644fc5/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```