크롤링 봇 목록 조회 V4

• Authorization: Header
  해시스크래퍼 API 키. Bearer <api_key> 형식으로 전달합니다.

  예시 Bearer YOUR_API_KEY
• cursor: optional Integer
  응답의 next_cursor 값을 그대로 다음 요청에 전달.
• limit: optional Integer
  한 페이지당 최대 크롤링 봇 수.

  기본값 100 허용값 1 ~ 1000

• result: String
  요청 처리 결과.

  허용값 success, error
• version: String
  API 버전.

  예시 v4
• request_id: String
  요청 추적용 ID.

  예시 req_5a8c1f1c-...
• elapsed_sec: Float
  응답 생성에 걸린 시간(초 단위 Float).

  예시 0.0234
• count: Integer
  이 응답에 포함된 크롤링 봇 수.
• next_cursor: Integer | null
  다음 페이지 조회 시 cursor로 전달할 값. null이면 마지막 페이지입니다.
• data: Array<Object>
  크롤링 봇 배열.

  • id: String
    크롤링 봇의 ID. 다른 V4 엔드포인트에서 schedule_id로 사용합니다.
  • name: String
    크롤링 봇 이름.
  • description: String | null
    크롤링 봇 설명. raw HTML이 포함될 수 있으므로(예: <br>·줄바꿈) 표시 시 escape하거나 적절히 처리하세요.
  • schedule_group: Object | null
    크롤링 봇이 속한 그룹 정보. 그룹이 없는 크롤링 봇은 null.

    • id: Integer
      그룹 ID.
    • name: String
      그룹 이름.
    • name_en: String
      그룹 이름(영문). 설정되지 않은 경우 키 자체가 생략됩니다.
  • period: String | null
    수집 주기. manual(수동), hour(시간 단위), day(일 단위) 중 하나이며, 설정되지 않은 경우 null일 수 있습니다.

    허용값 manual, hour, day
  • union: Boolean
    union 모드 여부. union 모드는 새 데이터셋을 만들지 않고 같은 크롤링 봇의 마지막 데이터셋을 재사용해 결과를 모으는 모드입니다.
  • created_at: String (ISO 8601)
    크롤링 봇 생성 시각 (ISO 8601, Asia/Seoul).
  • updated_at: String (ISO 8601)
    크롤링 봇 마지막 갱신 시각 (ISO 8601, Asia/Seoul).
  • worker_source: Object | null
    이 크롤링 봇이 사용하는 워커 정보. 워커가 연결되지 않은 경우 null.

    • name: String
      워커 이름.
    • version: Integer
      워커 버전.
    • updated_at: String (ISO 8601)
      워커 마지막 갱신 시각 (ISO 8601, Asia/Seoul).
    • price: Float
      이 워커로 수집 1건당 차감되는 크레딧.
  • param_info: Object
    크롤링 봇의 입력 파라미터 정보. 키는 param1~paramN으로 안정적이며, 사용으로 지정된 항목만 포함됩니다.

    • name: String
      파라미터 라벨(한국어).
    • name_en: String
      파라미터 라벨(영문). 설정되지 않은 경우 키 자체가 생략됩니다.
    • alias: String
      이 파라미터에 설정된 영문 별칭. 요청 시 paramN 대신 이 키로 보낼 수 있습니다. (미설정 시 생략)
    • value: String | null
      현재 크롤링 봇에 저장된 값. 미설정이면 null.
    • options: Array<Object>
      이 파라미터에 허용된 값 목록. 자유 입력 파라미터는 키 자체가 생략됩니다. 각 항목은 name(한글)·name_en(영문)·value(collect 호출 시 보낼 실제 값)로 구성됩니다.

에러 응답

• MISSING_API_KEY
  Authorization 헤더가 없거나 형식이 올바르지 않습니다. Authorization: Bearer <api_key> 형태로 전달하세요. (HTTP 401)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "MISSING_API_KEY",
    "message": "API key is missing.",
    "elapsed_sec": 0.0008,
    "details": { "hint": "Send `Authorization: Bearer <api_key>` header." }
  }

• INVALID_API_KEY
  전달된 API 키와 일치하는 사용자가 없습니다. (HTTP 401)

  {
    "result": "error",
    "version": "v4",
    "request_id": "req_5a8c1f1c-...",
    "code": "INVALID_API_KEY",
    "message": "API key is invalid.",
    "elapsed_sec": 0.0011
  }

관련 가이드

• 수집 V4
• 봇 데이터 전체 V4