> 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/api-reference/pt-br/scrapers-dedicados/scrapers-de-mecanismos-de-busca.md).

# Scrapers de mecanismos de busca

Referência para os endpoints de scraper do Google e Bing da Web API: parâmetros e modos de entrega de cada endpoint.

<table><thead><tr><th width="108">Scraper</th><th>Endpoints</th></tr></thead><tbody><tr><td><a href="#google">Google</a></td><td><code>/google/search</code>, <code>/google/ads</code>, <code>/google/aimode</code>, <code>/google/shopping/search</code>, <code>/google/shopping/product</code>, <code>/google/maps</code>, <code>/google/travel/hotels</code>, <code>/google/lens</code>, <code>/google/trends/explore</code>, <code>/google</code></td></tr><tr><td><a href="#bing">Bing</a></td><td><code>/bing/search</code>, <code>/bing</code></td></tr></tbody></table>

### Google

#### `POST /v1/scrape/google/search`

Retorna resultados orgânicos, anúncios e os recursos da SERP que apareceram para uma consulta.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="157.5">Nome</th><th width="98.5">Tipo</th><th width="89">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Frase de busca, como um usuário a digitaria</td></tr><tr><td><code>aomd</code></td><td>string</td><td>não</td><td>Não documentado pelo Google. Encaminhado como enviado</td></tr><tr><td><code>cr</code></td><td>string</td><td>não</td><td>Restrição de país. Encaminhado literalmente</td></tr><tr><td><code>disable_scripts</code></td><td>booleano</td><td>não</td><td>Bloqueia scripts da página</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>expand_aio</code></td><td>booleano</td><td>não</td><td>Expande o bloco AI Overview em vez de retorná-lo recolhido</td></tr><tr><td><code>filter</code></td><td>inteiro</td><td>não</td><td>Filtro de conteúdo duplicado do Google. <code>0</code> desativa-o e retorna resultados quase duplicados</td></tr><tr><td><code>fpstate</code></td><td>string</td><td>não</td><td>Estado da página. Encaminhado literalmente</td></tr><tr><td><code>limit_per_page</code></td><td>array de objetos</td><td>não</td><td>Contagens de resultados por página, por exemplo, <code>[{"page": 1, "limit": 20}]</code>. Use em vez de <code>pages</code> quando apenas a página 1 importa</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>nfpr</code></td><td>string</td><td>não</td><td>Suprime a autocorreção ortográfica do Google</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>results_language</code></td><td>string</td><td>não</td><td>Restringe os resultados a um idioma, por exemplo, <code>lt</code>. Filtra, não traduz</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro SafeSearch do Google. Um booleano aqui, uma string no Bing</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>tbm</code></td><td>string</td><td>não</td><td>Vertical de busca: imagens, shopping, vídeo, livros. Encaminhado literalmente</td></tr><tr><td><code>tbs</code></td><td>string</td><td>não</td><td>Filtros de tempo e qualidade, por exemplo, últimas 24 horas. Encaminhado literalmente</td></tr><tr><td><code>udm</code></td><td>string</td><td>não</td><td>Seletor do modo de interface do Google. Encaminhado literalmente</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/ads`

Retorna apenas o bloco pago: anunciantes, ordem e texto do anúncio.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="159">Nome</th><th width="96.5">Tipo</th><th width="91.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Frase de busca para a qual os anúncios são buscados</td></tr><tr><td><code>adstest</code></td><td>booleano</td><td>não</td><td>Retorna anúncios da rede de anúncios de teste do Google em vez do inventário ao vivo</td></tr><tr><td><code>disable_scripts</code></td><td>booleano</td><td>não</td><td>Bloqueia scripts da página</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>expand_aio</code></td><td>booleano</td><td>não</td><td>Expande o bloco AI Overview em vez de retorná-lo recolhido</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/aimode`

Retorna a resposta do Google AI Mode, separada do AI Overview retornado por `/google/search`.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="134.5">Nome</th><th width="96">Tipo</th><th width="94">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>A pergunta a fazer ao Google AI Mode</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>sim</td><td>Obrigatório: <code>true</code></td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

As respostas podem variar entre solicitações idênticas.

#### `POST /v1/scrape/google/shopping/search`

Retorna listagens do Google Shopping com preços.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="132">Nome</th><th width="104.5">Tipo</th><th width="93">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Frase de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>limit</code></td><td>inteiro</td><td>não</td><td>Número de resultados a retornar</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>max_price</code></td><td>inteiro</td><td>não</td><td>Maior preço a incluir, na moeda da loja</td></tr><tr><td><code>min_price</code></td><td>inteiro</td><td>não</td><td>Menor preço a incluir, na moeda da loja</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>sort_by</code></td><td>string</td><td>não</td><td><code>r</code> relevância (padrão), <code>rv</code> avaliação alta para baixa, <code>p</code> preço baixo para alto, <code>pd</code> preço alto para baixo</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>tbs</code></td><td>string</td><td>não</td><td>Filtros de tempo e qualidade, por exemplo, últimas 24 horas. Encaminhado literalmente</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/shopping/product`

Retorna um produto do Google Shopping.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="134.5">Nome</th><th width="94">Tipo</th><th width="93.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto do Google Shopping</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/maps`

Retorna listagens locais do Google Maps.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="161">Nome</th><th width="95">Tipo</th><th width="93.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Frase de busca de local ou categoria, por exemplo, <code>dentist vilnius</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>hotel_dates</code></td><td>string</td><td>não</td><td>Datas da estadia. Sem isso, a janela padrão de estadia do Google é usada</td></tr><tr><td><code>hotel_occupancy</code></td><td>inteiro</td><td>não</td><td>Hóspedes no quarto</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Obrigatório com <code>output: ["json"]</code> — este endpoint não tem analisador interno. <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/travel/hotels`

Retorna listagens de hotéis com preços para as datas e ocupação informadas.

{% hint style="success" %}
**Para obter detalhes e preços de sites de reserva de um único hotel**, envie a URL do hotel do Google Travel com o `property_token` valor retornado (por ex., `https://www.google.com/travel/hotels/entity/<property_token>`) para [`POST /v1/scrape/google`](#post-v1-scrape-google) com `output: ["json"]`. Usa o analisador interno sem `JSON` prompt ou schema necessários.
{% endhint %}

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="146.5">Nome</th><th width="104">Tipo</th><th width="95">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Nome do hotel ou destino</td></tr><tr><td><code>adults</code></td><td>inteiro</td><td>não</td><td>Hóspedes adultos</td></tr><tr><td><code>children</code></td><td>inteiro</td><td>não</td><td>Crianças</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Google para pesquisar: <code>com</code>, <code>co.uk</code>, <code>de</code>. Seleciona o índice nacional</td></tr><tr><td><code>hotel_classes</code></td><td>array de inteiros</td><td>não</td><td>Classificações por estrelas a incluir, por exemplo, <code>[4, 5]</code></td></tr><tr><td><code>hotel_dates</code></td><td>string</td><td>não</td><td>Datas da estadia. Sem isso, a janela padrão de estadia do Google é usada</td></tr><tr><td><code>hotel_occupancy</code></td><td>inteiro</td><td>não</td><td>Hóspedes no quarto</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/lens`

Retorna resultados de correspondência visual para uma URL de imagem.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="132">Nome</th><th width="98">Tipo</th><th width="99">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>URL da imagem para correspondência. Não é texto de busca</td></tr><tr><td><code>keywords</code></td><td>string</td><td>não</td><td>Dica de texto para restringir as correspondências visuais</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/google/trends/explore`

Retorna o interesse relativo de busca ao longo do tempo para um termo.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="135">Nome</th><th width="93">Tipo</th><th width="97.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Termo a ser exibido no gráfico</td></tr><tr><td><code>category_id</code></td><td>string</td><td>não</td><td>ID da categoria do Google Trends</td></tr><tr><td><code>date_from</code></td><td>string</td><td>não</td><td>Início da janela, por exemplo, <code>2026-01-01</code></td></tr><tr><td><code>date_to</code></td><td>string</td><td>não</td><td>Fim da janela, por exemplo, <code>2026-06-30</code></td></tr><tr><td><code>search_type</code></td><td>string</td><td>não</td><td>Vertical do Trends, por exemplo, web, imagem, notícias, YouTube ou shopping</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Obrigatório com <code>output: ["json"]</code> — este endpoint não tem analisador interno. <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

Os valores de interesse são relativos, normalizados dentro da janela solicitada: ampliar `date_from` reescala cada ponto.

#### `POST /v1/scrape/google`

Retorna campos analisados de uma página do Google a partir de uma URL fornecida.

{% hint style="info" %}
Este endpoint também pode coletar e analisar **Travel: Hotels** detalhes. Veja [`/google/travel/hotels`](/api-reference/pt-br/scrapers-dedicados/scrapers-de-mecanismos-de-busca.md#post-v1-scrape-google-travel-hotels).
{% endhint %}

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="156.5">Nome</th><th width="100.5">Tipo</th><th width="99.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL do Google</td></tr><tr><td><code>adstest</code></td><td>booleano</td><td>não</td><td>Retorna anúncios da rede de anúncios de teste do Google em vez do inventário ao vivo</td></tr><tr><td><code>adults</code></td><td>inteiro</td><td>não</td><td>Hóspedes adultos</td></tr><tr><td><code>aomd</code></td><td>string</td><td>não</td><td>Não documentado pelo Google. Encaminhado como enviado</td></tr><tr><td><code>category_id</code></td><td>string</td><td>não</td><td>ID da categoria do Google Trends</td></tr><tr><td><code>children</code></td><td>inteiro</td><td>não</td><td>Crianças</td></tr><tr><td><code>cr</code></td><td>string</td><td>não</td><td>Restrição de país. Encaminhado literalmente</td></tr><tr><td><code>date_from</code></td><td>string</td><td>não</td><td>Início da janela, por exemplo, <code>2026-01-01</code></td></tr><tr><td><code>date_to</code></td><td>string</td><td>não</td><td>Fim da janela, por exemplo, <code>2026-06-30</code></td></tr><tr><td><code>disable_scripts</code></td><td>booleano</td><td>não</td><td>Bloqueia scripts da página</td></tr><tr><td><code>expand_aio</code></td><td>booleano</td><td>não</td><td>Expande o bloco AI Overview em vez de retorná-lo recolhido</td></tr><tr><td><code>filter</code></td><td>inteiro</td><td>não</td><td>Filtro de conteúdo duplicado do Google. <code>0</code> desativa-o e retorna resultados quase duplicados</td></tr><tr><td><code>fpstate</code></td><td>string</td><td>não</td><td>Estado da página. Encaminhado literalmente</td></tr><tr><td><code>hotel_classes</code></td><td>array de inteiros</td><td>não</td><td>Classificações por estrelas a incluir, por exemplo, <code>[4, 5]</code></td></tr><tr><td><code>hotel_dates</code></td><td>string</td><td>não</td><td>Datas da estadia. Sem isso, a janela padrão de estadia do Google é usada</td></tr><tr><td><code>hotel_occupancy</code></td><td>inteiro</td><td>não</td><td>Hóspedes no quarto</td></tr><tr><td><code>limit</code></td><td>inteiro</td><td>não</td><td>Número de resultados a retornar</td></tr><tr><td><code>limit_per_page</code></td><td>array de objetos</td><td>não</td><td>Contagens de resultados por página, por exemplo, <code>[{"page": 1, "limit": 20}]</code>. Use em vez de <code>pages</code> quando apenas a página 1 importa</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code>. Afeta a redação dos recursos da SERP, não o ranking</td></tr><tr><td><code>max_price</code></td><td>inteiro</td><td>não</td><td>Maior preço a incluir, na moeda da loja</td></tr><tr><td><code>min_price</code></td><td>inteiro</td><td>não</td><td>Menor preço a incluir, na moeda da loja</td></tr><tr><td><code>nfpr</code></td><td>string</td><td>não</td><td>Suprime a autocorreção ortográfica do Google</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>results_language</code></td><td>string</td><td>não</td><td>Restringe os resultados a um idioma, por exemplo, <code>lt</code>. Filtra, não traduz</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro SafeSearch do Google. Um booleano aqui, uma string no Bing</td></tr><tr><td><code>search_type</code></td><td>string</td><td>não</td><td>Vertical do Trends, por exemplo, web, imagem, notícias, YouTube ou shopping</td></tr><tr><td><code>sort_by</code></td><td>string</td><td>não</td><td><code>r</code> relevância (padrão), <code>rv</code> avaliação alta para baixa, <code>p</code> preço baixo para alto, <code>pd</code> preço alto para baixo</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>tbm</code></td><td>string</td><td>não</td><td>Vertical de busca: imagens, shopping, vídeo, livros. Encaminhado literalmente</td></tr><tr><td><code>tbs</code></td><td>string</td><td>não</td><td>Filtros de tempo e qualidade, por exemplo, últimas 24 horas. Encaminhado literalmente</td></tr><tr><td><code>udm</code></td><td>string</td><td>não</td><td>Seletor do modo de interface do Google. Encaminhado literalmente</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras da origem da solicitação. Independente de <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

Defina um parâmetro no corpo ou na string de consulta da URL, nunca ambos.

### Bing

#### `POST /v1/scrape/bing/search`

Retorna resultados orgânicos do Bing para uma consulta.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="139.5">Nome</th><th width="93.5">Tipo</th><th width="97">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Frase de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do Bing</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>safe_search</code></td><td>string</td><td>não</td><td>Nível de SafeSearch. Uma string aqui, um booleano no Google</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página a buscar. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras de onde buscar, por exemplo, <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

#### `POST /v1/scrape/bing`

Retorna campos analisados de uma página do Bing a partir de uma URL fornecida.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="134">Nome</th><th width="97.5">Tipo</th><th width="92.5">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL do Bing</td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>Markdown</code>, <code>HTML</code>, <code>JSON</code>, <code>captura de tela</code>. Padrão <code>["html"]</code>. <code>JSON</code> retorna campos analisados. <code>captura de tela</code> requer <code>run_js: true</code></td></tr><tr><td><code>JSON</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o analisador interno</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras de onde buscar, por exemplo, <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o trabalho concluído. Apenas assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado para um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Apenas assíncrono. <code>url</code> não é validado</td></tr></tbody></table>


---

# 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/api-reference/pt-br/scrapers-dedicados/scrapers-de-mecanismos-de-busca.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.