# Getcollectr — 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 retrieve detailed information about collectible trading cards and sealed products, including current market prices, historical price trends, and grading data to track and compare your collection's value. Find specific cards or products quickly and access comprehensive market insights to make informed collecting and trading decisions.

**Category:** Marketplaces | **Website:** [app.getcollectr.com/](https://app.getcollectr.com/) | **Docs:** [parse.bot/marketplace/e9b4ef46-2252-4f98-829e-b4dc96816aa8/app-getcollectr-com-api](https://parse.bot/marketplace/e9b4ef46-2252-4f98-829e-b4dc96816aa8/app-getcollectr-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-app-getcollectr-com-api-e9b4ef46/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Retrieve full details for a specific product by its numeric ID. Returns comprehensive information including market price, price change, description, price history across grades, ungraded and graded sub-type pricing, and available product variants. Grade entries include resolved human-readable labels (grading_company, grade_label, grade_value) from Collectr's grading taxonomy. When grade_id is provided, graded_sub_types and price_history are filtered to only entries matching that grade (price_history sorted most recent first, capped at ~30 entries). When grading_company is provided, graded_sub_types and price_history are filtered to only entries from that grading company (e.g. PSA, BGS, CGC). Both filters may be combined.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grade_id` | string | No | Grade ID to filter graded_sub_types and price_history. When provided, only entries matching this grade are returned. Available grade IDs can be found in the graded_sub_types array of an unfiltered response. |
| `grading_company` | string | No | Grading company symbol to filter graded_sub_types and price_history (e.g. 'PSA', 'BGS', 'CGC', 'TAG', 'ACE', 'AGS'). Case-insensitive. |
| `product_id` | string | Yes | Numeric product ID from the Collectr catalog (e.g. from search_products results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-getcollectr-com-api-e9b4ef46/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grade_id":"<string>","grading_company":"<string>","product_id":"<string>"}'
```

### get_products_bulk

Retrieve trimmed product details for multiple products in a single call. Accepts a comma-separated list of product IDs. Returns an array of results in the same order as input IDs. Each item contains core pricing and grading data (no price_history). Grade entries include resolved human-readable labels (grading_company, grade_label, grade_value). If a product_id is invalid or not found, its entry contains product_id and an error message instead of failing the whole batch. When grade_id is provided, graded_sub_types are filtered to only entries matching that grade. When grading_company is provided, graded_sub_types are filtered to only entries from that grading company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `grade_id` | string | No | Grade ID to filter graded_sub_types. When provided, only graded entries matching this grade are returned. |
| `grading_company` | string | No | Grading company symbol to filter graded_sub_types (e.g. 'PSA', 'BGS', 'CGC', 'TAG', 'ACE', 'AGS'). Case-insensitive. |
| `product_ids` | string | Yes | Comma-separated list of numeric product IDs (e.g. '252737,10010041,610516'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-app-getcollectr-com-api-e9b4ef46/get_products_bulk \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grade_id":"<string>","grading_company":"<string>","product_ids":"<string>"}'
```

### search_products

Search the Collectr catalog for trading cards and sealed products by name. Returns matching products with basic metadata including category, set, card number, and rarity. Results are paginated via offset/limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return per request. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | Yes | Search query string to match against product names. |

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