v3 Authentication 🗝

Understand how to authenticate using your unique API key

The Authentication is done via the x-api-token HTTP Header.

For example, if your API key is your_key_1

Python

import requests


url = 'https://v3-api.newscatcherapi.com/api/search?'

params = {'q': 'Silicon Valley '}

headers = {'x-api-token': 'your_key_1'}

response = requests.get(url, params=params, headers=headers)

cURL

curl -XGET 'https://v3-api.newscatcherapi.com/api/search?q=Tesla' -H 'x-api-token: your_key_1'

Node.js

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://v3-api.newscatcherapi.com/api/search?',
  params: {q: 'Bitcoin', lang: 'en', sort_by: 'relevancy', page: '1'},
  headers: {
    'x-api-token': 'your_key_1'
  }
};

axios.request(options).then(function (response) {
	console.log(response.data);
}).catch(function (error) {
	console.error(error);
});

Go

package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://v3-api.newscatcherapi.com/api/search?q=Tesla&lang=en&sort_by=relevancy&page=1"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-token", "your_key_1")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

PHP

<?php

$client = new http\Client;
$request = new http\Client\Request;

$request->setRequestUrl('https://v3-api.newscatcherapi.com/api/search');
$request->setRequestMethod('GET');
$request->setQuery(new http\QueryString([
	'q' => 'Google',
	'lang' => 'en',
	'sort_by' => 'relevancy',
	'page' => '1'
]));

$request->setHeaders([
	'x-api-token' => 'your_key_1'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();

Ruby

require "uri"
require "net/http"

url = URI("https://v3-api.newscatcherapi.com/api/search/?q=\"Elon Musk\"&lang=en&countries=US,CA")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-token"] = "enter-your-api-key-here"

response = https.request(request)
puts response.read_body