API Documentation

Access real-time press releases from major wire services with our simple REST API. Get the news before everyone else.

🚀 Getting Started
Everything you need to know to start using the RTPR API

Base URL

https://api.rtpr.io

Authentication

Include your API key in the request header:

X-API-Key: YOUR_API_KEY

Rate Limits

60 requests per minute

GET/articles
Retrieve recent press releases from all tickers

Query Parameters

limitoptional

Number of articles to return (default: 20, max: 100)

Response

{
  "count": 20,
  "articles": [
    {
      "ticker": "AAPL",
      "title": "Apple Announces Q4 Results",
      "author": "Business Wire",
      "created": "Mon, 28 Jul 2025 16:30:00 -0400",
      "article_body": "Apple Inc. announced financial results for its fiscal fourth quarter ended September 30, 2025. The company posted quarterly revenue of $89.5 billion, up 6% year over year..."
    }
  ]
}

Code Examples

Try it yourself
Get recent press releases
JavaScript
const response = await fetch('https://api.rtpr.io/articles?limit=10', {
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log('Found ' + data.count + ' articles');

data.articles.forEach(article => {
  console.log(article.ticker + ': ' + article.title);
});

💡 JavaScript Notes:

  • • Works in Node.js and modern browsers
  • • Uses native fetch API (no external dependencies)
  • • Async/await for clean promise handling
GET/article
Get today's press releases for a specific ticker

Query Parameters

tickerrequired

Stock ticker symbol (e.g., AAPL, TSLA, MSFT)

Response

{
  "ticker": "AAPL",
  "date": "Mon, 28 Jul 2025",
  "count": 3,
  "articles": [
    {
      "ticker": "AAPL",
      "title": "Apple Announces Q4 Results",
      "author": "Business Wire",
      "created": "Mon, 28 Jul 2025 16:30:00 -0400",
      "article_body": "Apple Inc. announced financial results for its fiscal fourth quarter ended September 30, 2025. The company posted quarterly revenue of $89.5 billion, up 6% year over year..."
    }
  ]
}

Code Examples

Try it yourself
Get today's articles for AAPL
JavaScript
const ticker = 'AAPL';
const response = await fetch('https://api.rtpr.io/article?ticker=' + ticker, {
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

const data = await response.json();

if (data.count > 0) {
  console.log('Found ' + data.count + ' articles for ' + data.ticker + ' today');
  
  data.articles.forEach(article => {
    console.log('📰 ' + article.title);
    console.log('🕒 ' + article.created);
    console.log('✍️ ' + article.author);
    console.log('---');
  });
} else {
  console.log('No articles found for ' + ticker + ' today');
}

💡 JavaScript Notes:

  • • Works in Node.js and modern browsers
  • • Uses native fetch API (no external dependencies)
  • • Async/await for clean promise handling
Error Responses
Common error codes and their meanings
400Bad Request

Missing required parameters (e.g., ticker parameter for /article)

401Unauthorized

Invalid or missing API key

429Too Many Requests

Rate limit exceeded (60 requests per minute)

500Internal Server Error

Server error - please try again or contact support

Need Help?
We're here to help you succeed

📧 Email Support

Get help from our team

support@rtpr.io

📊 Dashboard

Manage your API keys and usage

rtpr.io/dashboard