Skip to main content
Most news APIs give you headlines. Particle API gives you structured article data from thousands of publishers — every article includes author attribution, publisher metadata, and the original source URL. Filter by publisher domain, poll for new content, and build on a feed that’s always up to date.

​
What you can build

  • News monitoring — Track coverage from specific publishers or across entire domains
  • Media analysis — Aggregate articles by publisher to understand coverage patterns and volume
  • Content curation — Build filtered feeds by combining publisher and recency filters
  • Research databases — Index articles with structured author and publisher metadata
  • Alerting systems — Poll for new articles published since your last check using published_since

​
Resource hierarchy

​
List articles

curl "https://api.particle.pro/v1/articles?limit=3" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response schema

​
data
Article[]
required
​
has_more
boolean
required
Whether more results exist beyond this page.
​
cursor
string
Pass to the next request for the next page.
Example response
{
  "data": [
    {
      "id": "7kNpXvR2mYwQ4hLs",
      "title": "Federal Reserve Signals Potential Rate Cut Amid Cooling Inflation",
      "url": "https://www.nytimes.com/2026/03/05/business/economy/fed-rate-cut-inflation.html",
      "image_url": "https://images.particle.pro/7kNpXvR2mYwQ4hLs.jpg",
      "authors": [
        {
          "id": "3fWnKa8mL7Rp",
          "name": "Jeanna Smialek",
          "image_url": "https://images.particle.pro/authors/3fWnKa8mL7Rp.jpg"
        }
      ],
      "publisher": {
        "id": "2dMXSZK8Xx",
        "host": "nytimes.com",
        "name": "The New York Times",
        "icon": "https://images.particle.pro/sites/nytimes.com.png"
      },
      "published_at": "2026-03-05T14:30:00Z"
    }
  ],
  "has_more": true,
  "cursor": "r.4mGKaJ"
}

​
Filtering

ParameterDescriptionExample
domainFilter by publisher domain(s). Accepts bare domains (nytimes.com) or full URLs. Up to 100 values.?domain=nytimes.com&domain=cnn.com
published_sinceOnly articles published after this date. Accepts a wide range of date formats.?published_since=2026-03-01T00:00:00Z

​
Recent articles from specific publishers

curl "https://api.particle.pro/v1/articles?\
domain=nytimes.com&\
domain=washingtonpost.com&\
published_since=2026-03-01T00:00:00Z&\
limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

​
Latest from a single publisher

curl "https://api.particle.pro/v1/articles?domain=cnn.com&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

​
Get a single article

curl "https://api.particle.pro/v1/articles/7kNpXvR2mYwQ4hLs" \
  -H "X-API-Key: YOUR_API_KEY"
Returns the same article schema without the pagination wrapper.

​
Pagination

All list endpoints use cursor-based pagination. Pass cursor from the response to the next request. The limit parameter controls page size (1–100, default 25). See Podcasts overview for details.