Skip to main content

​
Get your API key

  1. Sign up or log in at the
  2. Create an organization and project
  3. Navigate to your project’s API Keys section
  4. Click Create API Key and copy the key immediately — it won’t be shown again

​
Authentication

All endpoints require an API key in the X-API-Key header: 
curl https://api.particle.pro/v1/podcasts \
  -H "X-API-Key: YOUR_API_KEY"

​
List podcasts

curl "https://api.particle.pro/v1/podcasts?limit=3" \
  -H "X-API-Key: YOUR_API_KEY"
Example response
{
  "data": [
    {
      "id": "2dMXSZK8XxM89hbS3eanr",
      "title": "Hard Fork",
      "language": "en",
      "explicit": false,
      "episode_count": 312,
      "speakers": [
        {"name": "Kevin Roose", "role": "HOST", "occurrences": 312},
        {"name": "Casey Newton", "role": "CO_HOST", "occurrences": 298}
      ]
    }
  ],
  "has_more": true,
  "cursor": "r.4mGKaJ"
}

​
Get an episode with its transcript

# List recent episodes
curl "https://api.particle.pro/v1/podcasts/episodes?podcast_id=2dMXSZK8XxM89hbS3eanr&limit=1" \
  -H "X-API-Key: YOUR_API_KEY"

# Get the transcript
curl "https://api.particle.pro/v1/podcasts/episodes/6OdMXSZK8XxM89hbS3eanr/transcript" \
  -H "X-API-Key: YOUR_API_KEY"
Transcript response
{
  "episode_id": "6OdMXSZK8XxM89hbS3eanr",
  "language": "en",
  "duration_seconds": 4832.5,
  "lines": [
    {
      "number": 1,
      "speaker": "Kevin Roose",
      "role": "HOST",
      "start_seconds": 0.0,
      "end_seconds": 4.2,
      "text": "Welcome back to Hard Fork. I'm Kevin Roose."
    }
  ]
}

​
Find the best clips

curl "https://api.particle.pro/v1/podcasts/clips?type=INSIGHTFUL&min_engagement=0.8&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"
Each clip includes a direct audio_url, an engagement_score, and a ready-to-use intro_statement for social sharing.

​
List recent articles

curl "https://api.particle.pro/v1/articles?domain=nytimes.com&limit=3" \
  -H "X-API-Key: YOUR_API_KEY"
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",
      "authors": [{"id": "3fWnKa8mL7Rp", "name": "Jeanna Smialek"}],
      "publisher": {"host": "nytimes.com", "name": "The New York Times"},
      "published_at": "2026-03-05T14:30:00Z"
    }
  ],
  "has_more": true
}

​
Search companies

curl "https://api.particle.pro/v1/companies?ticker=AAPL&limit=1" \
  -H "X-API-Key: YOUR_API_KEY"
Example response
{
  "data": [
    {
      "id": "5rKmNxW8pYvQ",
      "name": "Apple Inc.",
      "description": "American multinational technology company",
      "identifiers": {
        "cik": "0000320193",
        "ticker": "AAPL",
        "domain": "apple.com"
      }
    }
  ],
  "has_more": false
}

​
Next steps

Articles

Filter articles by publisher and date, with full author and publisher metadata.

Company intelligence

Company profiles, identifiers, and product hierarchies.

Podcast intelligence

Full guide to transcripts, segments, clips, and entity cross-referencing.

API reference

Complete endpoint documentation with request and response schemas.