API Documentation

import requests
from datetime import datetime, timedelta

# API configuration
base_url = 'https://newsapi.pro/api/feed_contents/us/en'
headers = {
    'X-API-Key': 'YOUR_API_KEY'
}

# Request parameters
params = {
    'categories.name': 'TECHNOLOGY',
    'source.url': 'nytimes.com',
    'publishedAt[after]': (datetime.now() - timedelta(days=1)).isoformat(),
    'page': 1,
    'pageSize': 30
}

# Make request for US/English news (required parameters)
response = requests.get(base_url, headers=headers, params=params)

if response.status_code == 200:
    data = response.json()
    
    # Process news items
    for item in data['items']:
        print(f"Title: {item['title']}")
        print(f"Source: {item['source']['name']}")
        print(f"Categories: {', '.join(c['name'] for c in item['categories'])}")
        print(f"Published: {item['publishedAt']}")
        print('---')
    
    # Print pagination info
    print(f"\nPage {data['currentPage']} of {data['totalPages']}")
    print(f"Showing {data['itemsPerPage']} of {data['totalItems']} total items")
else:
    print(f"Error {response.status_code}: {response.text}")

<?php

// API configuration
$apiKey = 'YOUR_API_KEY';
$baseUrl = 'https://newsapi.pro/api/feed_contents/us/en';

// Request parameters
$params = http_build_query([
    'categories.name' => 'TECHNOLOGY',
    'source.url' => 'nytimes.com',
    'page' => 1,
    'pageSize' => 30
]);

// Setup request options
$options = [
    'http' => [
        'method' => 'GET',
        'header' => [
            "X-API-Key: $apiKey",
            "Accept: application/json"
        ]
    ]
];

// Create context and fetch US/English news
$context = stream_context_create($options);
$response = file_get_contents("$baseUrl?$params", false, $context);

if ($response !== false) {
    $data = json_decode($response, true);
    
    // Process news items
    foreach ($data['items'] as $item) {
        echo "Title: {$item['title']}\n";
        echo "Source: {$item['source']['name']}\n";
        echo "Categories: " . implode(', ', array_column($item['categories'], 'name')) . "\n";
        echo "Published: {$item['publishedAt']}\n";
        echo "---\n";
    }
    
    // Print pagination info
    echo "\nPage {$data['currentPage']} of {$data['totalPages']}\n";
    echo "Showing {$data['itemsPerPage']} of {$data['totalItems']} total items\n";
} else {
    echo "Error fetching news: " . error_get_last()['message'] . "\n";
}
?>