Welcome to AllNewsAPI! This guide will help you get started with our news aggregation API in just a few minutes.

What is AllNewsAPI?

AllNewsAPI is a powerful news aggregation platform that provides programmatic access to news articles from 244 countries worldwide. Whether you're building a news app, conducting research, or monitoring media coverage, AllNewsAPI makes it easy to access the news data you need.

Quick Start

1. Sign Up for an API Key

First, you'll need to create an account and get your API key:

  1. Visit allnewsapi.com/signup
  2. Create your free account
  3. Verify your email address
  4. Get your API key from the dashboard

2. Make Your First Request

Once you have your API key, you can start making requests. Here's a simple example using JavaScript:

const API_KEY = 'your_api_key_here';
const API_URL = 'https://api.allnewsapi.com/v1/headlines';

async function getHeadlines() {
  const response = await fetch(`${API_URL}?apikey=${API_KEY}&country=us`);
  const data = await response.json();
  console.log(data);
}

getHeadlines();

3. Explore the Response

The API returns a JSON response with the following structure:

{
  "totalArticles": 7199232,
  "currentPage": 1,
  "articles": [
    {
      "title": "Breaking News Title",
      "description": "Article description...",
      "category": "technology",
      "content": "Full article content...",
      "country": "us",
      "region": "americas",
      "lang": "en",
      "sentiment": "neutral",
      "sentimentScores": {
        "negative": 0.03,
        "neutral": 0.95,
        "positive": 0.02
      },
      "url": "https://example.com/article",
      "image": "https://example.com/image.jpg",
      "publishedAt": "2024-12-01T10:00:00Z",
      "source": {
        "name": "News Source",
        "url": "https://example.com"
      }
    }
  ],
  "nextPage": 2
}

Key Features

Multi-Country Support

Access news from 244 countries:

// Get news from France
fetch(`${API_URL}?apikey=${API_KEY}&country=fr`)

// Get news from Japan
fetch(`${API_URL}?apikey=${API_KEY}&country=jp`)

Category Filtering

Filter news by category:

// Get technology news
fetch(`${API_URL}?apikey=${API_KEY}&category=technology`)

// Get sports news
fetch(`${API_URL}?apikey=${API_KEY}&category=sports`)

Search Functionality

Search for specific topics:

// Search for articles about AI
fetch(`${API_URL}?apikey=${API_KEY}&q=artificial+intelligence`)

Best Practices

  1. Cache responses - Store API responses to reduce unnecessary requests
  2. Handle errors gracefully - Always check for error responses
  3. Respect rate limits - Monitor your usage to stay within your plan limits
  4. Use pagination - For large result sets, use pagination parameters

Next Steps

Now that you've made your first request, here are some things to explore:

  • Check out our API Documentation for detailed endpoint information
  • Explore different pricing plans to find the right fit
  • Join our community to share tips and get support

Need Help?

If you have questions or need assistance:

  • Visit our documentation
  • Contact our support team
  • Check out our other blog posts for tips and tutorials

Happy coding! 🚀