djmag.com APIdjmag.com ↗
Fetch DJ Mag news articles, Top 100 DJs and Clubs rankings, club profiles, and keyword search via a single REST API. 6 endpoints, structured JSON.
curl -X GET 'https://api.parse.bot/scraper/36a7d072-f334-4343-9262-b1128ecca21c/get_latest_news?page=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the latest news articles from djmag.com, paginated. Returns a list of article teasers with title, URL, category, and thumbnail.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
{
"type": "object",
"fields": {
"page": "integer, the current page number",
"articles": "array of article teaser objects with title, url, category, thumbnail, and excerpt"
},
"sample": {
"data": {
"page": 0,
"articles": [
{
"url": "https://djmag.com/news/nia-archives-announces-new-album-emotional-junglist-shares-boys-blue-watch",
"title": "Nia Archives announces new album",
"excerpt": "",
"category": "News",
"thumbnail": "https://djmag.com/sites/default/files/styles/djm_23_961x540_jpg/public/2026-05/nia-archives-credit-iris-luz.jpg?itok=7YLrgXBJ"
}
]
},
"status": "success"
}
}About the djmag.com API
The DJ Mag API exposes 6 endpoints covering electronic music news, annual Top 100 DJ and club rankings, detailed club profiles, and article search. You can call get_latest_news to pull paginated article teasers with title, category, thumbnail, and excerpt, or use get_top100_djs to retrieve the full ranked list for any available year. Full article bodies, author names, tags, and publication dates are accessible through get_news_article.
News and Article Data
get_latest_news returns paginated article teasers from DJ Mag's main news feed. Each result includes title, url, category, thumbnail, and excerpt. Pass page (0-indexed integer) to walk through older results. To read a full piece, pass its url to get_news_article, which returns body, author, date, tags, subtitle, links (inline anchor text and hrefs), and any emails found in the article body. The search_articles endpoint accepts a query string and returns the same teaser shape, letting you filter the archive by keyword.
Top 100 Rankings
get_top100_djs and get_top100_clubs both accept an optional year parameter (e.g. '2024'). Each returns an array of ranked entries — rank, name, and profile_url — along with a year field confirming which edition was returned. These lists reflect DJ Mag's annual reader-voted rankings, which have been published continuously since 1993.
Club Profiles
get_top100_club_profile accepts a url from the profile_url field of get_top100_clubs results. It returns name, a bio text block, a structured info object whose keys vary by club (typically covering location, capacity, and founding details), and a links array of external social media URLs with their anchor text. This endpoint is the only one that returns structured venue metadata beyond the ranking list.
- Monitor the DJ Mag news feed and push new articles to a Slack or Discord channel using get_latest_news.
- Build a year-over-year DJ ranking tracker by comparing get_top100_djs results across multiple years.
- Aggregate club profile data (bio, location info, social links) from get_top100_club_profile to populate a venue database.
- Index full article text from get_news_article into a search engine or recommendation system for electronic music content.
- Search for coverage of a specific artist or event keyword using search_articles to compile press clippings.
- Track which categories (tech house, drum and bass, etc.) appear most in news teasers returned by get_latest_news.
- Extract external social links from club profiles to map online presence across the Top 100 Clubs list.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DJ Mag have an official developer API?+
What does get_news_article return beyond the article body?+
body string, the response includes title, subtitle, author, date, tags (an array of topic strings), links (an array of objects with text and href for inline anchors), and emails if any are present in the article text. Not all fields are guaranteed to be populated for every article — author and date are marked as available 'if available' in the schema.How far back do the Top 100 DJ and Club rankings go?+
year parameter on get_top100_djs and get_top100_clubs accepts strings like '2024' or '2025'. The API returns whatever year edition is available on DJ Mag's site for the requested year; not all historical years may resolve to a populated list. Testing specific year values is the reliable way to confirm coverage for a given edition.Does the API expose DJ profile pages, not just club profiles?+
get_top100_club_profile) but no equivalent endpoint for individual DJ profiles from the Top 100 DJs list, even though get_top100_djs returns profile_url fields for each entry. You can fork the API on Parse and revise it to add a DJ profile endpoint that reads those URLs.Can I retrieve articles filtered by category or tag, rather than by keyword search?+
get_latest_news returns the main news feed without category filtering, and search_articles filters by keyword only. You can fork the API on Parse and revise it to add category-specific listing endpoints.