> 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/destinos/llms-e-ia/gemini.md).

# Gemini

Extraia respostas do Gemini enviando prompts e receba dados analisados como JSON estruturado, texto simples ou Markdown.

A `gemini` source permite que você envie um prompt ao Google **Gemini** e receba uma resposta analisada e estruturada, incluindo as respostas em texto simples e Markdown.

## Exemplos de requisição

Os exemplos de código a seguir mostram como enviar um prompt ao Gemini usando [**Push-Pull**](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods/push-pull.md).

{% tabs %}
{% tab title="cURL" %}

<pre class="language-bash"><code class="lang-bash">curl 'https://data.oxylabs.io/v1/queries' \\
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
<strong>-d '{
</strong>        "source": "gemini",
        "prompt": "sites oficiais dos parques nacionais mais visitados dos EUA",
        "parse": true,
        "geo_location": "Estados Unidos",
        "callback_url": "https://your-server.com/oxylabs-callback"
    }'
</code></pre>

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Structure payload.
payload = {
    'source': 'gemini',
    'prompt': 'sites oficiais dos parques nacionais mais visitados dos EUA',
    'parse': True,
    'geo_location': "Estados Unidos",
    'callback_url': "https://your-server.com/oxylabs-callback"
}

# Get response.
response = requests.request(
    'POST',
    'https://data.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Imprima a resposta formatada no stdout.
pprint(response.json())
```

{% endtab %}

{% tab title="Node.js" %}

```js
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "gemini",
    prompt: "sites oficiais dos parques nacionais mais visitados dos EUA",
    parse: true,
    geo_location: "Estados Unidos",
    callback_url: "https://your-server.com/oxylabs-callback"
};

const options = {
    hostname: "data.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'gemini',
    'prompt' => 'sites oficiais dos parques nacionais mais visitados dos EUA',
    'parse' => true,
    'geo_location' => "Estados Unidos",
    'callback_url' => "https://your-server.com/oxylabs-callback"
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://data.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
```

{% endtab %}

{% tab title="Go" %}

```go
package main

import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)

func main() {
const Username = "USERNAME"
const Password = "PASSWORD"

payload := map[string]interface{}{
"source":       "gemini",
"prompt":       "sites oficiais dos parques nacionais mais visitados dos EUA",
"parse":        true,
"geo_location": "Estados Unidos",
"callback_url": "https://your-server.com/oxylabs-callback",
}

jsonValue, _ := json.Marshal(payload)

client := &http.Client{}
request, _ := http.NewRequest("POST",
"https://data.oxylabs.io/v1/queries",
bytes.NewBuffer(jsonValue),
)

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.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new
            {
                source = "gemini",
                prompt = "sites oficiais dos parques nacionais mais visitados dos EUA",
                parse = true,
                geo_location = "Estados Unidos",
                callback_url = "https://your-server.com/oxylabs-callback"
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://data.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
package org.example;

import okhttp3.*;
import org.json.JSONObject;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "gemini");
        jsonObject.put("prompt", "sites oficiais dos parques nacionais mais visitados dos EUA");
        jsonObject.put("parse", true);
        jsonObject.put("geo_location", "Estados Unidos");
        jsonObject.put("callback_url", "https://your-server.com/oxylabs-callback");

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://data.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "gemini",
    "prompt": "sites oficiais dos parques nacionais mais visitados dos EUA",
    "parse": true,
    "geo_location": "Estados Unidos",
    "callback_url": "https://your-server.com/oxylabs-callback"
}
```

{% endtab %}
{% endtabs %}

Enviar um job com [**Push-Pull**](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods/push-pull.md) integração (incluindo [consultas em lote](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods/push-pull.md#batch-query)) método retorna o ID do job imediatamente – não o resultado. Quando o status do job for `concluído`, recupere a resposta analisada. Veja [**Método de integração**](https://developers.oxylabs.io/products/pt-br/web-scraper-api/integration-methods.md) na página LLMs e IA para o fluxo completo de envio e recuperação.

### Parâmetros da solicitação

Configuração básica e opções de personalização para extrair dados do Gemini.

<table><thead><tr><th width="222">Parâmetro</th><th width="350.3333333333333">Descrição</th><th>Valor padrão</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong><code>source</code></strong></mark></td><td>Define o alvo do scraper. Use prompt <code>gemini</code>.</td><td>–</td></tr><tr><td><mark style="background-color:green;"><strong><code>prompt</code></strong></mark></td><td>O prompt ou pergunta a ser enviada ao Gemini. Até 8.000 caracteres.</td><td>–</td></tr><tr><td><code>callback_url</code></td><td><strong>Recomendado.</strong> URL onde entregamos uma notificação assim que o job for concluído. <a href="https://developers.oxylabs.io/products/web-scraper-api/integration-methods/push-pull"><strong>Mais informações</strong></a><strong>.</strong></td><td>–</td></tr><tr><td><code>parse</code></td><td>Defina como <code>true</code> para dados JSON estruturados.</td><td><code>false</code></td></tr><tr><td><code>geo_location</code></td><td>Especifique um país de onde rotear a solicitação. <a href="https://developers.oxylabs.io/products/pt-br/web-scraper-api/features/localization.md"><strong>Mais informações</strong></a>.</td><td>–</td></tr></tbody></table>

&#x20;   \- parâmetro obrigatório

## Dados estruturados

Depois que o job é recuperado pelo endpoint de resultados Push-Pull, o Web Scraper API é capaz de extrair um objeto JSON que contém a saída do Gemini, oferecendo dados estruturados sobre vários elementos da página de resultados.

<details>

<summary><code>gemini</code> saída estruturada</summary>

```json
{
  "results": [
    {
      "job_id": "7524040226335899649",
      "status_code": 200,
      "url": "https://gemini.google.com/app/3e15e0cac7f94e74",
      "content": {
        "prompt": "sites oficiais dos parques nacionais mais visitados dos EUA",
        "response_text": "Aqui estão os sites oficiais do National Park Service (NPS) para os 10 parques nacionais mais visitados dos EUA, com base nas estatísticas anuais de visitantes: Great Smoky Mountains National Park (Carolina do Norte e Tennessee) Site oficial: nps.gov/grsm Zion Nati...",
        "markdown_text": "Aqui estão os sites oficiais do National Park Service (NPS) para os **10 parques nacionais mais visitados dos EUA**, com base nas estatísticas anuais de visitantes:\n\n1. **Great Smoky Mountains National Park** (Carolina do Norte e Tennessee)\n\n   * **Site oficial:**...",
        "citations": [
          {
            "description": "Título da tabela: Top 10 parques nacionais mais visitados em 2025 Conteúdo da tabela: | \nClassificação | Parque nacional | visitas em 2025 | Estado / fonte / tendência | | --- | --- | \n--- | --- |...",
            "text": "Aqui estão os sites oficiais do National Park Service (NPS) para os **10 parques nacionais mais visitados dos EUA**, com base nas estatísticas anuais de visitantes:",
            "title": "Parques nacionais dos EUA mais visitados em 2025: todos os 63 classificados - StatRanker",
            "url": "https://statranker.org/nature/most-visited-u-s-national-parks-in-2025-rankings-and-visitor-trends/#:~:text=Table_title%3A%20Top%2010%20most%20visited%20national%20parks,YoY%20%2B0.8%25%20(calculated_value)%3B%202024%20rank%20%232%20(unchanged)."
          },
          {
            "description": "Título da tabela: Classificação completa: todos os 63 parques nacionais dos EUA em 2025 \nConteúdo da tabela: | Rank | Parque nacional | visitas em 2025 | Estado / fonte / \ntendência | | --- | --- | -...",
            "text": "(Carolina do Norte e Tennessee)",
            "title": "Parques nacionais dos EUA mais visitados em 2025: todos os 63 classificados - StatRanker",
            "url": "https://statranker.org/nature/most-visited-u-s-national-parks-in-2025-rankings-and-visitor-trends/#:~:text=Table_title%3A%20Complete%20ranking%3A%20All%2063%20U.S.%20national,(2025).%202024%20NPS%3A%204%2C946%2C592%3B%20YoY%20%2B0.8%25%20(calculated_value)%3B"
          },
          {
            "description": "Título da tabela: Classificação completa: todos os 63 parques nacionais dos EUA em 2025 \nConteúdo da tabela: | Rank | Parque nacional | visitas em 2025 | Estado / fonte / \ntendência | | --- | --- | -...",
            "text": "(Utah)",
            "title": "Parques nacionais dos EUA mais visitados em 2025: todos os 63 classificados - StatRanker",
            "url": "https://statranker.org/nature/most-visited-u-s-national-parks-in-2025-rankings-and-visitor-trends/#:~:text=Table_title%3A%20Complete%20ranking%3A%20All%2063%20U.S.%20national,(2025).%202024%20NPS%3A%204%2C946%2C592%3B%20YoY%20%2B0.8%25%20(calculated_value)%3B"
          },
          ...
        ],
        "related_queries": [
          "Quais dos parques nacionais dos EUA mais visitados exigem reservas antecipadas, passes de entrada com horário marcado ou permissões por sorteio para trilhas?"
        ],
        "links": [
          {
            "text": "nps.gov/grsm",
            "url": "https://www.nps.gov/grsm"
          },
          {
            "text": "nps.gov/zion",
            "url": "https://www.nps.gov/zion"
          },
          {
            "text": "nps.gov/yell",
            "url": "https://www.nps.gov/yell"
          },
          ...
        ],
        "additional_results": {
          "sources_results": [
            {
              "title": "Estatísticas de visitação - Ciências sociais (U.S. National Park Service)",
              "url": "https://www.nps.gov/subjects/socialscience/highlights.htm"
            },
            {
              "title": "Explore os parques nacionais da América. Descubra nossos mais preciosos",
              "url": "https://www.nationalparks.org/explore/parks"
            },
            ...
          ],
          "videos_results": [
            {
              "thumbnail": "https://i.ytimg.com/vi/bme0rs75Z3E/maxresdefault.jpg",
              "title": "Guia de viagem de férias do Yellowstone National Park | Expedia",
              "url": "http://www.youtube.com/watch?v=bme0rs75Z3E"
            },
            {
              "thumbnail": "https://i.ytimg.com/vi/QYiddvAhffI/maxresdefault.jpg",
              "title": "GRAND CANYON NATIONAL PARK: Guia de viagem definitivo",
              "url": "http://www.youtube.com/watch?v=QYiddvAhffI"
            },
            ...
          ]
        },
        "model": "3.5 Flash-Lite",
        "parse_status_code": 12000
      }
    }
  ]
}
```

</details>

{% hint style="warning" %}
A composição da resposta pode variar dependendo de se a consulta foi feita a partir de um **desktop** or **pesquisa móvel** dispositivo.
{% endhint %}

### Dicionário de dados de saída

Todos os destinos de LLM retornam o mesmo envelope de nível superior de `job` e `results[]` . Veja [LLMs e IA](https://developers.oxylabs.io/api-reference/pt-br/scrapers-dedicados/scrapers-de-llm-e-ia.md) para a referência completa de metadados.

A tabela a seguir mostra os campos específicos de Gemini em `results[].content` fields:

<table><thead><tr><th width="181.17578125">Nome do campo</th><th width="427">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>Prompt enviado.</td><td>cadeia de caracteres</td></tr><tr><td><code>raw_response</code></td><td>Resposta bruta em streaming do Gemini, uma linha por item.</td><td>array de strings</td></tr><tr><td><code>response_text</code></td><td>Resposta em texto simples do Gemini.</td><td>cadeia de caracteres</td></tr><tr><td><code>markdown_text</code></td><td>Resposta completa em Markdown.</td><td>cadeia de caracteres</td></tr><tr><td><mark style="background-color:$warning;"><code>citations</code></mark></td><td>Citações de fontes referenciadas na resposta. Cada objeto contém <code>title</code>, <code>url</code>, <code>text</code>, e <code>description</code>.</td><td>vetor</td></tr><tr><td><mark style="background-color:$warning;"><code>additional_results</code></mark></td><td><p>Dados adicionais anexados à resposta. Cada lista é retornada apenas quando presente na resposta: </p><ul><li><code>sources_results</code> - páginas da web que o Gemini consultou ao responder (<code>url</code> , e opcional <code>title</code>). </li><li><code>images_results</code> - imagens mostradas na resposta (<code>title</code>, <code>image_url</code> , e opcional <code>image_from_url</code> - a página de onde a imagem vem). </li><li><code>videos_results</code> - vídeos do YouTube mostrados na resposta (<code>url</code>, <code>title</code> , e opcional <code>thumbnail</code>).</li></ul></td><td>objeto</td></tr><tr><td><mark style="background-color:$warning;"><code>related_queries</code></mark></td><td>Perguntas de acompanhamento que o Gemini sugere abaixo da resposta.</td><td>array de strings</td></tr><tr><td><mark style="background-color:$warning;"><code>links</code></mark></td><td>Lista de objetos para links escritos dentro do texto da resposta: <code>url</code> e <code>text</code>. <code>text</code> pode ficar vazio se o link não tiver texto visível.</td><td>vetor</td></tr><tr><td><code>parse_status_code</code></td><td><code>12000</code> – bem-sucedido. Caso contrário, o parser falhou ao extrair alguns ou todos os campos estruturados.</td><td>inteiro</td></tr><tr><td><mark style="background-color:$warning;"><code>model</code></mark></td><td>Modelo de IA usado para gerar a resposta.</td><td>cadeia de caracteres</td></tr></tbody></table>

&#x20;    – condicional, retornado somente quando o conteúdo estiver na resposta do LLM.


---

# 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/destinos/llms-e-ia/gemini.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.
