문서 둘러보기
API 참조
응용 프로그램 또는 AI 에이전트에 대한 Markdown 콘텐츠에 대한 구조화된 JSON를 선택하십시오. 2개의 우두머리를 가진 응답을 통제하십시오.
이 페이지의 내용
형식 선택
JSON는 원래 결과 필드가 기본값입니다. Accept는 JSON 또는 일반 텍스트를 선택합니다. X-Respond-With: Markdown는 Markdown에 결과를 변환합니다. 귀하의 요청 몸은 JSON를 유지합니다.
| 응답 | Accept | X-Respond-With | 제품 정보 |
|---|---|---|---|
| JSON | application/json | 오미트 | 코드의 파싱 필드 · default |
| JSON + Markdown | application/json | markdown | Structured metadata와 Agent 컨텍스트 |
| 일반 텍스트 | text/plain | 오미트 | 터미널에서 원래 필드를 읽으십시오 |
| 텍스트 + Markdown | text/plain | markdown | 메타데이터와 Markdown를 함께 읽으십시오 |
요청 및 응답 예제
이 탭은 각 형식의 동일한 Google Search를 보여줍니다. Bash 및 cURL 7.76+를 FLASHDATA_API_KEY로 설정하여 google_search를 허용하는 키로 설정합니다. 명령을 실행하면 청구 가능한 검색을 제출합니다.
기본 정보 결과 배열을 파; 내부의 필드는 소스에 달려 있습니다.
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"
}Markdown 문자열로 내용을 읽으십시오. 결과를 대체합니다; 소스, 상태 및 사용은 JSON 필드로 사용할 수 있습니다.
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"
}텍스트로 응답을 읽으십시오. JSON 문서가 아닌 indented layout의 원래 필드를 포함합니다.
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"
텍스트로 응답을 읽으십시오: 첫째로 메타데이터, Markdown 내용에 따라 따르십시오.
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\.
지원되는 endpoints
동일한 규칙은 Google Search 및 YouTube 쿼리 소스에 적용됩니다. YouTube Download를 위해, 그들은 납품 기록, 영상 또는 오디오 바이트를 포맷합니다. 계정 APIs, Bulk와 NDJSON 부품, 콜백 및 MCP 응답은 자신의 형식을 사용합니다.
| 끝점 | JSON / 일반 텍스트 | Markdown 내용 |
|---|---|---|
| POST /v1/queries/realtime | 지원되는 | 지원되는 |
| GET /v2/jobs/{id}/results | 지원되는 | 지원되는 |
| POST /v1/queries | 제출 영수증 | Ignored - 결과를 읽을 때 그것을 선택하십시오 |
| POST /v1/queries/batch | 제출 영수증 | Ignored - 결과를 읽을 때 그것을 선택하십시오 |
| GET /v2/jobs/{id} | 작업 상태 | Ignored - 결과 내용이 없습니다 |
완료된 작업 결과 형식
결과를 읽을 때 헤더를 설정하면 제출에 설정할 수 있습니다. JOB_ID를 완료한 작업으로 접속할 수 있습니다. 이 GET는 다른 쿼리를 제출하지 않고 기존 결과를 읽습니다.
| 요청된 형식 | 결과 응답 |
|---|---|
| 본래 JSON | 302 응답의 Location에 서명된 저장소 URL이 포함됩니다. X-API-Key 없이 해당 URL을 별도로 조회하세요. 저장된 결과는 gzip으로 압축되어 있을 수 있습니다. |
| 일반 텍스트 또는 Markdown 옵션 | 200는 응답에서 직접 배열한 몸으로. |
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'형식 오류
API 오류는 JSON 또는 application/problem+json에 남아있을 때 일반 텍스트를 요청합니다. HTTP 상태를 확인하기 전에 성공 형식을 파싱합니다.
| 상태 / 코드 | 해결 |
|---|---|
| 400 · unsupported_representation | X-Respond-With를 사용하십시오: 마침 또는 우두머리를 omit. json 또는 text와 같은 값은 지원되지 않습니다. |
| 406 · not_acceptable | Accept를 사용하십시오: application/json 또는 text/plain. text/markdown와 application/xml는 지원되지 않습니다. |
Accept 헤더 세부 정보
Omit Accept 또는 JSON를 얻기 위하여 */*를 보내십시오. 응답은 UTF-8를 사용합니다. 미디어 범위와 q 무게가 지원됩니다. 지원되지 않은 charset는 다른 허용 범위 일치하지 않는 406를 반환합니다. Content-Type: application/json는 응답이 아닙니다 요구 몸, 설명합니다.
Accept: text/plain; charset=utf-8, application/json;q=0.8