스크래퍼 목록 조회 V2

POST api.hashscraper.com/api/get_schedules Content-Type: application/json; version=2

사용자가 보유한 스크래퍼 목록을 페이지 단위로 조회합니다.

한 페이지당 50개를 반환합니다. category·search_keyword로 결과를 좁힐 수 있습니다.

search_keyword는 스크래퍼 이름에 대한 부분 일치 검색입니다. 값에 %·_가 포함되면 SQL LIKE의 와일드카드로 해석되어 의도치 않은 결과가 나올 수 있습니다.

조건에 맞는 스크래퍼가 한 건도 없으면 성공 응답이 아닌 에러 응답을 반환합니다.

요청 파라미터

  • api_key: String
    해시스크래퍼 API 키API키 확인하기
    예시 YOUR_API_KEY
  • page: optional Integer
    조회할 페이지 번호.
    기본값 1
  • category: optional Integer
    카테고리 ID로 결과를 필터링합니다. 정수만 허용됩니다.
  • search_keyword: optional String
    스크래퍼 이름에 대한 부분 일치 키워드.

응답 필드

  • result: String
    요청 처리 결과.
    허용값 success, error
  • version: String
    API 버전.
    예시 v2
  • current_page: Integer
    현재 페이지 번호. 요청 시 전달한 page 값과 동일합니다.
  • total_page: Integer
    필터 적용 후 결과를 기준으로 한 전체 페이지 수.
  • schedules: Array<Object>
    스크래퍼 배열.
    • name: String
      스크래퍼 이름.
    • point: Integer
      1회 수집에 차감되는 크레딧.
    • update_at: String | null
      스크래퍼 워커의 마지막 업데이트 날짜 (YYYY-MM-DD).
    • version: String | null
      스크래퍼 워커 버전.
    • category: Integer
      카테고리 ID. 분류되지 않은 경우 6(기타)으로 반환됩니다.
    • schedule_id: String
      스크래퍼의 식별자. 다른 API 호출 시 schedule_id로 전달합니다.
    • param_info: Object
      스크래퍼의 사용 중인 파라미터 스냅샷. param1~param5 중 사용으로 지정된 것만 포함되며, 키 이름에 라벨이 함께 표기됩니다 (예: param1(검색어)). 스크래퍼에 라벨이 설정되지 않았으면 param1() 또는 param1(param1)처럼 라벨 자리가 비거나 placeholder로 남을 수 있습니다.
    • period: String
      수집 주기. manual, hour, day 중 하나.
    • union: Boolean
      유니온 옵션.
    • description: String | null
      스크래퍼 설명.
  • elapsed_time: Float
    응답 생성에 걸린 시간(초 단위 숫자).
    예시 0.0234

에러 응답

  • Invalid page
    page 값이 정수 형식이 아닙니다.
    {
      "result": "error",
      "version": "v2",
      "message": "올바른 page 값을 넣어주세요. page: ..."
    }
  • Invalid category
    category 값이 정수 형식이 아닙니다.
    {
      "result": "error",
      "version": "v2",
      "message": "올바른 카테고리 번호를 입력해주세요. category: ..."
    }
  • No schedules found
    조건에 맞는 스크래퍼를 찾지 못한 경우 반환됩니다. 빈 결과가 아닌 에러 응답으로 옵니다.
    {
      "result": "error",
      "version": "v2",
      "message": "입력하신 조건에 맞는 크롤링 봇을 찾지 못했습니다. 조건을 다시 확인해주세요."
    }

관련 가이드

요청 예시
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
옵션 파라미터
응답 예시 200
{
  "result": "success",
  "version": "v2",
  "current_page": 1,
  "total_page": 2,
  "schedules": [
    {
      "name": "사람인 채용공고 수집",
      "point": 5,
      "update_at": "2026-04-15",
      "version": "1.2.0",
      "category": 1,
      "schedule_id": "사람인_채용공고_수집_1697441449957",
      "param_info": {
        "param1(검색할 키워드)": "개발자",
        "param2(최대 수집 개수)": "10"
      },
      "period": "manual",
      "union": false,
      "description": "사람인 채용공고 검색 결과를 수집합니다."
    },
    {
      "name": "네이버 뉴스 수집",
      "point": 3,
      "update_at": "2026-04-10",
      "version": "2.0.1",
      "category": 2,
      "schedule_id": "네이버_뉴스_수집_1687856320079",
      "param_info": {
        "param1(검색할 키워드)": "AI"
      },
      "period": "hour",
      "union": false,
      "description": "네이버 뉴스 검색 결과를 수집합니다."
    }
  ],
  "elapsed_time": 0.0234
}