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

> Access the latest DJ and electronic music news, discover rankings of the world's top 100 DJs and clubs, view detailed club profiles, and search through DJ Mag's extensive article archive. Stay updated on the electronic music scene with curated features, news updates, and industry insights all in one place.

**Category:** Music | **Website:** [djmag.com/](https://djmag.com/) | **Docs:** [parse.bot/marketplace/c50b81e2-ef16-4688-8eb7-a08b7280cfa1/djmag-com-api](https://parse.bot/marketplace/c50b81e2-ef16-4688-8eb7-a08b7280cfa1/djmag-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-djmag-com-api-c50b81e2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_latest_news

Fetch the latest news articles from djmag.com, paginated. Returns article teasers with title, URL, category, and thumbnail. Page 0 is the most recent. Each page returns approximately 15-20 articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-djmag-com-api-c50b81e2/get_latest_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_news_article

Fetch the full content of a news or feature article by its URL. Returns title, body text, author, date, tags, and inline links. The url field in the response echoes the requested article URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the article on djmag.com (e.g. from get_latest_news results' url field). |

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

### get_top100_club_profile

Fetch details for a club profile page. Returns the club name, structured info fields, bio text, and external social media links. The url field echoes the requested profile URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the club profile on djmag.com (from get_top100_clubs results' profile_url field). |

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

### get_top100_clubs

Retrieve the Top 100 Clubs list for a given year. Returns ranked club entries with name and profile URL. The list is extracted from DJ Mag's annual clubs poll results page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Year of the Top 100 Clubs list (e.g. '2024', '2025'). |

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

### get_top100_djs

Retrieve the Top 100 DJs list for a given year. Returns ranked DJ entries with name and profile URL. The list is extracted from DJ Mag's annual poll results page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Year of the Top 100 DJs list (e.g. '2024', '2025'). |

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

### search_articles

Search for articles on djmag.com by keyword. Returns a list of matching article teasers. Results are not paginated; a single page of matches is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword or phrase. |

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