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

시작하기

Python SDK 퀵스타트

Python SDK를 설치하고 몇 줄의 코드로 검색 결과를 인쇄합니다. 비동기 및 asyncio 예제를 포함합니다.

  1. SDK 설치

    Python 3.10+를 요구합니다. 프로젝트 디렉토리에서 이러한 명령을 실행합니다. 가상 환경을 사용하는 이미? 그 환경의 python -m pip 대신에 flashdata==1.1.0를 설치하십시오.

    설치
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. 인증현황

    Google Search 권한으로 API 키 생성, 또는 승인된 키를 재사용합니다. 아래 숨겨진 프롬프트를 사용하여이 터미널에서 설정하십시오.

    FLASHDATA_API_KEY가 이미 설정된 경우 프롬프트를 건너 뛸 수 있습니다. 이 예제는 변수를 직접 읽습니다. 그들은 .env 파일을로드하지 않습니다.

    숨겨진 키 프롬프트 · Bash
    # 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
  3. 검색 실행

    quickstart.py로 이것을 저장하고, 그런 가상 환경으로 실행하십시오. 그것은 최대 5개의 결과 및 인쇄 제목, URLs 및 사용 신용을 위한 1개의 Google Search 요구에 응합니다.

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    실행
    .venv/bin/python quickstart.py
  4. 결과 확인

    상태 확인 후 일반적으로 스크립트 종료가 완료됩니다. 예상 소스 제목과 URLs 다음 크레딧 사용. 빈 유기 목록은 유효한 응답입니다; 결과는 당신의 질문과 변화합니다.

    예 출력
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search 조회: 제목, 링크 및 스니펫. 다른 소스에는 다른 결과 필드가 있습니다.
    usage.credits
    이 요청의 비용. 최대 5개의 결과가 하나의 검색 요청입니다.

다른 데이터 소스를 시도

각 탭은 완전한 스크립트입니다. quickstart.py를 하나의 예로 바꾸고 단계 3에서 명령으로 실행하십시오. 각 실행은 하나의 새로운 요청을 제출합니다. 키는 소스 권한이 표시됩니다.

google_news를 요구합니다. results[].news[]에서 기사 제목 및 소스 링크 인쇄.

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

Python SDK 지원

google / youtube
Google Search, 뉴스, 이미지, 쇼핑, 비디오 및 장소; YouTube discovery, 메타데이터, 캡션, 성적표 및 채널 데이터.
youtube.download
오디오 또는 비디오 배달 작업을 클라우드 스토리지에 제출하십시오. youtube_download 권한 및 저장 구성이 필요합니다. 아래의 전체 다운로드 예제를 따르십시오.
jobs / bulk
받아 들여지는 일을 저장 ID, 완료 및 검색 결과 기다립니다. 더 큰 비디오-ID 데이터 세트에 대 한 대량 사용 하 고 재시작 후 기존 작업을 재시작 합니다.
account
복구 작업 전에 액세스, 균형, 가격, 제한 및 사용 읽으십시오. 당신의 환경 또는 비밀 상점에서 허가한 열쇠를 재사용하십시오.
respond_with / accept
respond_with="markdown"를 Markdown에 대응["content"], 혹은 accept="text/plain"를 문자열로 사용합니다. JSON 사전은 기본값입니다.

asyncio 사용

이 버전으로 quickstart.py를 대체하고 동일한 실행 명령을 사용합니다. AsyncFlashData는 같은 리소스를 기다립니다. 실시간 검색 응답을 위해 여전히 대기; mode="async" 대신 서버 측 배경 작업을 제출합니다.

Jupyter 또는 실행 이벤트 루프가있는 응용 프로그램에서 asyncio.run (main) 대신 메인 ()을 사용하십시오. 해당 이벤트 루프 내에서 클라이언트를 재사용합니다.

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

다음 단계

단계가 실패한 경우

ModuleNotFoundError
동일한 해석기로 설치하고 실행하십시오: .venv/bin/python -m pip 쇼 flashdata (Windows: .\.venv\Scripts\python.exe -m pip 쇼 flashdata). 스크립트 flashdata.py 이름을 지정하지 마십시오.
KeyError: FLASHDATA_API_KEY / 401
동일한 맨끝에 있는 활동적인 API 열쇠를 놓으십시오. .env 파일은 혼자이 예제에 의해로드되지 않습니다. API 키는 MCP OAuth 토큰이 아닙니다.
403
이 키의 예에 의해 필요한 소스 권한을 부여합니다.
402
Billing를 확인하여 사용 가능한 크레딧을 확인하세요. 시험 접근이 소진되면 계정 잔액을 사용하는 연결이 청구됩니다.
429 / APIError
error.retry_after를 검사하고 요구 비율을 감소시키십시오. SDK는 각 요청을 한 번 보내고 자동으로 재발하지 않습니다.
SubmissionUnknownError
제출은 이미 접수 될 수 있습니다. History를 반복하기 전에 확인하십시오. 사용 가능한 경우 ID를 저장하십시오.
asyncio.run() / running event loop
사용은 노트북이나 기존의 이벤트 루프에서 메인()를 기다립니다. 독립 스크립트를 위해 asyncio.run(main())를 유지하십시오.