인증
보호된 엔드포인트를 인증하는 가장 간단한 방법은 Octoparse API 키입니다. Octoparse 계정 센터에서 키를 생성한 뒤x-api-key 요청 헤더에 포함하세요. 같은 API 키를 Octoparse OpenAPI, MCP 서버 및 CLI에서 사용할 수 있습니다.
API 키 생성 또는 관리
Octoparse 계정 센터에서 API 키 페이지를 엽니다.
op_sk_로 시작합니다.
POST /token에서 액세스 토큰을 받은 뒤 Authorization: Bearer <access_token> 형식으로 전송하세요.
AgentTools API
AgentTools API는 기존의 저수준 작업, 클라우드 추출 및 데이터 API 위에 구축된 템플릿 기반 AI 에이전트 워크플로 계층입니다. 에이전트나 자동화가 모든 저수준 엔드포인트를 직접 연결하지 않고 적합한 스크래핑 템플릿을 찾고, 실행을 시작하며, 서버가 제공하는 다음 단계 안내를 따르고, 내보내기 메타데이터를 가져와야 할 때 사용하세요. 새 스크래핑 흐름:data 안에 있습니다. requestId는 문제 해결에만 사용하고, 폴링 간격을 하드코딩하는 대신 retryGuidance, suggestedNextCall, workflow, toolHint를 따르세요.
AgentTools API에는
x-api-key 인증이 필요합니다. 일부 엔드포인트에는 x-external-user-id도 필요하므로 정확한 헤더는 각 엔드포인트 레퍼런스를 확인하세요.시작하기 전에
Octoparse OpenAPI를 사용하려면 실행 가능한 작업이 하나 이상 있는 스탠다드, 프로페셔널 또는 엔터프라이즈 계정이 필요합니다. 계정이 없다면 여기에서 회원가입하세요. 현재 API 버전: v1.0기본 URL
모든 요청은 기본 URL을 기준으로 URL 인코딩해야 합니다.{xxxx} 형식으로 표시되며 실제 값으로 바꿔야 합니다. 예를 들어 작업 검색 요청 URL은 다음과 같습니다.
abc라면 URL은 https://openapi.octoparse.com/task/search?taskGroupId=abc가 됩니다.
요청 한도
Octoparse는 API 사용량을 초당 20개 요청으로 제한합니다.429 상태 코드가 반환되면 요청 속도를 낮추세요.
성공한 응답은 HTTP 200을 반환합니다. 다른 상태 코드는 각 엔드포인트의 레퍼런스 섹션을 확인하세요.
권한
계정에 각 서비스를 사용할 권한이 있는지 확인하세요. 권한이 없다면 계정을 업그레이드하세요.문제 해결
모든 응답에는requestId가 포함됩니다. 요청이 실패하면 문제 진단을 위해 requestId를 Octoparse 지원팀에 전달하세요.