# Marketplace Nvidia — 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 NVIDIA's marketplace for GPUs, laptops, desktops, and other hardware with detailed specifications, pricing, and availability across consumer and enterprise products. Filter by GPU model, brand, and current deals to find exactly what you're looking for.

**Category:** E-commerce | **Website:** [marketplace.nvidia.com/](https://marketplace.nvidia.com/) | **Docs:** [parse.bot/marketplace/b0931b49-9233-43a2-a532-4521ccaac9c8/marketplace-nvidia-com-api](https://parse.bot/marketplace/b0931b49-9233-43a2-a532-4521ccaac9c8/marketplace-nvidia-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-marketplace-nvidia-com-api-b0931b49/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_deals

Get current marketplace products including those with active promotions and bundles. Returns all available discounted products with offer information (isOffer flag and offerText describing current promotions). Results are paginated at 9 per page.

**Estimated cost:** Metered

_No parameters required._

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

### get_homepage_categories

Get all top-level product categories from the NVIDIA marketplace. Returns a static curated list of category names, IDs, and URLs covering consumer and enterprise segments. No pagination; the full category set is returned in one call.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_detail

Fetch details for a specific product by its URL slug. Returns full product information including specifications, pricing, retailer links, and availability status. The slug is the last path segment of a product's internalLink URL returned by list or search endpoints. Also accepts a full internalLink URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | Product URL slug extracted from product internalLink URLs (e.g. 'msi-geforce-rtx-5080-16g-suprim-liquid-soc'). Also accepts the full internalLink URL. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-marketplace-nvidia-com-api-b0931b49/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_slug":"<string>"}'
```

### get_rtx_founders_edition_status

Check the current availability and stock status of NVIDIA Founders Edition GPUs listed on the marketplace. Returns pricing and in-stock or sold-out status for each Founders Edition model.

**Estimated cost:** Metered

_No parameters required._

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

### list_brands

List all available brands/manufacturers currently selling products on the NVIDIA marketplace. Extracted from the marketplace product filter metadata. Returns a flat list of brand name strings.

**Estimated cost:** Metered

_No parameters required._

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

### list_by_gpu_model

Return all products (GPUs, laptops, desktops) for a specific GPU model. Returns paginated results across all product categories that use the specified GPU. Up to 9 products per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gpu` | string | Yes | GPU model to filter by. |
| `limit` | integer | No | Requested results per page (API caps at 9 per page regardless of this value). |
| `page` | integer | No | Page number for pagination. |

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

### list_graphics_cards

List graphics cards from the NVIDIA marketplace with optional filters and sorting. Returns paginated product details including pricing, availability, retailer links, and specifications. The API returns up to 9 products per page regardless of requested limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `deals` | string | No | Filter by deal type. Only accepted value is 'Discounted'. |
| `gpu` | string | No | Filter by GPU model. Values include 'RTX 5090', 'RTX 5080', 'RTX 5070 Ti', 'RTX 5070', 'RTX 5060 Ti', 'RTX 5060'. |
| `limit` | integer | No | Requested results per page (API caps at 9 per page regardless of this value). |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-marketplace-nvidia-com-api-b0931b49/list_graphics_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deals":"<string>","gpu":"<string>","limit":"<integer>","page":"<integer>","sort":"<string>"}'
```

### search_marketplace

Search for products across the NVIDIA marketplace by keyword. Returns paginated results spanning all product categories (GPUs, laptops, desktops, monitors). Up to 9 products per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Requested results per page (API caps at 9 per page regardless of this value). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'RTX 5090', 'gaming laptop'). |

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