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.

Usa el geo_location parámetro para seleccionar la ubicación del servidor proxy. Esto te permite rastrear datos como si estuvieras navegando desde otro país.

Lista de valores de 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
Bangladesh
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
Costa de Marfil
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 Faroe
Fiyi
Finlandia
Francia
Guayana Francesa
Polinesia Francesa
Territorios Australes Franceses
Gabón
Gambia
Georgia
Alemania
Ghana
Gibraltar
Grecia
Groenlandia
Granada
Guadalupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bisáu
Guyana
Haití
Islas Heard y McDonald
Santa Sede
Honduras
Hong Kong
Hungría
Islandia
India
Indonesia
Irán República Islámica de
Irak
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
Malawi
Malasia
Maldivas
Malí
Malta
Islas Marshall
Martinica
Mauritania
Mauricio
Mayotte
México
Micronesia Estados Federados de
Moldavia 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
Palestina Estado de
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 Georgias 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 EE. UU.
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.

o escribe a nuestro soporte en chat en vivo 24/7.

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


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

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

json=payload
# En lugar de una respuesta con el estado del trabajo y la URL de resultados, esto devolverá la
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();

<?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 el método de integración síncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o asíncrono Push-Pull para la integración, consulte los 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 como 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í tienes 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 12 días

¿Te fue útil?

Buenas noches

o escribe a nuestro soporte en chat en vivo 24/7.

Sesiones