> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/web-scraper-api/perguntas-frequentes.md).

# Perguntas frequentes

Perguntas frequentes sobre Oxylabs Web Scraper API

Encontre respostas para perguntas comuns sobre a Web Scraper API. Consulte o sumário à direita ou role para baixo para encontrar suas respostas.

### Como começo a usar a Web Scraper API?

Crie uma [conta no Oxylabs Dashboard](https://dashboard.oxylabs.io/en/) e selecione a Web Scraper API. Escolha um teste ou assinatura e, em seguida, crie um usuário da API. Use as credenciais desse usuário para autorizar as solicitações.

Envie sua primeira solicitação por um terminal, Postman ou outro cliente HTTP. Use o [Playground do Web Scraper API](https://developers.oxylabs.io/products/pt-br/web-scraper-api/web-scraper-api-playground.md) Playground para montar e testar solicitações sem escrever código.

### Qual método de integração devo usar?

A Web Scraper API oferece três métodos de integração:

* **Realtime** mantém uma conexão aberta até que o resultado esteja pronto.
* **Push-Pull** cria jobs assíncronos para cargas de trabalho maiores.
* **Proxy Endpoint** fornece um endpoint no estilo proxy para solicitações síncronas.

Use Realtime ou Proxy Endpoint para fluxos de trabalho síncronos mais simples. Use Push-Pull quando precisar de processamento assíncrono ou entrega em nuvem. Veja [Métodos de integração](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods.md) para exemplos de solicitações.

### Quais recursos a Web Scraper API oferece?

A Web Scraper API oferece OxyCopilot, entrega em nuvem, consultas em lote, Custom Parser e Scheduler. Ela também oferece suporte a instruções do navegador, captura de Fetch/XHR e saída em Markdown.

Use a entrega em nuvem para Amazon S3, Google Cloud Storage, Alibaba OSS ou armazenamento compatível. Jobs em lote suportam até 5.000 `query` or `url` valores. Veja [Recursos](https://developers.oxylabs.io/products/pt-br/web-scraper-api/features.md) para detalhes de configuração.

### Posso testar a Web Scraper API antes de integrar?

Sim, você pode usar o [Playground do Web Scraper API](https://developers.oxylabs.io/products/pt-br/web-scraper-api/web-scraper-api-playground.md) no Legacy Oxylabs Dashboard. Insira uma consulta ou URL, configure os parâmetros da solicitação e inspecione o resultado.

O Playground pode gerar o código da solicitação para a sua implementação. Ele também ajuda você a testar parsing, renderização de JavaScript, localização e instruções do navegador.

### Como faço para gerenciar a Web Scraper API no Dashboard?

Abra **Meus Produtos** e selecione a Web Scraper API. Use **Estatísticas** para revisar o uso e **Usuários** para gerenciar as credenciais da API.

Você pode configurar limites de gasto, adicionar resultados disponíveis, alterar uma assinatura ou gerenciar os detalhes de pagamento. Use o [Playground do Web Scraper API](https://developers.oxylabs.io/products/pt-br/web-scraper-api/web-scraper-api-playground.md) para testar solicitações no Dashboard.

### Há algum alvo restrito?

Alguns sites são restritos para evitar uso indevido e apoiar a coleta responsável de dados. Veja [Destinos restritos](https://developers.oxylabs.io/products/pt-br/web-scraper-api/restricted-targets.md) para a lista atual.

Os alvos selecionados podem ficar disponíveis após uma revisão de KYC. Entre em contato com seu gerente de conta ou [Suporte da Oxylabs](mailto:support@oxylabs.io) para solicitar acesso.

### Como funciona a precificação da Web Scraper API?

As assinaturas incluem uma cota mensal de resultados. Um resultado é conteúdo recuperado com sucesso, como o HTML da página.

Respostas com `2xx` or `4xx` códigos de status do alvo contam como resultados bem-sucedidos. Respostas com erros de sistema com `5xx` or `6xx` códigos não geram cobrança de resultados.

As cotas dependem da categoria do alvo, do plano e dos requisitos de renderização em JavaScript. Veja [Tráfego e cobrança](https://developers.oxylabs.io/products/pt-br/web-scraper-api/usage-and-billing/billing-information.md) para detalhes de cobrança. Entre em contato com seu gerente de conta para cotas específicas do plano.

### Quais códigos de resposta a Web Scraper API pode retornar?

A Web Scraper API retorna códigos de resposta padrão da API e específicos do parser. Use o corpo da resposta para diagnosticar solicitações inválidas e erros de autorização. Veja [Códigos de resposta](https://developers.oxylabs.io/products/pt-br/web-scraper-api/response-codes.md) a referência completa.

Códigos comuns da API incluem:

* `200` – a solicitação foi concluída com sucesso.
* `202` – a solicitação foi aceita para processamento.
* `400`, `401`, `403`, ou `422` – problema na solicitação ou na autorização.
* `429` – limite de taxa atingido.
* `500`, `524`, `612`, ou `613` – problema no sistema ou no processamento.

Tente novamente os jobs com falha. Entre em contato com `612` or `613` quando precisar de limites de taxa mais altos. [Suporte da Oxylabs](mailto:support@oxylabs.io) quando precisar de limites de taxa mais altos.

### Onde posso encontrar o ID do meu job de scraping?

Para solicitações Realtime e Proxy Endpoint, encontre `job_id` na resposta. Você também pode usar o `x-oxylabs-job-id` cabeçalho da resposta.

Para solicitações Push-Pull, use o `id` campo. Os IDs dos jobs permanecem disponíveis por 48 horas.

### Quais alvos suportam dados analisados?

A Web Scraper API retorna JSON analisado para tipos de página de alvo compatíveis. Os alvos compatíveis incluem Google, Google Shopping, Amazon, YouTube, ChatGPT, Perplexity, Bing, Walmart, Best Buy, Etsy e Target.

Use [Custom Parser,](https://developers.oxylabs.io/products/pt-br/web-scraper-api/features/custom-parser.md) para outros alvos. Você pode salvar parsers como predefinições reutilizáveis. OxyCopilot pode gerar lógica de parsing a partir de instruções em linguagem natural.

### Quais alvos posso raspar?

A Web Scraper API oferece suporte a scrapers populares específicos de alvo e à raspagem universal da web. Navegue por [Destinos](https://developers.oxylabs.io/products/pt-br/web-scraper-api/destinos.md) ou use o API Playground para testar seu alvo.

Use uma fonte específica do alvo quando disponível. Use a `universal` fonte com uma URL de alvo para outros sites públicos.

### Posso automatizar ações no navegador?

Sim. [Renderização de JS e controle do navegador](https://developers.oxylabs.io/products/pt-br/web-scraper-api/features/js-rendering-and-browser-control.md) pode renderizar JavaScript e automatizar cliques, rolagem, entrada de texto e outras ações no navegador.

Crie instruções manualmente ou no Playground. Você também pode gerá-las com o OxyCopilot a partir de um prompt em linguagem natural.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api/perguntas-frequentes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
