Inicio rápido: Realice su primera solicitud con Scrapeless

Realice su primera solicitud con Scrapeless recuperando una página con Web Unlocker. Este ejemplo utiliza cURL y devuelve el resultado en la misma respuesta HTTP, por lo que puede comenzar sin necesidad de instalar un SDK ni realizar sondeos sobre una tarea.

Antes de comenzar

Necesita una cuenta de Scrapeless con acceso a Web Unlocker, saldo disponible suficiente para la solicitud y cURL en una terminal local. Los comandos siguientes utilizan Bash o Zsh en macOS o Linux.

¿Busca automatización de navegadores, respuestas de IA o resultados de búsqueda? Puede ir directamente a Elija el producto adecuado.

1. Obtenga su clave de API

Inicie sesión en el panel de control de Scrapeless, abra la configuración de la clave de API y copie su clave. Para obtener orientación sobre almacenamiento y seguridad, consulte Obtenga y proteja su clave de API.

En su terminal, ejecute los siguientes comandos. Pegue la clave en el mensaje oculto y luego presione Enter:

printf 'Scrapeless API key: '
read -rs SCRAPELESS_API_KEY
printf '\n'
export SCRAPELESS_API_KEY

La variable está disponible para los comandos lanzados desde esta terminal. Repita este paso en una nueva sesión de terminal.

2. Envíe la solicitud

Copie y ejecute:

curl --silent --show-error \
  --request POST 'https://api.scrapeless.com/api/v2/unlocker/request' \
  --header "x-api-token: ${SCRAPELESS_API_KEY:?Set SCRAPELESS_API_KEY first}" \
  --header 'Content-Type: application/json' \
  --data '{
    "actor": "unlocker.webunlocker",
    "input": {
      "url": "https://example.com/",
      "method": "GET",
      "redirect": false
    },
    "proxy": {
      "country": "ANY"
    }
  }' \
  --output scrapeless-response.json \
  --write-out 'HTTP status: %{http_code}\n'

Esto guarda el cuerpo de la respuesta en scrapeless-response.json e imprime el estado HTTP. El comando no sigue redirecciones de la API ni reintenta automáticamente la solicitud.

Campo	Qué hace
`x-api-token`	Autentica la solicitud con su clave de API de Scrapeless.
`actor`	Selecciona Web Unlocker utilizando su identificador de API, `unlocker.webunlocker`.
`input.url`	Establece la página que se va a recuperar.
`input.method`	Establece el método utilizado para la página de destino. La solicitud a Scrapeless en sí utiliza `POST`.
`input.redirect`	Controla si se siguen o no las redirecciones desde la página de destino.
`proxy.country`	Utiliza `ANY` cuando no necesita un país de proxy específico.

Consulte la referencia de la API de Web Unlocker para el contrato del endpoint.

3. Inspeccione el resultado

cat scrapeless-response.json

Una respuesta exitosa utiliza un sobre JSON con code y data. La siguiente es una ilustración abreviada, no una respuesta registrada:

{
  "code": 200,
  "data": "<!doctype html><html>...Example Domain...</html>"
}

Para este ejemplo, verifique que el estado HTTP sea 200, que el valor de code en la respuesta sea 200 y que data contenga el contenido de la página solicitada. Un archivo guardado por sí solo no garantiza que la solicitud haya tenido éxito.

Su primera solicitud estará completa cuando pueda identificar la página de Ejemplo de Dominio en el contenido devuelto.

4. Use su propia URL

Reemplace input.url por la página que desea recuperar y envíe la solicitud nuevamente. Si el destino redirige, establezca input.redirect en true según sea necesario.

El ejemplo anterior no habilita la renderizado de JavaScript. Para contenido cargado mediante scripts, siga la guía de representación de JavaScript. Para un rastreo de sitio web administrado o una sesión de navegador interactiva, utilice la guía del producto correspondiente.

Si la solicitud falla

Síntoma	Qué verificar
La terminal le solicita establecer `SCRAPELESS_API_KEY`	Ejecute el paso 1 en la misma terminal.
Error de autenticación	Verifique que la clave sea actual y completa. Envíe su valor sin formato en `x-api-token`, sin el prefijo `Bearer` .
Error de acceso o saldo	Verifique el acceso a Web Unlocker y el saldo disponible en el panel de control.
Error de solicitud no válida	Compare el JSON y el identificador del Actor con el ejemplo. Lea el cuerpo de la respuesta para identificar el campo rechazado.
La respuesta exitosa no contiene el contenido esperado	Verifique la URL de destino, las redirecciones y si se requiere renderizado de JavaScript.
Error de red o tiempo de espera agotado	Verifique la conectividad y la URL de destino antes de reintentar. Evite enviar repetidamente una solicitud fallida sin cambios.

Al solicitar ayuda, comparta el endpoint, la hora, el estado HTTP y una respuesta de error con datos sensibles ocultos. Elimine su clave de API y datos sensibles del destino.

Próximos pasos

Elija el producto y la interfaz que mejor se adapten a su flujo de trabajo:

Elija el producto adecuado para su flujo de trabajo real.
Proteja su clave de API antes de conectar una aplicación desplegada.
Continúe con la guía de Web Unlocker.
Para datos específicos de una fuente, utilice la API de Google Search, Amazon Scraper o TikTok Scraper.
¿Prefiere un flujo de trabajo en terminal? Próximamente estará disponible la CLI de Scrapeless . Su guía incluirá instalación, configuración y comandos.
¿Prefiere un SDK? Comience con Node.js. Los SDK de Python y Go llegarán próximamente.

Cuando termine de experimentar, elimine la clave de este entorno de terminal:

unset SCRAPELESS_API_KEY

Esto elimina la variable local; no revoca la clave.

Descripción general Elija el producto adecuado