API Documentation

Access our tech news data with bias ratings and sentiment analysis.

Rate Limits

Free: 100 requests/day (no API key needed for basic access)

Premium: 10,000 requests/day ($9/month)

GET /api/v1/articles

Retrieve a paginated list of articles with optional filters.

Query Parameters

Parameter	Type	Description
page	number	Page number (default: 1)
limit	number	Items per page (default: 20, max: 50)
category	string	Filter by category (e.g., tech, ai)
bias	string	Filter by bias (left, left-center, center, right-center, right)
q	string	Search articles by title

Example Response

{
  "data": [
    {
      "id": 1,
      "title": "AI Breakthrough in Natural Language Processing",
      "slug": "ai-breakthrough-nlp-m1abc",
      "url": "https://example.com/article",
      "sourceName": "techcrunch.com",
      "summary": "Researchers announce a major advancement...",
      "biasRating": "left-center",
      "sentimentScore": 0.65,
      "sentimentLabel": "positive",
      "category": "ai",
      "publishedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

GET /api/v1/sources

Get all tracked news sources with their bias ratings.

{
  "data": [
    {
      "name": "techcrunch.com",
      "biasRating": "left-center",
      "reliabilityScore": 78,
      "articleCount": 45
    }
  ]
}

POST /api/v1/social

Generate social media posts from an article. Premium feature.

Request Body

{
  "articleId": 1,
  "platform": "twitter"
}

Response

{
  "platform": "twitter",
  "content": "AI Breakthrough: New NLP model achieves human-level understanding. Bias: Left-Center | Sentiment: Positive",
  "characterCount": 120
}

Authentication

Pass your API key in the x-api-key header:

curl -H "x-api-key: YOUR_API_KEY" \
  https://freequicknews.com/api/v1/articles