Salon API Documentation

First request

Endpoint

GET /salon/article

Cost

2 credits/request

curl -X GET "https://api.crawlora.net/api/v1/salon/article?url=https%3A%2F%2Fwww.salon.com%2F2026%2F09%2F23%2Ftrump-admin-spars-with-iran-at-un-meeting%2F" \
  -H "x-api-key: $CRAWLORA_API_KEY"

How to use Salon endpoints

Salon is a US progressive news and commentary magazine whose public editorial mix spans politics, culture, food, health, and science. A monitoring project should separate reported developments from analysis and opinion, because a contributor's interpretation is not the same thing as the underlying event. Its named sections and bylines supply the context needed to study how a topic moves from policy debate into cultural commentary. On 2026-10-25 the documented section list held 32 slugs, and not all are live: oscars_2012 returned 30 items, the newest published 2018-03-13, and the list also keeps sxsw_2013. A section slug is a feed tag that outlived its event, so check the newest date before you rely on it.

1. Step 1

   Test a section's newest date first

   Call /salon/sections, then request /salon/headlines for the slug you need and read the newest published_at. The oscars_2012 feed ran from 2017-01-24 to 2018-03-13 and mixed Oscar coverage with a Twitter-bot exposé, an ICE spokesman's resignation and a Fox News host's vacation, so the slug names a tag, not a topic.

2. Step 2

   Use desk slugs to split reporting from voice

   The list separates news-and-politics, politics and the_brief from opinion, satire and life-stories. Pull them as separate feeds and carry the slug into your record; a satire piece in a news corpus will otherwise read as a claim.

3. Step 3

   Collect current stories from the broad feeds

   Use /salon/news for the current stream and home for the front page. Store a collection timestamp with every headline, since the same piece can sit in several slugs and a front page rewrites itself.

4. Step 4

   Resolve the article and contributor

   Pass a canonical public URL to /salon/article for text and /salon/author for the named contributor when available. Salon URLs embed the publication date (/2018/03/13/...), which gives you a second date to reconcile with published_at.

Other Media & Streaming APIs