# Resellerratings — 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.

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/resellerratings/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/get-reviewer-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/get-store-business-highlights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/get-store-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/get-store-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/list-stores-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/resellerratings/search-stores \
  -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.