# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-sneakernews-com-api-2ad8a13c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-sneakernews-com-api-2ad8a13c/get_ad_slot_inventory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-sneakernews-com-api-2ad8a13c/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-sneakernews-com-api-2ad8a13c/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-sneakernews-com-api-2ad8a13c/get_release_info_by_sku \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-sneakernews-com-api-2ad8a13c/get_sneaker_release_dates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-sneakernews-com-api-2ad8a13c/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```