# Hızlı başlangıç

İlk Google aramanızı çalıştırın ve uygulamanız veya yapay zekâ ajanınız için yapılandırılmış sonuçlar alın.

Canonical referans: https://flashdata.dev/tr/docs/guides/quickstart
İnceleme: 2026-11-04 Tarafından FlashData

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

## Yapay zekâ ajanınızla başlayın

Bu istemi terminal erişimi olan bir ajana verin. Ajan FlashData’yı kurar ve bir arama çalıştırır.

### Kurulum ve ilk görev istemi

```text
https://flashdata.dev/auth.md adresini okuyun ve bu ortam için FlashData kurulum adımlarını izleyin. Mevcut erişimi yeniden kullanın; erişim yoksa ve koşulları karşılıyorsanız yalnızca bir deneme başlatın. Google’da "battery recycling research" ifadesini en fazla beş sonuçla arayın. Kaynak başlıklarını, URL’leri ve gerçekten kullanılan kredileri döndürün. Kimlik bilgilerini sohbette değil, korumalı depolamada tutun. Erişim engellenirse başka bir deneme oluşturmak yerine gereken sonraki adımı bildirin.
```

- [MCP kurulumu](https://flashdata.dev/tr/docs/integrations/mcp-clients/reference.md)
- [Ajan becerileri](https://flashdata.dev/tr/docs/guides/agent-skill/reference.md)

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

## İlk API çağrınızı yapın

Kodu kendiniz mi yazmak istiyorsunuz? Terminalde bu üç adımı izleyin.


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

### API anahtarı alın

Hesap oluşturun, e-postanızı doğrulayın ve Google Search izni olan bir anahtar oluşturun. Böyle bir anahtarınız varsa yeniden kullanın.

Terminalde çalıştırın ve anahtarı gizli giriş istemine yapıştırın. FLASHDATA_API_KEY zaten ayarlıysa bu adımı atlayın.

#### Bash

##### Anahtarınızı ayarlayın

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

##### Anahtarınızı ayarlayın

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


- [Hesap oluştur](https://flashdata.dev/signup)
- [API Keys sayfasını aç](https://flashdata.dev/app/api-keys)

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

### Arama çalıştırın

Bir dil seçin ve örneği aynı terminalde çalıştırın. Her çalıştırma bir arama gönderir.

#### Python

Python 3.10+ · Örneği quickstart.py olarak kaydedin.

##### Yükle

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

##### Çalıştır

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Boş bir klasörde başlayın ve quickstart.mts dosyasını kaydedin.

##### Yapılandır

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

##### Çalıştır

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Boş bir klasörde başlayın ve quickstart.mjs dosyasını kaydedin.

##### Yapılandır

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

##### Çalıştır

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Boş bir klasörde başlayın ve main.go dosyasını kaydedin. Mevcut modülde go mod init adımını atlayın.

##### Yapılandır

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

##### Çalıştır

```bash
go run .
```


#### HTTP API

SDK gerekmez. Bash / cURL 7.76+ veya PowerShell 7 komutunu çalıştırın.

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


- [Aşağıdaki sonucu kontrol edin](https://flashdata.dev/tr/docs/guides/quickstart/reference.md#result)

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

### Sonucu kontrol edin

Başarılı yanıtta status: done bulunur. Kaynaklar results[].organic, kullanılan krediler ise usage.credits alanındadır.

#### Örnek yanıt (kısaltılmış)

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

- [Aramanızı iyileştirin](https://flashdata.dev/tr/docs/guides/google-search-guide/reference.md)
- [YouTube Data hizmetini deneyin](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md)
- [API kurulumu ve sorun giderme](https://flashdata.dev/tr/docs/guides/http-quickstart/reference.md)

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

## Konsolu deneyin

1. Hesap oluşturun veya oturum açın. E-posta doğrulamasını ve konsolda gösterilen hesap kurulum adımlarını tamamlayın.
2. Google Search sayfasını açın, Google Search kaynağını ve Realtime modunu seçip battery recycling research yazın. Additional parameters bölümünü açın ve Page size (num) değerini 5 yapın.
3. Gösterilen isteği ve kullanılabilir kredileri kontrol edip aramayı bir kez çalıştırın.
4. Yanıtı ve kullanımı inceleyin. Alıntının ötesinde bir bilgiyi kaynak göstermeden önce dönen kaynağı açıp içeriğini kontrol edin.

- [Hesap oluştur](https://flashdata.dev/signup)
- [Google Search sayfasını aç](https://flashdata.dev/app/google-search)

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

## İlk sonuçtan devam edin

- [Filtrelerle arayın](https://flashdata.dev/tr/docs/guides/google-search-guide/reference.md)
- [YouTube verilerini keşfedin](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md)
- [Uygulamaya arama ekleyin](https://flashdata.dev/tr/docs/guides/search-in-an-app/reference.md)

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

## İlk istek başarısız olursa

| Gördüğünüz durum | Yapılacak işlem |
| --- | --- |
| FLASHDATA_API_KEY eksik | Anahtarı örneğin çalıştığı terminalde veya çalışma ortamında ayarlayın. Bu örnekler .env dosyalarını yüklemez. |
| 401 / 403 | Anahtarın veya bağlantının etkin olduğunu ve google_search izni bulunduğunu kontrol edin. |
| 402 | Billing bölümünde kullanılabilir kredileri kontrol edin. Hesap sahibi erişimi gerekiyorsa mevcut denemeyi hesabınıza bağlayın. |
| 429 | Retry-After değerine uyun. Aynı kimliği ve kayıt kanıtını koruyun; başka bir deneme oluşturmayın. |
| Zaman aşımı veya gönderim durumu bilinmiyor | Yeniden denemeden önce mevcut çalıştırmayı inceleyin. CLI kullanıcıları aynı profili ve çalıştırma kimliğini korumalı; SDK/API kullanıcıları döndürülen iş veya istek kimliğini kaydetmelidir. |

