# Início rápido

Faça sua primeira pesquisa no Google e obtenha resultados estruturados para seu aplicativo ou agente de IA.

Referência canônica: https://flashdata.dev/pt/docs/guides/quickstart
2026-11-04 por FlashData

<a id="agent"></a>

## Comece com seu agente de IA

Envie estas instruções a um agente com acesso ao terminal. Ele configura o FlashData e faz uma pesquisa.

### Instruções de configuração e primeira tarefa

```text
Leia https://flashdata.dev/auth.md e siga as instruções de configuração do FlashData para este ambiente. Reutilize o acesso existente; se não houver acesso, inicie uma única avaliação se você atender aos requisitos. Pesquise no Google por "battery recycling research", com no máximo cinco resultados. Retorne os títulos das fontes, as URLs e os créditos efetivamente usados. Guarde as credenciais em armazenamento protegido, nunca no chat. Se o acesso estiver bloqueado, informe a próxima etapa em vez de criar outro teste.
```

- [Configurar MCP](https://flashdata.dev/pt/docs/integrations/mcp-clients/reference.md)
- [Skills para agentes](https://flashdata.dev/pt/docs/guides/agent-skill/reference.md)

<a id="application"></a>

## Faça sua primeira chamada à API

Prefere escrever o código? Siga estas três etapas no terminal.


<a id="api-key"></a>

### Obtenha uma chave de API

Crie uma conta, verifique seu e-mail e crie uma chave com permissão para Google Search. Se você já tem uma chave, reutilize-a.

Execute este comando no terminal e cole a chave na entrada oculta. Pule esta etapa se FLASHDATA_API_KEY já estiver definida.

#### Bash

##### Definir sua chave

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### Definir sua chave

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Criar uma conta](https://flashdata.dev/signup)
- [Abrir API Keys](https://flashdata.dev/app/api-keys)

<a id="request"></a>

### Faça uma pesquisa

Escolha uma linguagem e execute o exemplo no mesmo terminal. Cada execução faz uma pesquisa.

#### Python

Python 3.10+ · Salve o exemplo como quickstart.py.

##### Instalar

```bash
python -m pip install "flashdata==1.1.0"
```

##### quickstart.py

```python
import json
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    print(json.dumps(response, indent=2))
```

##### Executar

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Comece em uma pasta vazia e salve quickstart.mts.

##### Configurar

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mts

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Executar

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Comece em uma pasta vazia e salve quickstart.mjs.

##### Configurar

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Executar

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Comece em uma pasta vazia e salve main.go. Em um módulo existente, não execute go mod init.

##### Configurar

```bash
go mod init example.com/flashdata-quickstart
go get github.com/flashdatadev/flashdata-go@v1.1.0
```

##### main.go

```go
package main

import (
    "context"
    "encoding/json"
    "log"
    "os"
    "time"

    flashdata "github.com/flashdatadev/flashdata-go"
)

func main() {
    key := os.Getenv("FLASHDATA_API_KEY")
    if key == "" {
        log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
    }
    client, err := flashdata.New(flashdata.Options{APIKey: key})
    if err != nil {
        log.Fatal(err)
    }
    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
    defer cancel()
    result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
        Query: "battery recycling research",
        Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
    })
    if err != nil {
        // Do not automatically resubmit an uncertain paid request.
        log.Fatal(err)
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
        log.Fatal(err)
    }
    if result.Status != "done" {
        log.Fatalf("Search did not complete: %s", result.Status)
    }
}
```

##### Executar

```bash
go run .
```


#### HTTP API

Nenhum SDK é necessário. Execute o comando Bash / cURL 7.76+ ou o comando PowerShell 7.

##### Bash / cURL

```bash
curl --fail-with-body --silent --show-error \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
```

##### PowerShell 7

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest
$flashdataResult | ConvertTo-Json -Depth 20
```


- [Confira o resultado abaixo](https://flashdata.dev/pt/docs/guides/quickstart/reference.md#result)

<a id="result"></a>

### Confira o resultado

Uma resposta bem-sucedida contém status: done. As fontes estão em results[].organic, e os créditos cobrados, em usage.credits.

#### Exemplo de resposta (resumido)

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```

- [Melhore sua pesquisa](https://flashdata.dev/pt/docs/guides/google-search-guide/reference.md)
- [Experimente YouTube Data](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md)
- [Configuração e solução de problemas da API](https://flashdata.dev/pt/docs/guides/http-quickstart/reference.md)

<a id="console"></a>

## Experimente o console

1. Crie uma conta ou entre na sua. Verifique o e-mail e conclua as etapas de configuração exibidas no console.
2. Abra Google Search, selecione a fonte Google Search e o modo Realtime e digite battery recycling research. Expanda Additional parameters e defina Page size (num) como 5.
3. Confira a requisição exibida e os créditos disponíveis e execute a pesquisa uma vez.
4. Examine a resposta e o uso. Abra uma fonte retornada para verificar seu conteúdo antes de citar informações além do trecho exibido.

- [Criar uma conta](https://flashdata.dev/signup)
- [Abrir Google Search](https://flashdata.dev/app/google-search)

<a id="next"></a>

## Continue a partir do primeiro resultado

- [Pesquise com filtros](https://flashdata.dev/pt/docs/guides/google-search-guide/reference.md)
- [Explore os dados do YouTube](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md)
- [Adicione pesquisa a um aplicativo](https://flashdata.dev/pt/docs/guides/search-in-an-app/reference.md)

<a id="troubleshooting"></a>

## Se a primeira requisição falhar

| O que aparece | O que fazer |
| --- | --- |
| FLASHDATA_API_KEY ausente | Defina a chave no mesmo terminal ou ambiente que executa o exemplo; estes trechos não carregam arquivos .env. |
| 401 / 403 | Confira se a chave ou conexão está ativa e tem a permissão google_search. |
| 402 | Confira os créditos disponíveis em Billing. Vincule o teste existente quando precisar de acesso do titular. |
| 429 | Respeite Retry-After. Mantenha a mesma identidade e prova de registro; não crie outro teste. |
| Tempo limite ou envio com resultado desconhecido | Verifique a execução existente antes de tentar novamente. Na CLI, mantenha o mesmo perfil e ID de execução; com SDK/API, preserve qualquer ID de trabalho ou requisição retornado. |

