News discover API



Price: 1 credits per request


Description: Discover the latest news items for a specific subject / topic

Query string parameters

Name Parameter Description
Keyword &keyword=

The keyword or phrase is used by the the algorithm to discover keyword ideas that are from the same keyword group

example: seo tools

Country code &country_code=

The country code is used to serve you with the latest news items relevant to your location (full list of the available country codes)

example: US

Language code &hl=

 The language code is used in combination with the country code to collect the latest news items (full list of the available language ISO codes)

example: EN

API key &key= Your private API key

Response elements

Name Description
headline The news item headline
Google search Link to the Google Google SERP for the specific headline 
   

Supported country codes

Country Code
United States us
Canada ca
United Kingdom uk
Netherlands nl
Belgium (FR) be
Belgium (NL) be
Austria at
Switzerland ch
Germany de
France fr
Denmark dk
Sweden se
Norway no
Ireland ie
Italy it
Spain es
Portugal pt
Greece gr
Turkey tr
Ukraine ua
Russia ru
India in
China cn
Thailand th
Australia au
New Zealand (EN) nz

PHP code example

<?php

/*
    API documentation for SEO Review Tools.
    API info: https://www.seoreviewtools.com/seo-api/
    API documentation: https://api.seoreviewtools.com/documentation/
    LinkedIn: https://www.linkedin.com/company/seo-review-tools
*/

// API key 
$apiKey 'YOUR-API-KEY';

// Parameters
$keyword urlencode("seo tools");  // URL encode the keyword
$countryCode "us"
$hl "en"

// Specific API URL 
$apiRequestUrl 'https://api.seoreviewtools.com/news-discover/?keyword='.$keyword.'&country_code='.$countryCode.'&hl='.$hl.'&key='.$apiKey;

// Get data from API
$jsonResponse file_get_contents($apiRequestUrl);

// Convert JSON to PHP array
$dataArray json_decode($jsonResponsetrue);

// Check if API call was successful
if ($dataArray['status'] !== 'ok') {
    
// Return error message
    
echo 'Error message: ' $dataArray['error message'];
} else {
    
// Print data
    
print_r($dataArray);
}

?>

Python code example

import requests
import urllib.parse

# API key
api_key = "YOUR-API-KEY"

# Parameters
keyword = "seo tools"
country_code = "us"
hl = "en"

# Construct the API request URL
api_request_url = f"https://api.seoreviewtools.com/news-discover/?keyword={urllib.parse.quote(keyword)}&country_code={country_code}&hl={hl}&key={api_key}"

# Get data from API
response = requests.get(api_request_url)
data = response.json()

# Check if API call was successful
if data.get("status") != "ok":
    print(f"Error message: {data.get('error message')}")
else:
    # Print retrieved news articles
    for article in data.get("articles", []):
        title = article.get("title", "No title available")
        link = article.get("link", "#")
        print(f"Title: {title}")
        print(f"Link: {link}")
        print("-" * 50)

JSON response example







Trusted by →

clients