# Panduan cepat

Jalankan pencarian Google pertama dan dapatkan hasil terstruktur untuk aplikasi atau agen AI Anda.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/quickstart
Diulang: 2026-11-04 oleh FlashData

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

## Mulai dengan agen AI Anda

Berikan prompt ini kepada agen yang memiliki akses terminal. Agen akan menyiapkan FlashData dan menjalankan satu pencarian.

### Prompt penyiapan dan tugas pertama

```text
Baca https://flashdata.dev/auth.md dan ikuti petunjuk penyiapan FlashData untuk lingkungan ini. Gunakan kembali akses yang ada; jika tidak ada, mulai satu uji coba hanya jika memenuhi syarat. Cari "battery recycling research" di Google dengan maksimal lima hasil. Kembalikan judul sumber, URL, dan kredit yang benar-benar digunakan. Simpan kredensial dalam penyimpanan terlindungi, bukan di chat. Jika akses diblokir, laporkan langkah berikutnya alih-alih membuat uji coba baru.
```

- [Penyiapan MCP](https://flashdata.dev/id/docs/integrations/mcp-clients/reference.md)
- [Skill untuk agen](https://flashdata.dev/id/docs/guides/agent-skill/reference.md)

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

## Lakukan panggilan API pertama

Ingin menulis kodenya sendiri? Ikuti tiga langkah ini di terminal.


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

### Dapatkan API key

Buat akun, verifikasi email, lalu buat key dengan izin Google Search. Jika sudah memiliki key, gunakan kembali.

Jalankan di terminal dan tempel key pada prompt yang menyembunyikan input. Lewati langkah ini jika FLASHDATA_API_KEY sudah diatur.

#### Bash

##### Atur key Anda

```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

##### Atur key Anda

```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
```


- [Buat akun](https://flashdata.dev/signup)
- [Buka API Keys](https://flashdata.dev/app/api-keys)

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

### Jalankan pencarian

Pilih bahasa pemrograman dan jalankan contoh di terminal yang sama. Setiap eksekusi mengirim satu pencarian.

#### Python

Python 3.10+ · Simpan contoh sebagai quickstart.py.

##### Instal

```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))
```

##### Jalankan

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Mulai dari folder kosong dan simpan quickstart.mts.

##### Siapkan

```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));
```

##### Jalankan

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Mulai dari folder kosong dan simpan quickstart.mjs.

##### Siapkan

```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));
```

##### Jalankan

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Mulai dari folder kosong dan simpan main.go. Lewati go mod init jika menggunakan modul yang sudah ada.

##### Siapkan

```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)
    }
}
```

##### Jalankan

```bash
go run .
```


#### HTTP API

Tidak memerlukan SDK. Jalankan perintah Bash / cURL 7.76+ atau 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
```


- [Periksa hasil di bawah](https://flashdata.dev/id/docs/guides/quickstart/reference.md#result)

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

### Periksa hasil

Respons yang berhasil memiliki status: done. Sumber ada di results[].organic, sedangkan kredit yang dikenakan ada di usage.credits.

#### Contoh respons (disingkat)

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

- [Perbaiki pencarian Anda](https://flashdata.dev/id/docs/guides/google-search-guide/reference.md)
- [Coba YouTube Data](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md)
- [Penyiapan API dan pemecahan masalah](https://flashdata.dev/id/docs/guides/http-quickstart/reference.md)

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

## Coba konsol

1. Buat akun atau masuk. Selesaikan verifikasi email dan penyiapan akun yang ditampilkan di konsol.
2. Buka Google Search, pilih sumber Google Search dan mode Realtime, lalu masukkan battery recycling research. Buka Additional parameters dan atur Page size (num) menjadi 5.
3. Periksa permintaan yang ditampilkan dan kredit yang tersedia, lalu jalankan pencarian sekali.
4. Periksa respons dan penggunaan. Buka sumber yang dikembalikan untuk memeriksa isinya sebelum mengutip lebih dari cuplikannya.

- [Buat akun](https://flashdata.dev/signup)
- [Buka Google Search](https://flashdata.dev/app/google-search)

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

## Lanjutkan dari hasil pertama

- [Cari dengan filter](https://flashdata.dev/id/docs/guides/google-search-guide/reference.md)
- [Jelajahi data YouTube](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md)
- [Tambahkan pencarian ke aplikasi](https://flashdata.dev/id/docs/guides/search-in-an-app/reference.md)

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

## Jika permintaan pertama gagal

| Yang Anda lihat | Yang perlu dilakukan |
| --- | --- |
| FLASHDATA_API_KEY belum diatur | Atur key di terminal atau runtime yang sama dengan contoh. Cuplikan ini tidak memuat file .env. |
| 401 / 403 | Pastikan key atau koneksi aktif dan memiliki izin google_search. |
| 402 | Periksa kredit yang tersedia di Billing. Tautkan uji coba yang sudah ada jika memerlukan akses pemilik. |
| 429 | Patuhi Retry-After. Pertahankan identitas dan bukti pendaftaran yang sama; jangan membuat uji coba lain. |
| Timeout atau status pengiriman tidak diketahui | Periksa eksekusi yang ada sebelum mencoba lagi. Pengguna CLI harus mempertahankan profil dan ID eksekusi yang sama; pengguna SDK/API harus menyimpan ID tugas atau permintaan yang dikembalikan. |

