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=' . urlencode($keyword) .
    '&country_code=' . urlencode($countryCode) .
    '&hl=' . urlencode($hl) .
    '&key=' . urlencode($apiKey);

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

// Convert JSON to PHP array
$dataArray = json_decode($jsonResponse, true);

// 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