Send Your First Request

Send your first request with Thordata's SERP API. Before getting started, you'll need API Token.

1. You can get a free trial on the [Pricing] page.

2. Then, copy your credentials under [API Playground] > "Token".

Code example: After obtaining your API credentials, use the following code to send your first request: [Remember to replace "Token" in the code examples with your own token in Thordata dashboard]

cURL

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}"

Python

import http.client 
from urllib.parse import urlencode
conn = http.client.HTTPSConnection("scraperapi.thordata.com")
params = {
        "url": "https://www.google.com/search",
        "q": "pizza",
        "json": "1"
      }
payload = urlencode(params) 

headers = { 
  'Authorization': 'Bearer token',
  'Content-Type': 'application/x-www-form-urlencoded'
}

conn.request("POST", "/request", payload, headers) 
res = conn.getresponse() 
data = res.read() 
print(data.decode("utf-8"))

C#

var client = new HttpClient(); 
var request = new HttpRequestMessage( 
  HttpMethod.Post,  
  "https://scraperapi.thordata.com/request"
); 
request.Headers.Add("Authorization", "Bearer token");
var formData = new Dictionary<string, string> 
{
        {"url", "https://www.google.com/search"},
        {"q", "pizza"},
        {"json", "1"}
};

var content = new FormUrlEncodedContent(formData); 
request.Content = content; 

var response = await client.SendAsync(request); 
response.EnsureSuccessStatusCode(); 
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go

package main

import (
		"fmt"
		"net/http"
		"net/url"  
		"strings"
		"io"
)

func main() {
		urlStr := "https://scraperapi.thordata.com/request"
		method := "POST"

	formData := url.Values{
                "url": {"https://www.google.com/search"},
                "q": {"pizza"},
                "json": {"1"},
        }

		payload := strings.NewReader(formData.Encode())

		client := &http.Client{}
		req, err := http.NewRequest(method, urlStr, payload)
		if err != nil {
				fmt.Println(err)
				return
		}

		req.Header.Add("Authorization", "Bearer token")
		req.Header.Add("Content-Type", "application/x-www-form-urlencoded") 
		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := io.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}

Node.js

const axios = require('axios');

const params = new URLSearchParams({
        url: 'https://www.google.com/search',
        q: 'pizza',
        json: '1'
});

const config = {
    method: 'post',
    url: 'https://scraperapi.thordata.com/request',
    headers: { 
        Authorization: 'Bearer token',
        'Content-Type': 'application/x-www-form-urlencoded'
    },
    data: params
};

axios.request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data));
    })
    .catch((error) => {
        console.log(error);
});

PHP

<?php
$curl = curl_init();

$data = [
        "url" => "https://www.google.com/search",
        "q" => "pizza",
        "json" => "1"
];

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://scraperapi.thordata.com/request',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_HTTPHEADER => array(
        'Authorization: Bearer token',
        'Content-Type: application/x-www-form-urlencoded'
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Ruby

require "uri"
require "net/http"

url = URI("https://scraperapi.thordata.com/request") 

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.read_timeout = 30

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer token"
request["Content-Type"] = "application/x-www-form-urlencoded"

form_data = {
        url: "https://www.google.com/search",
        q: "pizza",
        json: "1"
}

request.body = URI.encode_www_form(form_data)

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

Perl

use strict;
use warnings;
use LWP::UserAgent;
use HTTP::Headers;
use URI::Escape;
use Data::Dumper;

my $ua = LWP::UserAgent->new(
    timeout       => 30,
    env_proxy     => 1,      
    show_progress => 1       
);
$ua->ssl_opts(verify_hostname => 0);  

my $data = {
        url => 'https://www.google.com/search',
        q => 'pizza',
        json => '1'
};

my $form_data = join '&', map {
       uri_escape($_) . '=' . uri_escape($data->{$_})
} keys %$data;


my $headers = HTTP::Headers->new(
    'content-type'  => 'application/x-www-form-urlencoded',
    'authorization' => 'Bearer token'
);

my $request = HTTP::Request->new(
    'POST' => 'https://scraperapi.thordata.com/request',
    $headers,
    $form_data
);

my $response = $ua->request($request);

if ($response->is_success) {
print "Response status: " . $response->status_line . "
";
print "Response content: " . $response->decoded_content . "
";
} else {
warn "Error - HTTP status code: " . $response->code . "
";
warn "Error - Response content: " . ($response->decoded_content || 'No content') . "
";
warn "Response header information:
" . Dumper($response->headers->as_string);
}

After sending the request, it will return output results in JSON/HTML format:

Output

organic: [
  {
    description: "Experimente as melhores pizzas da Pizza Hut. Descubra ofertas, cardápios e lojas próximas. Delivery ou retirada disponíveis. Aproveite!",
    display_link: "https://pizzahut.com.br",
    global_rank: 1,
    link: "https://pizzahut.com.br/",
    rank: 1,
    title: "Pizza Hut Brasil: Ofertas, Cardápios e Delivery!"
  },
  {
    description: "Faça o seu pedido online na maior pizzaria do mundo! Diversos tipos de pizzas, combos e promoções para você escolher. Peça agora a sua Domino's quentinha no ...",
    display_link: "https://www.dominos.com.br",
    global_rank: 2,
    link: "https://www.dominos.com.br/",
    rank: 2,
    title: "Domino's Pizza - A Maior Pizzaria do Mundo"
  },
  {
    description: "Comece dissolvendo o fermento, sal e açúcar na água morna, antes de misturar com a farinha, óleo e cachaça, formando uma massa de pizza macia e elástica.",
    display_link: "https://www.tudogostoso.com.br › receita › 324-massa-...",
    extensions: [
      {
        text: "4,6(1.621)",
        type: "rating"
      },
      {
        text: "15 min",
        type: "text"
      }
    ],
    global_rank: 3,
    image: "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3N
    zc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N...

If you need further assistance, contact us at [email protected].