# Back Market — 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 refurbished electronics across Back Market's catalog, compare pricing by condition, and read seller and product reviews to find the best deals. Filter by product categories and access detailed information about listings to make informed purchasing decisions.

**Category:** E-commerce | **Website:** [backmarket.com/](https://backmarket.com/) | **Docs:** [parse.bot/marketplace/f60c9c20-fdd6-4b31-a722-1fb352430188/backmarket-com-api](https://parse.bot/marketplace/f60c9c20-fdd6-4b31-a722-1fb352430188/backmarket-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-backmarket-com-api-f60c9c20/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieves the list of top product categories with their UUIDs and URL slugs. Returns a static list of major device categories available on Back Market US. Useful as a reference for the category taxonomy; UUIDs are not needed for other endpoints but slugs help build product page URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Retrieve detailed product information by UUID, including available conditions (grades), storage options, colors, current pricing, merchant/seller info, and shipping details. The selectedOffer contains the current best offer with full pricing and shipping breakdown. The merchant object includes the merchantId needed for get_seller_reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_uuid` | string | Yes | The UUID of the product (from search_products results id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_uuid":"<string>"}'
```

### get_product_pricing

Get pricing for different condition grades (Fair, Good, Excellent, Premium), storage capacities, and color options for a product. Returns all available picker groups with per-item pricing. This calls the same underlying data as get_product_details but returns only the pricing-relevant fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_uuid` | string | Yes | The UUID of the product (from search_products results id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_product_pricing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_uuid":"<string>"}'
```

### get_product_reviews

Get customer reviews for a specific product. Extracts reviews from the product page's server-rendered data. Returns up to page_size reviews (limited by SSR payload, typically 7-8 reviews). Each review includes rating, comment, product info, customer name, and seller details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_size` | integer | No | Maximum number of reviews to return (limited by SSR payload availability, typically up to 8) |
| `product_uuid` | string | Yes | The UUID of the product (from search_products results id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_size":"<integer>","product_uuid":"<string>"}'
```

### get_seller_reviews

Get customer reviews for a specific seller/merchant. Returns paginated reviews across all products sold by the seller, including review text, rating, product info, and customer name. Pagination uses cursor-based navigation via the next/previous URLs in the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page_size` | integer | No | Number of reviews per page |
| `seller_uuid` | string | Yes | The UUID of the seller (from get_product_details merchant.merchantId field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_seller_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_size":"<integer>","seller_uuid":"<string>"}'
```

### get_sweden_laptop_prices

Retrieve paginated laptop listings from the Back Market Sweden storefront (backmarket.se). Returns products from the Bärbara datorer (laptops) category with prices in SEK. Pagination is zero-based via the page parameter; each page returns up to limit results. Each hit includes a product UUID usable with get_product_details/get_product_pricing (country='se') and a direct product page URL on backmarket.se.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page |
| `page` | integer | No | Page number, 0-indexed |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_sweden_laptop_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_sweden_smartphone_prices

Retrieve paginated smartphone listings from the Back Market Sweden storefront (backmarket.se). Returns products from the Mobiltelefoner (smartphones) category with prices in SEK. Pagination is zero-based via the page parameter; each page returns up to limit results. Each hit includes a product UUID usable with get_product_details/get_product_pricing (country='se') and a direct product page URL on backmarket.se.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page |
| `page` | integer | No | Page number, 0-indexed |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_sweden_smartphone_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_sweden_tablet_prices

Retrieve paginated tablet listings from the Back Market Sweden storefront (backmarket.se). Returns products from the Surfplattor (tablets) category with prices in SEK. Pagination is zero-based via the page parameter; each page returns up to limit results. Each hit includes a product UUID usable with get_product_details/get_product_pricing (country='se') and a direct product page URL on backmarket.se.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page |
| `page` | integer | No | Page number, 0-indexed |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backmarket-com-api-f60c9c20/get_sweden_tablet_prices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### search_products

Search for refurbished products by keyword using Algolia. Returns paginated results with product listings including price, brand, model, and image. Pagination is zero-based. Each hit includes a product UUID (id field) that can be passed to get_product_details or get_product_pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page |
| `page` | integer | No | Page number, 0-indexed |
| `query` | string | Yes | Search keyword (e.g. 'iPhone 13', 'MacBook', 'Samsung Galaxy') |

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

### search_sweden_smartphones_with_pricing

Search the Back Market Sweden smartphones category by keyword and return hits with per-product condition-grade pricing (Fair/Good/Excellent/Premium) nested inline. Combines a keyword search filtered to Swedish smartphones (cat_id:2) with a pricing fetch per hit. Each result includes the product's full pricing breakdown by condition grade, storage, and color options with prices in SEK, plus a direct product page URL on backmarket.se. Work scales linearly with limit (one pricing fetch per hit). Requires a Cloudflare warmup navigation to backmarket.se before pickers calls succeed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of product hits to return, each with full pricing fetched inline. |
| `query` | string | Yes | Search keyword within the Swedish smartphones category (e.g. 'iPhone', 'Samsung Galaxy') |

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