# Resellerratings — 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 for trusted retailers and explore thousands of verified store reviews, ratings, and detailed seller information to make informed shopping decisions. Browse product categories, read reviewer profiles, and access business highlights to compare stores before you buy.

**Category:** Reviews & Ratings | **Website:** [resellerratings.com/](https://resellerratings.com/) | **Docs:** [parse.bot/marketplace/aa1884b1-95c6-45a8-8a2f-96e131430c8a/resellerratings-com-api](https://parse.bot/marketplace/aa1884b1-95c6-45a8-8a2f-96e131430c8a/resellerratings-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-resellerratings-com-api-aa1884b1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_reviewer_profile

Get a reviewer's public profile including their review history, favorite and worst stores, avatar URL, join date, and total review count. Usernames are found in review objects from get_store_reviews or get_store_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Username of the reviewer as shown on reviews. |

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

### get_store_business_highlights

Get detailed business highlights for a store including available shipping methods, payment options, refund policies, security certifications, contact information, and category rankings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `seller_id` | string | Yes | Internal numeric ID of the seller, found in get_store_details response at databaseId. |

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

### get_store_details

Get full details for a specific store including seller info, ratings distribution (lifetime, yearly, six-month), pagination metadata, comparison suggestions, and the first page of reviews. The store slug is case-sensitive and matches the seoName field from search or category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_slug` | string | Yes | Case-sensitive SEO slug of the store as found in search results or category listings (matches the seoName field). |

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

### get_store_reviews

Retrieve a page of customer reviews for a specific store. Each review includes star rating, title, comment text, date, reviewer username, and location. Returns 15 reviews per page, ordered by date descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based). |
| `store_slug` | string | Yes | Case-sensitive SEO slug of the store. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-resellerratings-com-api-aa1884b1/get_store_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","store_slug":"<string>"}'
```

### list_categories

List all top-level store categories available on the platform. Returns category names, SEO slugs, database IDs, and image paths. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### list_stores_by_category

Get a specific category's metadata and its child subcategories. Returns the category's name, seller count, and an array of subcategories each with their own seller counts and SEO slugs for further navigation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | SEO slug of the category as returned by list_categories in the seoname field. |

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

### search_stores

Full-text search across all stores on ResellerRatings. Returns matching store records with numeric IDs, category facet counts, and total results found. Each record includes the store's numeric ID usable for further lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against store names and descriptions. |

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