# Put This On — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 articles on men's style and fashion from Put This On, including the ability to browse content by specific authors or find articles on particular topics. Quickly access detailed article information and explore all contributions from your favorite fashion writers on the platform.

**Category:** News & Media | **Website:** [putthison.com/](https://putthison.com/) | **Docs:** [parse.bot/marketplace/e3703f8a-7303-4c81-ad76-7610754cfc63/putthison-com-api](https://parse.bot/marketplace/e3703f8a-7303-4c81-ad76-7610754cfc63/putthison-com-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/put-this-on/`
**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 article

Get the full content of a single article by its URL slug. Returns complete article data including HTML content, author information, categories, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article URL slug (e.g. 'boots-gunboats-for-dads-grads'). Available from search_articles results. |

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

### Get author articles

Get articles written by a specific author, identified by their URL slug. Returns paginated article listings and basic author information extracted from post metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `author_slug` | string | Yes | Author URL slug (e.g. 'derek'). Available from search_articles or get_article results as author_slug. |
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (1-100). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/put-this-on/get-author-articles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"author_slug":"<string>","page":"<integer>","per_page":"<integer>"}'
```

### Search articles

Search articles by keyword query. Returns paginated results with article metadata including title, date, excerpt, author, categories, and tags. Results are ordered by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `per_page` | integer | No | Number of results per page (1-100). |
| `query` | string | Yes | Search query string (e.g. 'shoes', 'leather jacket'). |

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

## Next steps

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