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 extraer datos como si navegaras desde otro país.

Lista de valores compatibles de geo_location

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
Estado Plurinacional de Bolivia
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 de Navidad
Islas Cocos (Keeling)
Colombia
Comoras
Congo
República Democrática del Congo
Islas Cook
Costa Rica
Costa de Marfil
Croacia
Cuba
Curazao
Chipre
Chequia
Dinamarca
Yibuti
Dominica
República Dominicana
Ecuador
Egipto
El Salvador
Guinea Ecuatorial
Eritrea
Estonia
Esuatini
Etiopía
Islas Malvinas [Falkland]
Islas Feroe
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í
Isla Heard e Islas McDonald
Santa Sede
Honduras
Hong Kong
Hungría
Islandia
India
Indonesia
República Islámica de Irán
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
Malaui
Malasia
Maldivas
Malí
Malta
Islas Marshall
Martinica
Mauritania
Mauricio
Mayotte
México
Estados Federados de Micronesia
República de Moldavia
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 Tristan 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
República Unida de Tanzania
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 menores alejadas de Estados Unidos
Uruguay
Uzbekistán
Vanuatu
República Bolivariana de Venezuela
Vietnam
Islas Vírgenes Británicas
Islas Vírgenes de EE. UU.
Wallis y Futuna
Sahara Occidental
Yemen
Zambia
Zimbabue

geo_location funciona de forma diferente para SERP y E-Commerce localización. Lee más en las secciones correspondientes.

Solicitar ejemplo

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

cURL

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"
    }'

Python

import requests
from pprint import pprint


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

# Obtén la respuesta.
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á la
# respuesta JSON con el resultado.
pprint(response.json())

Node.js

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

<?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);

Golang

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))
}

C#

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);
        }
    }
}

Java

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();
    }
}

JSON

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

Usamos integración síncrona Realtime método de integración en nuestros ejemplos. Si desea usar Proxy Endpoint o asíncrona Push-Pull integración, consulte la métodos de integración sección.

Sesiones

Puede forzar la misma dirección IP de proxy para varias solicitudes incluyendo el session_id parámetro dentro de contexto. Establezca el ID de sesión en cualquier cadena alfanumérica (por ejemplo, abc123), y todos los trabajos de scraping con ese ID de sesión usarán la misma IP. Una sesión permanece activa hasta 25 minutos o 100 solicitudes, lo que ocurra primero. 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",
    "context": [
        {
            "key": "session_id",
            "value": "abc123"
        }
    ]
}