Belgeleri incele
API başvurusu
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ıt | Accept | X-Respond-With | Kullanım için kullanım |
|---|---|---|---|
| JSON | application/json | Omit | Koddaki alanların belirlenmesi · varsayılan |
| JSON + Markdown | application/json | markdown | yapılandırılmış metadata ile Agent context with configured metadatata |
| Düz metin çevirisi | text/plain | Omit | Bir terminalde orijinal alanları okumak |
| Text + Markdown | text/plain | markdown | Metadata 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.
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"}'{
"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"
}Bir Markdown dizesi olarak içeriği okuyun. Sonuçları değiştirir; kaynak, durum ve kullanım JSON alanları olarak kullanılabilir.
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' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}Yanıtı metin olarak okuyun. Orijinal alanları bir indented düzende içeriyor, bir JSON belgesi değil.
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: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
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"
Yanıtı metin olarak okuyun: metadata ilk olarak, Markdown içerik tarafından takip edildi.
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: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
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.
| Endpoint | JSON / düz metin | Markdown content |
|---|---|---|
| POST /v1/queries/realtime | Desteklendi Desteklendi | Desteklendi Desteklendi |
| GET /v2/jobs/{id}/results | Desteklendi Desteklendi | Desteklendi Desteklendi |
| POST /v1/queries | Submission mak | Ignored – sonuçları okurken onu seçin |
| POST /v1/queries/batch | Submission mak | Ignored – sonuçları okurken onu seçin |
| GET /v2/jobs/{id} | İş durumu | Ignored - 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 format | Son yanıt |
|---|---|
| Orijinal JSON | 302 İ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ği | 200, doğrudan yanıtda biçimlenen bedenle. |
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 / kod | Fix Fix |
|---|---|
| 400 · unsupported_representation | X-Respond-With'u kullanın: işaret ya da başlığı omit. json veya metin gibi değerler desteklenmez. |
| 406 · not_acceptable | Accept: 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.
Accept: text/plain; charset=utf-8, application/json;q=0.8