Standard Geo

Business, Scaling and Enterprise plan users can geotarget their requests to the following countries, by using the country_code parameter with their request.

Hobby and Startup plans support only US and EU regional-based geotargeting (individual country codes are not supported).

🇺🇸 us: United States

Hobby Plan and higher

🇪🇺 eu: Europe (general)

Hobby Plan and higher

🇦🇺 au: Australia

Business Plan and higher

🇦🇪 ae: United Arab Emirates

Business Plan and higher

🇦🇷 ar: Argentina

Business Plan and higher

🇦🇹 at: Austria

Business Plan and higher

🇧🇩 bd: Bangladesh

Business Plan and higher

🇧🇪 be: Belgium

Business Plan and higher

🇧🇬 bg: Bulgaria

Business Plan and higher

🇧🇷 br: Brazil

Business Plan and higher

🇨🇦 ca: Canada

Business Plan and higher

🇨🇭 ch: Switzerland

Business Plan and higher

🇨🇱 cl: Chile

Business Plan and higher

🇨🇳 cn: China

Business Plan and higher

🇨🇴 co: Colombia

Business Plan and higher

🇨🇾 cy: Cyprus

Business Plan and higher

🇨🇿 cz: Czechia

Business Plan and higher

🇩🇪 de: Germany

Business Plan and higher

🇩🇰 dk: Denmark

Business Plan and higher

🇪🇨 ec: Ecuador

Business Plan and higher

🇪🇪 ee: Estonia

Business Plan and higher

🇪🇬 eg: Egypt

Business Plan and higher

🇪🇸 es: Spain

Business Plan and higher

🇫🇮 fi: Finland

Business Plan and higher

🇫🇷 fr: France

Business Plan and higher

🇬🇷 gr: Greece

Business Plan and higher

🇭🇰 hk: Hong Kong

Business Plan and higher

🇭🇷 hr: Croatia

Business Plan and higher

🇭🇺 hu: Hungary

Business Plan and higher

🇮🇩 id: Indonesia

Business Plan and higher

🇮🇪 ie: Ireland

Business Plan and higher

🇮🇱 il: Israel

Business Plan and higher

🇮🇳 in: India

Business Plan and higher

🇮🇸 is: Iceland

Business Plan and higher

🇮🇹 it: Italy

Business Plan and higher

🇯🇴 jo: Jordan

Business Plan and higher

🇯🇵 jp: Japan

Business Plan and higher

🇰🇪 ke: Kenya

Business Plan and higher

🇰🇷 kr: South Korea

Business Plan and higher

🇱🇮 li: Liechtenstein

Business Plan and higher

🇱🇹 lt: Lithuania

Business Plan and higher

🇱🇻 lv: Latvia

Business Plan and higher

🇲🇹 mt: Malta

Business Plan and higher

🇲🇽 mx: Mexico

Business Plan and higher

🇲🇾 my: Malaysia

Business Plan and higher

🇳🇬 ng: Nigeria

Business Plan and higher

🇳🇱 nl: Netherlands

Business Plan and higher

🇳🇴 no: Norway

Business Plan and higher

🇳🇿 nz: New Zealand

Business Plan and higher

🇵🇦 pa: Panama

Business Plan and higher

🇵🇪 pe: Peru

Business Plan and higher

🇵🇭 ph: Phillipines

Business Plan and higher

🇵🇰 pk: Pakistan

Business Plan and higher

🇵🇱 pl: Poland

Business Plan and higher

🇵🇹 pt: Portugal

Business Plan and higher

🇷🇴 ro: Romania

Business Plan and higher

🇷🇺 ru: Russia

Business Plan and higher

🇸🇦 sa: Saudi Arabia

Business Plan and higher

🇸🇪 se: Sweden

Business Plan and higher

🇸🇬 sg: Singapore

Business Plan and higher

🇸🇮 si: Slovenia

Business Plan and higher

🇸🇰 sk: Slovakia

Business Plan and higher

🇹🇭 th: Thailand

Business Plan and higher

🇹🇷 tr: Turkey

Business Plan and higher

🇹🇼 tw: Taiwan

Business Plan and higher

🇺🇦 ua: Ukraine

Business Plan and higher

🇬🇧 uk: United Kingdom

Business Plan and higher

🇻🇪 ve: Venezuela

Business Plan and higher

🇻🇳 vn: Vietnam

Business Plan and higher

🇿🇦 za: South Africa

Business Plan and higher

Other countries are available to Enterprise customers upon request.

ZIP Code Geo targeting is currently supported for the Amazon(US) domain. To find out more, please visit this link.

API REQUEST

curl --request GET \
  --url 'https://api.scraperapi.com?api_key=API_KEY&country_code=us&url=https://example.com/'

import requests

target_url = 'https://example.com/'
# Replace the value for api_key with your actual API Key.
api_key = 'API_KEY'

request_url = (
    f'https://api.scraperapi.com?'
    f'api_key={api_key}'
    f'&country_code=us'
    f'&url={target_url}'
)

response = requests.get(request_url)
print(response.text)

import request from 'node-fetch';

// Replace the value for api_key with your actual API Key.
const url = 'https://api.scraperapi.com/?api_key=API_KEY&country_code=us&url=https://example.com/';

request(url)
  .then(response => {
    console.log(response);
  })
  .catch(error => {
    console.error(error);
  });

<?php

// Replace the value for api_key with your actual API Key.
$url = "https://api.scraperapi.com?api_key=API_KEY&country_code=us&url=https://example.com";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    print_r($response);
}

curl_close($ch);

require 'net/http'

# Replace the value for api_key with your actual API Key.
params = {
  api_key: "API_KEY",
  country_code: "us",
  url: "https://example.com/"
}

uri = URI('https://api.scraperapi.com/')
uri.query = URI.encode_www_form(params)

website_content = Net::HTTP.get(uri)
puts website_content

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        // Replace the value for api_key with your actual API Key.
        String apiKey = "API_KEY";
        String targetUrl = "https://example.com/";

        String scraperApiUrl =
                "https://api.scraperapi.com?api_key=" + apiKey
                + "&country_code=us"
                + "&url=" + targetUrl;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(scraperApiUrl))
                .GET()
                .build();

        HttpResponse<String> response =
                client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

ASYNC REQUEST

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "apiKey": "API_KEY",
        "url": "https://example.com/",
        "apiParams": {
          "country_code": "us"
        }
      }' \
  "https://async.scraperapi.com/jobs"

import requests

r = requests.post(
    url='https://async.scraperapi.com/jobs',
    json={
        # Replace the value for api_key with your actual API Key.
        'apiKey': 'API_KEY',
        'country_code': 'us',
        'url': 'https://example.com/'
    }
)

print(r.text)

import axios from 'axios';

(async () => {
  try {
    const { data } = await axios({
      method: 'POST',
      url: 'https://async.scraperapi.com/jobs',
      headers: { 'Content-Type': 'application/json' },
      data: {
        // Replace the value for api_key with your actual API Key.
        apiKey: 'API_KEY',
        url: 'https://example.com',
        apiParams: {
          country_code: 'us'
        }
      }
    });

    console.log(data);
  } catch (error) {
    console.error(error);
  }
})();

<?php
$payload = json_encode([
    // Replace the value for api_key with your actual API Key.
    "apiKey" => "API_KEY",
    "url"    => "https://example.com",
    "apiParams" => [
        "country_code"  => "us"
    ]
]);

$ch = curl_init("https://async.scraperapi.com/jobs");

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

print_r($response);
?>

require 'net/http'
require 'json'

uri = URI('https://async.scraperapi.com/jobs')

payload = {
  # Replace the value for api_key with your actual API Key.
  "apiKey" => "API_KEY",
  "url" => "https://example.com",
  "apiParams" => {
    "country_code" => "us"
  }
}

response = Net::HTTP.post(uri, payload.to_json, "Content-Type" => "application/json")
puts response.body

import java.io.*;
import java.net.*;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://async.scraperapi.com/jobs");
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);

            String payload = "{"
                    // Replace the value for api_key with your actual API Key.
                    + "\"apiKey\": \"API_KEY\","
                    + "\"url\": \"https://example.com\","
                    + "\"apiParams\": {"
                    + "\"country_code\": \"us\""
                    + "}"
                    + "}";

            try (OutputStream os = conn.getOutputStream()) {
                os.write(payload.getBytes(StandardCharsets.UTF_8));
            }

            try (BufferedReader in = new BufferedReader(new InputStreamReader(
                    conn.getResponseCode() == 200 ? conn.getInputStream() : conn.getErrorStream()
            ))) {
                StringBuilder response = new StringBuilder();
                String line;
                while ((line = in.readLine()) != null) response.append(line);
                System.out.println(response);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

PROXY MODE

curl --proxy 'http://scraperapi.country_code=us:API_KEY@proxy-server.scraperapi.com:8001' \
  -k \
  'https://example.com/'

import requests

# Replace the value for api_key with your actual API Key.
proxies = {
    "http": "http://scraperapi.country_code=us:API_KEY@proxy-server.scraperapi.com:8001"
}

r = requests.get('http://example.com/', proxies=proxies, verify=False)
print(r.text)

import axios from 'axios';

axios.get('http://example.com/', {
  method: 'GET',
  proxy: {
    host: 'proxy-server.scraperapi.com',
    port: 8001,
    auth: {
      username: 'scraperapi.country_code=us',
      // Replace the value for password with your actual API Key.
      password: 'API_KEY'
    },
    protocol: 'http'
  }
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });

<?php

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://example.com/");
curl_setopt($ch, CURLOPT_PROXY, 
    // Replace the value for api_key with your actual API Key.
    "http://scraperapi.country_code=us:API_KEY@proxy-server.scraperapi.com:8001"
);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);

$response = curl_exec($ch);
curl_close($ch);
var_dump($response);

require 'httparty'

HTTParty::Basement.default_options.update(verify: false)

response = HTTParty.get('http://example.com/', {
  http_proxyaddr: "proxy-server.scraperapi.com",
  http_proxyport: 8001,
  http_proxyuser: "scraperapi.country_code=us",
  # Replace the value for http_proxypass with your actual API Key.
  http_proxypass: "API_KEY"
})

results = response.body
puts results

import java.io.*;
import java.net.*;
import javax.net.ssl.*;
import java.security.cert.X509Certificate;

public class Main {
    public static void main(String[] args) {
        try {
            SSLContext sc = SSLContext.getInstance("TLS");
            sc.init(null, new TrustManager[]{
                new X509TrustManager() {
                    public X509Certificate[] getAcceptedIssuers() { return null; }
                    public void checkClientTrusted(X509Certificate[] certs, String authType) {}
                    public void checkServerTrusted(X509Certificate[] certs, String authType) {}
                }
            }, new java.security.SecureRandom());
            HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
            HttpsURLConnection.setDefaultHostnameVerifier((hostname, session) -> true);

            String apiKey = "API_KEY"; // Replace with your actual API Key.
            Authenticator.setDefault(new Authenticator() {
                protected PasswordAuthentication getPasswordAuthentication() {
                    return new PasswordAuthentication(
                        "scraperapi.country_code=us", apiKey.toCharArray()
                    );
                }
            });

            System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");
            System.setProperty("https.proxyHost", "proxy-server.scraperapi.com");
            System.setProperty("https.proxyPort", "8001");

            HttpsURLConnection conn = (HttpsURLConnection) new URL("https://example.com/").openConnection();
            conn.setRequestMethod("GET");

            BufferedReader in;
            if (conn.getResponseCode() >= 400) {
                in = new BufferedReader(new InputStreamReader(conn.getErrorStream()));
            } else {
                in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            }

            StringBuilder resp = new StringBuilder();
            String line;
            while ((line = in.readLine()) != null) {
                resp.append(line).append("\n");
            }
            in.close();

            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

PreviousGeotargeting NextPremium Geo

Last updated 6 months ago