İçeriğe geç
TR
API anahtarı al
Belgeleri incele

API başvurusu

Yanıt biçimleri

Uygulamanız veya Markdown içeriğiniz için yapılandırılmış JSON'u bir AI ajanı için seçin. Yanıtı iki başlıkla kontrol edin.

Bu sayfada

Bir format seçin

JSON orijinal sonuç alanları ile varsayılandır. Accept, JSON veya düz metin seçer; X-Respond-With: işaretlenme sonucu içeriği Markdown'ye dönüştürür. İstek vücudunuz JSON'u kalır.

YanıtAcceptX-Respond-WithKullanım için kullanım
JSONapplication/jsonOmitKoddaki alanların belirlenmesi · varsayılan
JSON + Markdownapplication/jsonmarkdownyapılandırılmış metadata ile Agent context with configured metadatata
Düz metin çevirisitext/plainOmitBir terminalde orijinal alanları okumak
Text + Markdowntext/plainmarkdownMetadata ve Markdown ile birlikte okumak

İstek ve yanıt örnekleri

Bu sekmeler her formatta aynı Google Search'u gösteriyor. Bash ve cURL 7.76+ ile FLASHDATA_API_KEY, google_search'ye izin veren bir anahtara işaret ediyor. Bir komutla çalıştırılabilir bir arama gönderir.

Varsayılan olarak. Sonuçlar dizisini özetler; içindeki alanlar kaynağa bağlıdır.

İstek · cURL / Bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"source":"google_search","query":"vector databases"}'
Örnek yanıt · illüstrasyonel değerler
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Example page",
          "link": "https://example.com/article",
          "snippet": "A short source snippet."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-10-22T12:00:00.000Z"
}

Desteklenen uç noktaları

Aynı kurallar Google Search ve YouTube sorgu kaynaklarına uygulanır. YouTube Download için, teslimat rekorunu formatlıyorlar, video veya ses totes değil. Hesap API'leri, Bulk ve NDJSON parçalar, çağrılar ve MCP yanıtları kendi formatlarını kullanır.

EndpointJSON / düz metinMarkdown content
POST /v1/queries/realtimeDesteklendi DesteklendiDesteklendi Desteklendi
GET /v2/jobs/{id}/resultsDesteklendi DesteklendiDesteklendi Desteklendi
POST /v1/queriesSubmission makIgnored – sonuçları okurken onu seçin
POST /v1/queries/batchSubmission makIgnored – sonuçları okurken onu seçin
GET /v2/jobs/{id}İş durumuIgnored - burada içerik yok

Tamamlanan bir iş sonucu

Sonuç okuduğunuz zaman kafaları ayarlayın, hatta onları teslim etmeye ayarlarsanız. JOB_ID'u erişebileceğiniz tamamlanmış bir iş için ayarlayın. Bu GET, başka bir sorgu sunmadan mevcut sonuçları okur.

İstekli formatSon yanıt
Orijinal JSON302 İmzalanan bir depolama ile URL Konum olarak. URL'un X-API-Key olmadan ayrı olduğunu. Mağazalı sonuçlar gzip-comed olabilir.
Plain text veya Markdown seçeneği200, doğrudan yanıtda biçimlenen bedenle.
Markdown içinde JSON · cURL / Bash
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json' \
  --header 'X-Respond-With: markdown'

Biçim hataları

API hataları JSON veya application/problem+json, düz metin talep ettiğinizde bile kalır. Başarı biçimini reddetmeden önce HTTP statüsünü kontrol edin.

Durum / kodFix Fix
400 · unsupported_representationX-Respond-With'u kullanın: işaret ya da başlığı omit. json veya metin gibi değerler desteklenmez.
406 · not_acceptableAccept: application/json veya text/plain. text/markdown ve application/xml desteklenmez.

Accept başlık detayları

Omit Accept veya * JSON'u almak için gönder. Yanıtlar UTF-8'u kullanır. Medya aralıkları ve q ağırlıkları destekleniyor; desteklenmeyen bir karset, başka bir kabul edilebilir aralık maçları olmadıkça 406'yu geri döndürür. Content-Type: application/json, istek cesedini tarif eder, cevap vermez.

Yazıyı tercih edin, JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8