# Proxy Endpoint
Si alguna vez has usado proxies regulares para el scraping de datos, integrar el método de entrega de Proxy Endpoint será muy fácil. Solo tienes que usar nuestro nodo de entrada como proxy, autorizarte con credenciales de Scraper API e ignorar los certificados. En `cURL`, es `-k` o `--insecure`. Tus datos te llegarán por una conexión abierta.
Proxy Endpoint **solo funciona con las fuentes de datos basadas en URL**, donde se proporciona la URL completa. Por lo tanto, solo acepta unos pocos parámetros adicionales del trabajo, que [**deben enviarse como encabezados**](#accepted-parameters).
{% hint style="warning" %}
El producto no está diseñado para usarse directamente con instrucciones personalizadas del navegador (p. ej., Chromium, PhantomJS, Splash, etc.) y sus controladores (p. ej., Playwright, Selenium, Puppeteer, etc.).
{% endhint %}
### Endpoint
```
GET realtime.oxylabs.io:60000
```
### Entrada
Consulta un ejemplo de solicitud a continuación.
{% tabs %}
{% tab title="cURL" %}
```shell
curl -k -x https://realtime.oxylabs.io:60000 \
-U 'USERNAME:PASSWORD' \
-H 'x-oxylabs-user-agent-type: desktop_chrome' \
-H 'x-oxylabs-geo-location: Germany' \
'https://www.example.com'
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
from pprint import pprint
# Usa aquí tus credenciales de SERP API.
USERNAME, PASSWORD = 'YOUR_USERNAME', 'YOUR_PASSWORD'
# Define el diccionario de proxies.
proxies = {
'http': f'http://{USERNAME}:{PASSWORD}@realtime.oxylabs.io:60000',
'https': f'https://{USERNAME}:{PASSWORD}@realtime.oxylabs.io:60000'
}
# Para establecer una geo-localización específica, un user-agent o para renderizar Javascript
# es necesario enviar parámetros como encabezados de la solicitud.
headers = {
'x-oxylabs-user-agent-type': 'desktop_chrome',
'x-oxylabs-geo-location': 'Germany',
#'X-Oxylabs-Render': 'html', # Descomenta si quieres renderizar JavaScript dentro de la página.
}
response = requests.request(
'GET',
'https://www.example.com',
headers = headers, # Pasa los encabezados definidos.
verify=False, # Acepta nuestro certificado.
proxies=proxies,
)
# Imprime la página de resultados en stdout.
pprint(response.text)
# Guarda el HTML devuelto en el archivo 'result.html'.
with open('result.html', 'w') as f:
f.write(response.text)
```
{% endtab %}
{% tab title="Node.js" %}
```shell
import fetch from 'node-fetch';
import { HttpsProxyAgent } from 'https-proxy-agent';
const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
const agent = new HttpsProxyAgent(
`https://${username}:${password}@realtime.oxylabs.io:60000`
);
// Recomendamos aceptar nuestro certificado en lugar de permitir tráfico inseguro (http)
process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;
const headers = {
'x-oxylabs-user-agent-type': 'desktop_chrome',
'x-oxylabs-geo-location': 'Germany',
}
const response = await fetch('https://www.example.com', {
method: 'get',
headers: headers,
agent: agent,
});
console.log(await response.text());
```
{% endtab %}
{% tab title="PHP" %}
```php
array(
'x-oxylabs-user-agent-type: desktop_chrome',
'x-oxylabs-geo-location: Germany',
//'X-Oxylabs-Render: html', // Descomenta si quieres renderizar JavaScript dentro de la página.
)
));
$result = curl_exec($ch);
echo $result;
if (curl_errno($ch)) {
echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
?>
```
{% endtab %}
{% tab title="Golang" %}
```go
package main
import (
"crypto/tls"
"fmt"
"io/ioutil"
"net/http"
"net/url"
)
func main() {
const Username = "YOUR_USERNAME"
const Password = "YOUR_PASSWORD"
proxyUrl, _ := url.Parse(
fmt.Sprintf(
"https://%s:%s@realtime.oxylabs.io:60000",
Username,
Password,
),
)
customTransport := &http.Transport{Proxy: http.ProxyURL(proxyUrl)}
// Recomendamos aceptar nuestro certificado en lugar de permitir tráfico inseguro (http)
customTransport.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
client := &http.Client{Transport: customTransport}
request, _ := http.NewRequest("GET",
"https://www.example.com",
nil,
)
request.Header.Add("x-oxylabs-user-agent-type", "desktop_chrome")
request.Header.Add("x-oxylabs-geo-location", "Germany")
request.SetBasicAuth(Username, Password)
response, _ := client.Do(request)
responseText, _ := ioutil.ReadAll(response.Body)
fmt.Println(string(responseText))
}
```
{% endtab %}
{% tab title="C#" %}
```csharp
using System;
using System.Net;
using System.Net.Http;
using System.Threading.Tasks;
namespace OxyApi
{
class Program
{
static async Task Main(string[] args)
{
var webProxy = new WebProxy
{
Address = new Uri($"https://realtime.oxylabs.io:60000"),
BypassProxyOnLocal = false,
UseDefaultCredentials = false,
Credentials = new NetworkCredential(
userName: "YOUR_USERNAME",
password: "YOUR_PASSWORD"
)
};
var httpClientHandler = new HttpClientHandler
{
Proxy = webProxy,
};
// Recomendamos aceptar nuestro certificado en lugar de permitir tráfico inseguro (http)
httpClientHandler.ClientCertificateOptions = ClientCertificateOption.Manual;
httpClientHandler.ServerCertificateCustomValidationCallback =
(httpRequestMessage, cert, cetChain, policyErrors) =>
{
return true;
};
var client = new HttpClient(handler: httpClientHandler, disposeHandler: true);
client.DefaultRequestHeaders.Add("x-oxylabs-user-agent-type", "desktop_chrome");
client.DefaultRequestHeaders.Add("x-oxylabs-geo-location", "Germany");
Uri baseUri = new Uri("https://www.example.com");
client.BaseAddress = baseUri;
var requestMessage = new HttpRequestMessage(HttpMethod.Get, "");
var response = await client.SendAsync(requestMessage);
var contents = await response.Content.ReadAsStringAsync();
Console.WriteLine(contents);
}
}
}
```
{% endtab %}
{% tab title="Java" %}
```java
package org.example;
import org.apache.hc.client5.http.auth.AuthScope;
import org.apache.hc.client5.http.auth.CredentialsProvider;
import org.apache.hc.client5.http.classic.methods.HttpGet;
import org.apache.hc.client5.http.config.RequestConfig;
import org.apache.hc.client5.http.impl.auth.CredentialsProviderBuilder;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.client5.http.impl.io.PoolingHttpClientConnectionManagerBuilder;
import org.apache.hc.client5.http.ssl.NoopHostnameVerifier;
import org.apache.hc.client5.http.ssl.SSLConnectionSocketFactoryBuilder;
import org.apache.hc.client5.http.ssl.TrustAllStrategy;
import org.apache.hc.core5.http.HttpHost;
import org.apache.hc.core5.http.io.entity.EntityUtils;
import org.apache.hc.core5.http.message.StatusLine;
import org.apache.hc.core5.ssl.SSLContextBuilder;
import java.util.Arrays;
import java.util.Properties;
public class Main {
public static void main(final String[] args)throws Exception {
final CredentialsProvider credsProvider = CredentialsProviderBuilder.create()
.add(new AuthScope("realtime.oxylabs.io", 60000), "USERNAME", "PASSWORD".toCharArray())
.build();
final HttpHost target = new HttpHost("https", "example.com", 443);
final HttpHost proxy = new HttpHost("https", "realtime.oxylabs.io", 60000);
try (final CloseableHttpClient httpclient = HttpClients.custom()
.setDefaultCredentialsProvider(credsProvider)
.setProxy(proxy)
// Recomendamos aceptar nuestro certificado en lugar de permitir tráfico inseguro (http)
.setConnectionManager(PoolingHttpClientConnectionManagerBuilder.create()
.setSSLSocketFactory(SSLConnectionSocketFactoryBuilder.create()
.setSslContext(SSLContextBuilder.create()
.loadTrustMaterial(TrustAllStrategy.INSTANCE)
.build())
.setHostnameVerifier(NoopHostnameVerifier.INSTANCE)
.build())
.build())
.build()) {
final RequestConfig config = RequestConfig.custom()
.build();
final HttpGet request = new HttpGet("/");
request.addHeader("x-oxylabs-user-agent-type","desktop_chrome");
request.addHeader("x-oxylabs-geo-location","Germany");
request.setConfig(config);
System.out.println("Executing request " + request.getMethod() + " " + request.getUri() +
" via " + proxy + " headers: " + Arrays.toString(request.getHeaders()));
httpclient.execute(target, request, response -> {
System.out.println("----------------------------------------");
System.out.println(request + "->" + new StatusLine(response));
EntityUtils.consume(response.getEntity());
return null;
});
}
}
}
```
{% endtab %}
{% endtabs %}
### Salida
A continuación encontrarás una respuesta de ejemplo de `https://example.com`:
Respuesta de ejemplo
```html
Example Domain
Example Domain
Este dominio se utiliza para ejemplos ilustrativos en documentos. Puedes usar este
dominio en publicaciones sin coordinación previa ni solicitar permiso.
```
### Parámetros aceptados
Al hacer tu solicitud, junto con la URL, puedes enviarnos algunos parámetros del trabajo que usaremos durante la ejecución de tu trabajo. Los parámetros del trabajo deben enviarse en los encabezados de tu solicitud; mira un ejemplo [**aquí**](#input)**.**
Aquí está la lista de parámetros del trabajo que puedes enviar con solicitudes de Proxy Endpoint:
| Parámetro | Descripción |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `x-oxylabs-user-agent-type` | No hay forma de indicar un User-Agent específico, pero puedes indicarnos qué tipo de user-agent quieres que usemos. Puedes encontrar una lista de tipos de User-Agent compatibles [**aquí**](/products/es/web-scraper-api/features/http-context-and-job-management/user-agent-type.md). |
| `x-oxylabs-geo-location` | En algunos casos, puede que necesites indicar la ubicación geográfica para la que debe adaptarse el resultado. Este parámetro corresponde al `geo_location` parámetro, descrito por separado en la documentación de nivel de origen. Los valores aceptados dependen de la URL que quieras que rastreemos. Leer más [**aquí**](/products/es/web-scraper-api/features/localization/proxy-location.md). |
| `x-oxylabs-render` | Ejecución de JavaScript. Leer más [**aquí**](/products/es/web-scraper-api/features/js-rendering-and-browser-control.md). |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developers.oxylabs.io/products/es/web-scraper-api/integration-methods/proxy-endpoint.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.