Rayobyte Documentation
  • Web Scraper API
    • Getting Started
    • Features
      • Proxy Geolocation
      • JavaScript Rendering
      • Custom Headers and Cookies
    • Billing & Usage
      • How We Charge You
      • Statistics
    • Reference
      • Response Codes
      • Timeout Settings
Powered by GitBook
On this page
  • Why Proxy Geolocation Matters
  • Using Proxy Geolocation with Rayobyte
  • Supported Countries and Codes
  • Pro Tips for Geolocation Success
  1. Web Scraper API
  2. Features

Proxy Geolocation

Ever wonder how websites seem to know exactly where you are, serving up content tailored to your location? That’s geotargeting in action, and it can make scraping accurate, localized data a real challenge. With Rayobyte’s Scraping API, though, you’re in control. Our geolocation proxy functionality lets you make requests from over 100 countries, ensuring you see content just as a local user would. 🗺️


Why Proxy Geolocation Matters

Some websites—especially search engines and e-commerce platforms—serve different data depending on the user’s location. Want to compare product prices in Germany vs. the US? Or analyze search engine results pages (SERPs) in Japan? Geotargeting makes it possible, ensuring your scraping requests look like they’re coming from a user in the target region.

Example Use Cases

  • E-commerce price comparison: See if an online retailer charges different prices across countries.

  • Localized SEO research: Analyze SERPs in different regions.

  • Regional content analysis: Understand how news or media platforms customize content for various audiences.


Using Proxy Geolocation with Rayobyte

Our API simplifies the process. To specify the proxy’s geolocation, add the &proxyCountry= parameter to your request, followed by the desired country code.

Example Requests:

To scrape from Germany, use the country code DE:

curl 'https://api.scraping.rayobyte.com/?token=<API-KEY>&proxyCountry=DE&url=https://tools-api.rayobyte.com/free-ip-lookup/1.2.3.4'
const axios = require('axios');

// Define the API URL and parameters
const url = 'https://api.scraping.rayobyte.com/';
const params = {
    token: '<API-KEY>',
    proxyCountry: 'DE',
    url: 'https://tools-api.rayobyte.com/free-ip-lookup/1.2.3.4'
};

// Make the GET request
axios.get(url, { params })
    .then(response => {
        console.log("Response:", response.data);
    })
    .catch(error => {
        if (error.response) {
            console.error(`Error: ${error.response.status} - ${error.response.data}`);
        } else {
            console.error(`Error: ${error.message}`);
        }
    });
https://api.scraping.rayobyte.com/?token=<API-KEY>&proxyCountry=DE&url=https://tools-api.rayobyte.com/free-ip-lookup/1.2.3.4
import requests

# Define the API URL and token
url = "https://api.scraping.rayobyte.com/balance"
params = {
    "token": "<API-KEY>"
}

try:
    # Make the GET request
    response = requests.get(url, params=params)
    response.raise_for_status()  # Raise HTTPError for bad responses (4xx and 5xx)
    print("Response:", response.json())
except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err} - {response.text}")
except requests.exceptions.RequestException as err:
    print(f"Error occurred: {err}")

It’s that easy! 🌟 The API automatically assigns a proxy from the specified country, so you get the data you need, no matter where the site thinks you’re “from.”


Supported Countries and Codes

Rayobyte’s geolocation proxies cover 100+ countries, including popular regions like the US (US), Germany (DE), Japan (JP), and more.

Here are all the publicly supported geolocations:

Country
Code

Afghanistan

AF

Albania

AL

Algeria

DZ

Argentina

AR

Armenia

AM

Aruba

AW

Australia

AU

Austria

AT

Azerbaijan

AZ

Bahamas

BS

Bahrain

BH

Bangladesh

BD

Belgium

BE

Bosnia and Herzegovina

BA

Brazil

BR

British Virgin Islands

VG

Brunei

BN

Bulgaria

BG

Cambodia

KH

Cameroon

CM

Canada

CA

Chile

CL

China

CN

Colombia

CO

Costa Rica

CR

Croatia

HR

Cyprus

CY

Czechia

CZ

Denmark

DK

Dominican Republic

DO

Ecuador

EC

Egypt

EG

El Salvador

SV

Estonia

EE

Ethiopia

ET

Finland

FI

France

FR

Georgia

GE

Germany

DE

Ghana

GH

Greece

GR

Guatemala

GT

Guyana

GY

Jordan

JO

Hong Kong

HK

Hungary

HU

India

IN

Indonesia

ID

Ireland

IE

Israel

IL

Italy

IT

Jamaica

JM

Japan

JP

Kazakhstan

KZ

Kenya

KE

Kosovo

XK

Kuwait

KW

Latvia

LV

Liechtenstein

LI

Luxembourg

LU

Madagascar

MG

Malaysia

MY

Mauritius

MU

Mexico

MX

Mongolia

MN

Montenegro

ME

Morocco

MA

Mozambique

MZ

Myanmar

MM

Nepal

NP

Netherlands

NL

New Zealand

NZ

Nigeria

NG

Norway

NO

Oman

OM

Pakistan

PK

Panama

PA

Papua New Guinea

PG

Paraguay

PY

Peru

PE

Philippines

PH

Poland

PL

Portugal

PT

Puerto Rico

PR

Qatar

QA

Lithuania

LT

Moldova

MD

Romania

RO

Saudi Arabia

SA

Senegal

SN

Serbia

RS

Seychelles

SC

Singapore

SG

Slovakia

SK

Slovenia

SI

Somalia

SO

South Africa

ZA

South Korea

KR

Spain

ES

Sri Lanka

LK

Suriname

SR

Sweden

SE

Switzerland

CH

Taiwan

TW

Tajikistan

TJ

Thailand

TH

Trinidad and Tobago

TT

Tunisia

TN

Turkey

TR

Uganda

UG

Ukraine

UA

United Arab Emirates

AE

United Kingdom

GB

United States

US

Uzbekistan

UZ

Venezuela

VE

Vietnam

VN

Zambia

ZM


Pro Tips for Geolocation Success

  1. Plan your requests: Some websites display dramatically different data depending on the region. Test your queries in a browser to confirm the results you want before scaling your scraping operation.

  2. Test multiple regions: Comparing data across countries can uncover invaluable insights. The sky’s the limit with Rayobyte’s proxy geolocation feature!

PreviousFeaturesNextJavaScript Rendering

Last updated 5 months ago

More geolocations are available upon request. Ping our—we’re happy to help!

support team