Ubicación del proxy

Descubre cómo usar el parámetro geo_location para acceder a datos web como si navegaras desde otro país.

Use el geo_location parámetro para seleccionar la ubicación del servidor proxy. Esto te permite extraer datos como si navegaras desde otro país.

Lista de valores geo_location compatibles

Islas Åland
Afganistán
Albania
Argelia
Samoa Americana
Andorra
Angola
Anguila
Antártida
Antigua y Barbuda
Argentina
Armenia
Aruba
Australia
Austria
Azerbaiyán
Bahamas
Baréin
Bangladés
Barbados
Bielorrusia
Bélgica
Belice
Benín
Bermudas
Bután
Bolivia Estado Plurinacional de
Bonaire, San Eustaquio y Saba
Bosnia y Herzegovina
Botsuana
Isla Bouvet
Brasil
Territorio Británico del Océano Índico
Brunéi Darussalam
Bulgaria
Burkina Faso
Burundi
Cabo Verde
Camboya
Camerún
Canadá
Islas Caimán
República Centroafricana
Chad
Chile
China
Isla Christmas
Islas Cocos (Keeling)
Colombia
Comoras
Congo
Congo República Democrática del
Islas Cook
Costa Rica
Côte d'Ivoire
Croacia
Cuba
Curaçao
Chipre
Chequia
Dinamarca
Yibuti
Dominica
República Dominicana
Ecuador
Egipto
El Salvador
Guinea Ecuatorial
Eritrea
Estonia
Esuatini
Etiopía
Islas Malvinas [Falkland Islands]
Islas Feroe
Fiyi
Finlandia
Francia
Guayana Francesa
Polinesia Francesa
Tierras Australes y Antárticas Francesas
Gabón
Gambia
Georgia
Alemania
Ghana
Gibraltar
Grecia
Groenlandia
Granada
Guadalupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bisáu
Guyana
Haití
Isla Heard y las Islas McDonald
Santa Sede
Honduras
Hong Kong
Hungría
Islandia
India
Indonesia
Irán República Islámica de
Iraq
Irlanda
Isla de Man
Israel
Italia
Jamaica
Japón
Jersey
Jordania
Kazajistán
Kenia
Kiribati
Corea
Kuwait
Kirguistán
República Democrática Popular Lao
Letonia
Líbano
Lesoto
Liberia
Libia
Liechtenstein
Lituania
Luxemburgo
Macao
Madagascar
Malaui
Malasia
Maldivas
Malí
Malta
Islas Marshall
Martinica
Mauritania
Mauricio
Mayotte
México
Micronesia Estados Federados de
Moldova República de
Mónaco
Mongolia
Montenegro
Montserrat
Marruecos
Mozambique
Myanmar
Namibia
Nauru
Nepal
Países Bajos
Nueva Caledonia
Nueva Zelanda
Nicaragua
Níger
Nigeria
Niue
Isla Norfolk
Islas Marianas del Norte
Noruega
Omán
Pakistán
Palaos
Estado de Palestina
Panamá
Papúa Nueva Guinea
Paraguay
Perú
Filipinas
Pitcairn
Polonia
Portugal
Puerto Rico
Catar
República de Macedonia del Norte
Reunión
Rumanía
Rusia
Ruanda
San Bartolomé
Santa Elena, Ascensión y Tristán da Cunha
San Cristóbal y Nieves
Santa Lucía
San Martín (parte francesa)
San Pedro y Miquelón
San Vicente y las Granadinas
Samoa
San Marino
Santo Tomé y Príncipe
Arabia Saudita
Senegal
Serbia
Seychelles
Sierra Leona
Singapur
Sint Maarten (parte neerlandesa)
Eslovaquia
Eslovenia
Islas Salomón
Somalia
Sudáfrica
Islas Georgia del Sur y Sandwich del Sur
Sudán del Sur
España
Sri Lanka
Sudán
Surinam
Svalbard y Jan Mayen
Suecia
Suiza
República Árabe Siria
Taiwán Provincia de China
Tayikistán
Tanzania República Unida de
Tailandia
Timor-Leste
Togo
Tokelau
Tonga
Trinidad y Tobago
Túnez
Turquía
Turkmenistán
Islas Turcas y Caicos
Tuvalu
Uganda
Ucrania
Emiratos Árabes Unidos
Reino Unido
Estados Unidos
Islas Ultramarinas Menores de Estados Unidos
Uruguay
Uzbekistán
Vanuatu
Venezuela República Bolivariana de
Vietnam
Islas Vírgenes Británicas
Islas Vírgenes de Estados Unidos
Wallis y Futuna
Sahara Occidental
Yemen
Zambia
Zimbabue

geo_location el parámetro funciona de manera diferente para SERP y E-Commerce localización. Lee más en las secciones respectivas.

(inclusive) funcionará.

Este ejemplo recupera una página de producto usando un proxy en Alemania.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://sandbox.oxylabs.io/products/1",
        "geo_location": "Germany"
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'universal',
    'url': 'https://sandbox.oxylabs.io/products/1',
    'geo_location': 'Germany',
}

# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# En lugar de una respuesta con el estado del trabajo y la URL de resultados, esto devolverá el
# respuesta JSON con el resultado.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "universal",
    url: "https://sandbox.oxylabs.io/products/1",
    geo_location: "Germany",
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

# Toda la cadena que envíe debe estar codificada en la URL.

https://realtime.oxylabs.io/v1/queries?source=universal&url=https%3A%2F%2Fsandbox.oxylabs.io%2Fproducts%2F1&geo_location=Germany&access_token=12345abcde

<?php

$params = array(
    'source' => 'universal',
    'url' => 'https://sandbox.oxylabs.io/products/1',
    'geo_location' => 'Germany',
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":       "universal",
		"url":          "https://sandbox.oxylabs.io/products/1",
		"geo_location": "Germany",
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "universal",
                url = "https://sandbox.oxylabs.io/products/1",
                geo_location = "Germany"
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "universal");
        jsonObject.put("url", "https://sandbox.oxylabs.io/products/1");
        jsonObject.put("geo_location", "Germany");

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Usamos Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asincrónico Push-Pull integración, consulte el métodos de integración sección.

Sesiones

Puedes forzar la misma dirección IP del proxy para múltiples solicitudes incluyendo el session_id parámetro. Establece el ID de sesión a cualquier cadena alfanumérica (por ejemplo, abc123), y todos los trabajos de scraping con ese ID de sesión usarán la misma IP. Esto es útil para la gestión de sesiones cuando se combina con cookies personalizadas.

Aquí hay un ejemplo:

{
    "source": "universal",
    "url": "https://sandbox.oxylabs.io/products",
    "geo_location": "Germany",
    "session_id": "abc123"
}

AnteriorLocalización SiguienteLocalización SERP

Última actualización hace 3 días

¿Te fue útil?

Buenos días

hashtag(inclusive) funcionará.

hashtagSesiones

(inclusive) funcionará.

Sesiones