# Netshoes — 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 products on Netshoes.com.br by keyword or category. Retrieve detailed product information including specifications, pricing, available sizes and colors, customer reviews, and delivery estimates by ZIP code.

**Category:** E-commerce | **Website:** [netshoes.com/](https://netshoes.com/) | **Docs:** [parse.bot/marketplace/f3d8f995-7de0-4829-86af-33cb56fdff7c/netshoes-com-api](https://parse.bot/marketplace/f3d8f995-7de0-4829-86af-33cb56fdff7c/netshoes-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-netshoes-com-api-f3d8f995/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_delivery_estimate

Look up address information for a given Brazilian ZIP code (CEP). Returns the address details (street, neighborhood, city, state) associated with the CEP. The SKU parameter is required by the API but the response contains only address data; full delivery time/cost estimates require product dimensions not available through this endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU code (e.g. 'FB9-9335-205') |
| `zipcode` | string | Yes | Brazilian ZIP code (CEP), 8 digits (e.g. '01310100', '20040020') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-netshoes-com-api-f3d8f995/check_delivery_estimate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku":"<string>","zipcode":"<string>"}'
```

### get_product_details

Get full details for a specific product by its SKU code. Returns comprehensive product information including description, specifications, pricing, available color variants, size variants with per-size availability and pricing, and zoom images. The SKU code is the product identifier returned in search/category listing results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU code (e.g. 'FB9-9335-205') |

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

### get_product_listings_by_category

Retrieve product listings from a specific category path on Netshoes. Returns paginated results with available filter options for the category. The path corresponds to the URL path on the site (e.g. '/tenis/masculino').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `path` | string | Yes | Category path starting with '/' (e.g. '/tenis/masculino', '/tenis/feminino') |

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

### get_product_reviews

Retrieve customer reviews for a specific product by its SKU code. Reviews are aggregated across all color variants of the same product line (the base SKU without the color suffix). Returns rating distribution, individual reviews with comments, attribute surveys, and an AI-generated summary.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku` | string | Yes | Product SKU code (e.g. 'FB9-9335-205') |

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

### search_products

Full-text search over Netshoes product catalog. Returns paginated product listings matching the keyword query. Single brand-name queries (e.g. 'nike') may be redirected by the site to a brand landing page and return upstream_error; use more specific multi-word queries (e.g. 'nike tenis') for reliable results. Paginates via integer page parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (e.g. 'tenis', 'adidas running') |

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