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

## Access

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

## 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.paywithlocus.com/api/wrapped/parse-putthison-com-api-e3703f8a/get_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-putthison-com-api-e3703f8a/get_author_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-putthison-com-api-e3703f8a/search_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","per_page":"<integer>","query":"<string>"}'
```