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

> Browse the latest sneaker news, search articles by keyword, and look up upcoming release dates — including pricing, images, and retailer links. Also surfaces per-page ad slot inventory and density metrics for programmatic and publisher analysis.

**Category:** News & Media | **Website:** [sneakernews.com/](https://sneakernews.com/) | **Docs:** [parse.bot/marketplace/2ad8a13c-cb3e-4d04-8b16-915e187e4ac4/sneakernews-com-api](https://parse.bot/marketplace/2ad8a13c-cb3e-4d04-8b16-915e187e4ac4/sneakernews-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/sneakernews/`
**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 ad slot inventory

Analyze ad slot presence and density on a given sneakernews.com page. Returns detected GPT containers, iframe-based ad units, ad-related DOM elements, sticky and lazy-loaded units, density metrics, and a reader-experience risk assessment.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the sneakernews.com page to analyze (e.g. 'https://sneakernews.com' for homepage) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/get-ad-slot-inventory \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get article detail

Get detailed information about a specific article including full content, author, product metadata (SKU, price, release date when available), and Where to Buy retailer links. Product info and where_to_buy may be empty for articles that don't feature specific product releases.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the sneakernews.com article |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/get-article-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get latest news

Get latest sneaker news articles from the homepage. Returns articles sorted by recency with engagement scores. No pagination — returns the current homepage set (typically 5-10 articles).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/get-latest-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get release info by sku

Look up sneaker release information by exact SKU/style code. Searches SneakerNews release calendar pages (general and brand-specific) and article pages for the given SKU. Returns product details, release date, retailer-specific release times (only when explicitly stated on the source page), and retailer buy links. Release time fields are null when not explicitly listed. Returns null product fields and empty retailers array when no article matches the SKU.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Region filter for results (e.g. 'US') |
| `sku` | string | Yes | Exact SKU/style code to look up (e.g. 'IH1117-002', 'HV6474-601') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/get-release-info-by-sku \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>","sku":"<string>"}'
```

### Get sneaker release dates

Get upcoming and past sneaker release dates with pricing and images. Supports pagination via AJAX for pages beyond the first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/get-sneaker-release-dates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search articles

Search for articles by keyword. Supports multi-word queries and pagination. Returns matching articles ordered by relevance/recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword or phrase (e.g. 'jordan', 'nike dunk') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/sneakernews/search-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.