본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

API 참조

응답 형식

응용 프로그램 또는 AI 에이전트에 대한 Markdown 콘텐츠에 대한 구조화된 JSON를 선택하십시오. 2개의 우두머리를 가진 응답을 통제하십시오.

이 페이지의 내용

형식 선택

JSON는 원래 결과 필드가 기본값입니다. Accept는 JSON 또는 일반 텍스트를 선택합니다. X-Respond-With: Markdown는 Markdown에 결과를 변환합니다. 귀하의 요청 몸은 JSON를 유지합니다.

응답AcceptX-Respond-With제품 정보
JSONapplication/json오미트코드의 파싱 필드 · default
JSON + Markdownapplication/jsonmarkdownStructured metadata와 Agent 컨텍스트
일반 텍스트text/plain오미트터미널에서 원래 필드를 읽으십시오
텍스트 + Markdowntext/plainmarkdown메타데이터와 Markdown를 함께 읽으십시오

요청 및 응답 예제

이 탭은 각 형식의 동일한 Google Search를 보여줍니다. Bash 및 cURL 7.76+를 FLASHDATA_API_KEY로 설정하여 google_search를 허용하는 키로 설정합니다. 명령을 실행하면 청구 가능한 검색을 제출합니다.

기본 정보 결과 배열을 파; 내부의 필드는 소스에 달려 있습니다.

요청 · 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"}'
예제 응답 · 설명 값
{
  "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"
}

지원되는 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는 다른 쿼리를 제출하지 않고 기존 결과를 읽습니다.

요청된 형식결과 응답
본래 JSON302 응답의 Location에 서명된 저장소 URL이 포함됩니다. X-API-Key 없이 해당 URL을 별도로 조회하세요. 저장된 결과는 gzip으로 압축되어 있을 수 있습니다.
일반 텍스트 또는 Markdown 옵션200는 응답에서 직접 배열한 몸으로.
JSON 안의 Markdown 가져오기 · 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'

형식 오류

API 오류는 JSON 또는 application/problem+json에 남아있을 때 일반 텍스트를 요청합니다. HTTP 상태를 확인하기 전에 성공 형식을 파싱합니다.

상태 / 코드해결
400 · unsupported_representationX-Respond-With를 사용하십시오: 마침 또는 우두머리를 omit. json 또는 text와 같은 값은 지원되지 않습니다.
406 · not_acceptableAccept를 사용하십시오: application/json 또는 text/plain. text/markdown와 application/xml는 지원되지 않습니다.

Accept 헤더 세부 정보

Omit Accept 또는 JSON를 얻기 위하여 */*를 보내십시오. 응답은 UTF-8를 사용합니다. 미디어 범위와 q 무게가 지원됩니다. 지원되지 않은 charset는 다른 허용 범위 일치하지 않는 406를 반환합니다. Content-Type: application/json는 응답이 아닙니다 요구 몸, 설명합니다.

프리퍼 텍스트, JSON 허용
Accept: text/plain; charset=utf-8, application/json;q=0.8