Início rápido: Faça sua primeira requisição ao Scrapeless

Faça sua primeira requisição ao Scrapeless recuperando uma página com o Web Unlocker. Este exemplo usa cURL e retorna o resultado na mesma resposta HTTP, para que você possa começar sem instalar um SDK ou consultar uma tarefa.

Antes de começar

Você precisa de uma conta Scrapeless com acesso ao Web Unlocker, saldo disponível suficiente para a requisição e cURL em um terminal local. Os comandos abaixo usam Bash ou Zsh no macOS ou Linux.

Procurando automação de navegador, respostas de IA ou resultados de busca? Você pode ir diretamente para Escolha o produto certo.

1. Obtenha sua chave de API

Faça login no painel do Scrapeless, abra as configurações da chave de API e copie sua chave. Para orientações sobre armazenamento e segurança, consulte Obtenha e proteja sua chave de API.

No seu terminal, execute os comandos a seguir. Cole a chave no prompt oculto e pressione Enter:

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

A variável fica disponível para os comandos iniciados a partir deste terminal. Repita esta etapa em uma nova sessão de terminal.

2. Envie a requisição

Copie e execute:

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'

Isso salva o corpo da resposta em scrapeless-response.json e imprime o status HTTP. O comando não segue redirecionamentos da API nem repete a requisição automaticamente.

Campo	O que faz
`x-api-token`	Autentica a requisição com sua chave de API do Scrapeless.
`actor`	Seleciona o Web Unlocker usando seu identificador de API, `unlocker.webunlocker`.
`input.url`	Define a página a ser recuperada.
`input.method`	Define o método usado para a página de destino. A requisição ao próprio Scrapeless usa `POST`.
`input.redirect`	Controla se deve seguir os redirecionamentos da página de destino.
`proxy.country`	Usa `ANY` quando você não precisa de um país de proxy específico.

Consulte a referência da API do Web Unlocker para o contrato do endpoint.

3. Inspecione o resultado

cat scrapeless-response.json

Uma resposta bem-sucedida usa um envelope JSON com code e data. O seguinte é uma ilustração abreviada, não uma resposta registrada:

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

Para este exemplo, verifique se o status HTTP é 200, se o code da resposta é 200 e se data contém o conteúdo da página solicitada. Um arquivo salvo, por si só, não comprova que a requisição foi bem-sucedida.

Sua primeira requisição está concluída quando você consegue identificar a página Example Domain no conteúdo retornado.

4. Use sua própria URL

Substitua input.url pela página que você deseja recuperar e envie a requisição novamente. Se o destino redirecionar, defina input.redirect como true conforme necessário.

O exemplo acima não habilita a renderização de JavaScript. Para conteúdo carregado por scripts, siga o guia de renderização de JavaScript. Para um rastreamento gerenciado de site ou uma sessão de navegador interativa, use o guia de produto relevante em vez disso.

Se a requisição falhar

Sintoma	O que verificar
O shell pede que você defina `SCRAPELESS_API_KEY`	Execute a etapa 1 no mesmo terminal.
Erro de autenticação	Verifique se a chave está atual e completa. Envie seu valor bruto em `x-api-token`, sem o prefixo `Bearer`.
Erro de acesso ou de saldo	Verifique o acesso ao Web Unlocker e o saldo disponível no painel.
Erro de requisição inválida	Compare o JSON e o identificador do actor com o exemplo. Leia o corpo da resposta para identificar o campo rejeitado.
Uma resposta bem-sucedida não contém o conteúdo esperado	Verifique a URL de destino, os redirecionamentos e se a renderização de JavaScript é necessária.
Erro de rede ou tempo esgotado	Verifique a conectividade e a URL de destino antes de tentar novamente. Evite reenviar repetidamente uma requisição que está falhando sem alterações.

Ao pedir ajuda, compartilhe o endpoint, o horário, o status HTTP e uma resposta de erro com dados omitidos. Remova sua chave de API e dados sensíveis do destino.

Próximos passos

Escolha o produto e a interface que se ajustam ao seu fluxo de trabalho:

Escolha o produto certo para o seu fluxo de trabalho real.
Proteja sua chave de API antes de conectar um aplicativo implantado.
Continue com o guia do Web Unlocker.
Para dados específicos de fonte, use a Google Search API, o Amazon Scraper ou o TikTok Scraper.
Prefere um fluxo de trabalho de terminal? A Scrapeless CLI chega em breve. Seu guia abrangerá instalação, configuração e comandos.
Prefere um SDK? Comece com o Node.js. Os SDKs de Python e Go chegam em breve.

Quando terminar de experimentar, remova a chave deste ambiente de terminal:

unset SCRAPELESS_API_KEY

Isso limpa a variável local; não revoga a chave.

Visão geral Escolher o produto certo