Geo Hash

Use geo hash targeting with Residential Proxies. Learn how to select grid cells from level 1 to level 4 and check the approximate cell sizes.

To get a proxy from a specific geo hash grid cell, add the geohash flag to the authorization string. Supported grid cells range from level 1 (biggest) to level 4 (smallest) currently available, for example 9, c, gc, u09, drq4.

Here are a few examples of valid geohash values:

• geohash-9 – a random exit node from a large part of the US and Mexico
• geohash-c – northern US and Canada
• geohash-gc – Ireland, Northern Ireland, England and Scotland
• geohash-u09 – Paris
• geohash-drq4 – most of Nantucket island

The approximate cell sizes by geo hash length are:

Length	Approximate cell size
1	≤ 5,000 km × 5,000 km
2	≤ 1,250 km × 625 km
3	≤ 156 km × 156 km
4	≤ 39.1 km × 19.5 km

The geohash parameter is mutually exclusive with other geo-location parameters, such as continent, country, city, and ZIP/postal code.

Credentials list example

Example represents a list of credentials that target different geo hash grid cells.

customer-USERNAME-geohash-9:PASSWORD
customer-USERNAME-geohash-gc:PASSWORD
customer-USERNAME-geohash-u09:PASSWORD
customer-USERNAME-geohash-drq4:PASSWORD

Code examples

In this example, a query to ip.oxylabs.io/location is performed from a random IP address within the u09 geo hash grid cell (Paris):

cURL

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-geohash-u09:PASSWORD" https://ip.oxylabs.io/location

PHP

<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$geohash = 'u09';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username-geohash-$geohash:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>

Python

import urllib.request
import random
username = 'USERNAME'
password = 'PASSWORD'
geohash = 'u09'
entry = ('http://customer-%s-geohash-%s:[e-mail]:7777' %
    (username, geohash, password))
query = urllib.request.ProxyHandler({
    'http': entry,
    'https': entry,
})
execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())

Java

package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("pr.oxylabs.io", 7777);
        String query = Executor.newInstance()
            .auth(entry, "customer-USERNAME-geohash-u09", "PASS")
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        System.out.println(query);
    }
}

C#

using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        client.Proxy = new WebProxy("pr.oxylabs.io:7777");
        client.Proxy.Credentials = new NetworkCredential("customer-USERNAME-geohash-u09", "PASSWORD");
        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
}

Ruby

require 'uri'
require 'net/http'

uri = URI.parse('https://ip.oxylabs.io/location')
proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME-geohash-u09', 'PASSWORD')

req = Net::HTTP::Get.new(uri.path)

result = proxy.start(uri.host,uri.port) do |http|
    http.request(req)
end

puts result.body