# Shopgoodwill — 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 Goodwill online listings to find items, view detailed product information, shipping costs, and bid history, plus explore categories and discover featured or newly listed items. Filter results with advanced search options to discover exactly what you're looking for across Goodwill's inventory.

**Category:** Marketplaces | **Website:** [shopgoodwill.com/](https://shopgoodwill.com/) | **Docs:** [parse.bot/marketplace/b25f5e39-d1ae-4352-b253-e66240c50c78/shopgoodwill-com-api](https://parse.bot/marketplace/b25f5e39-d1ae-4352-b253-e66240c50c78/shopgoodwill-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-shopgoodwill-com-api-b25f5e39/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_advanced_search_filters

Get all available search filters including the full category tree and seller/location list.

**Estimated cost:** Metered

_No parameters required._

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

### get_categories

Get all top-level categories with their subcategory children.

**Estimated cost:** Metered

_No parameters required._

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

### get_featured_items

Get featured items from the homepage gallery collection.

**Estimated cost:** Metered

_No parameters required._

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

### get_item_bid_history

Get the bid history for an item including bid summary and complete bid log.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The numeric item ID. |

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

### get_item_details

Get full details for a single auction item by its ID, including description, pricing, bid history, seller info, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The numeric item ID. |

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

### get_item_shipping

Get shipping information for an item including carrier, shipping price, and handling fees.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | The numeric item ID. |

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

### get_newly_listed

Get the most recently listed auction items, sorted by newest. Returns full search response with category metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID to filter by. 0 returns all categories. |
| `page` | integer | No | Page number (1-based). |
| `page_size` | integer | No | Results per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopgoodwill-com-api-b25f5e39/get_newly_listed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>","page_size":"<integer>"}'
```

### get_subcategories

Get subcategories for a given parent category ID. Returns the children array from the category tree.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `parent_category_id` | string | Yes | The parent category ID (from get_categories results). |

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

### search_listings

Search for items on shopgoodwill.com with filters. Returns paginated auction listings with category metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Category ID to filter by. 0 returns all categories. |
| `closed_auctions` | string | No | Include closed auctions. Accepted values: true, false. |
| `high_price` | string | No | Maximum price filter. |
| `low_price` | string | No | Minimum price filter. |
| `page` | integer | No | Page number (1-based). |
| `page_size` | integer | No | Results per page. |
| `query` | string | No | Search keyword. |
| `seller_id` | string | No | Seller ID to filter by. |
| `sort_column` | string | No | Sort column: 1 for ending soonest, 2 for newest listed. |
| `sort_descending` | string | No | Sort descending. Accepted values: true, false. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-shopgoodwill-com-api-b25f5e39/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","closed_auctions":"<string>","high_price":"<string>","low_price":"<string>","page":"<integer>","page_size":"<integer>","query":"<string>","seller_id":"<string>","sort_column":"<string>","sort_descending":"<string>"}'
```