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

시작하기

빠른 시작

첫 Google 검색을 실행하고 앱이나 AI 에이전트에서 사용할 구조화된 결과를 받아 보세요.

AI 에이전트로 시작하기

터미널을 사용할 수 있는 에이전트에게 이 프롬프트를 전달하세요. 에이전트가 FlashData를 설정하고 검색 한 건을 실행합니다.

첫 API 호출 실행

직접 코드를 작성하려면 터미널에서 다음 세 단계를 진행하세요.

  1. API 키 받기

    계정을 만들고 이메일을 인증한 뒤 Google Search 권한이 있는 키를 생성하세요. 이미 키가 있다면 재사용하세요.

    터미널에서 실행한 뒤 입력이 숨겨지는 프롬프트에 키를 붙여 넣으세요. FLASHDATA_API_KEY가 이미 설정되어 있다면 건너뛰세요.

    키 설정
    # 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
  2. 검색 실행

    언어를 선택하고 같은 터미널에서 예제를 실행하세요. 실행할 때마다 검색 한 건이 제출됩니다.

    Python 3.10+ · 예제를 quickstart.py로 저장하세요.

    설치
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    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))
    실행
    python quickstart.py
  3. 결과 확인

    성공한 응답에는 status: done이 표시됩니다. 출처는 results[].organic에, 사용한 크레딧은 usage.credits에 있습니다.

    응답 예제(일부)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

콘솔에서 사용해 보기

  1. 계정 또는 로그인을 만듭니다. 콘솔에 표시된 모든 계정 설정 완료.
  2. Google Search를 열고, Google Search 소스와 Realtime 모드를 선택하고, 배터리 재활용 연구를 입력합니다. 추가 매개 변수를 확장하고 5에 페이지 크기 (num)를 설정합니다.
  3. 표시된 요청 및 사용 가능한 크레딧을 확인한 후 검색을 한 번 실행합니다.
  4. 응답과 사용법을 검사합니다. 반환된 소스를 열고 그 발췌보다 더 인용하기 전에 내용을 확인합니다.

첫 결과 다음 단계

첫 요청이 실패한 경우

FLASHDATA_API_KEY가 설정되지 않음
예제를 실행하는 터미널이나 런타임에서 키를 설정하세요. 이 예제는 .env 파일을 읽지 않습니다.
401 / 403
키 또는 연결이 활성 상태이고 google_search 권한이 있는지 확인하세요.
402
Billing에서 사용 가능한 크레딧을 확인하세요. 소유자 접근 권한이 필요하다면 기존 체험을 계정에 연결하세요.
429
Retry-After를 따르세요. 동일한 식별 정보와 등록 증명을 유지하고 다른 체험을 만들지 마세요.
시간 초과 또는 제출 여부 불확실
다시 시도하기 전에 기존 실행을 확인하세요. CLI에서는 같은 프로필과 실행 ID를 유지하고, SDK/API에서는 반환된 작업 ID 또는 요청 ID를 저장하세요.