스크래퍼 목록 조회 V2
사용자가 보유한 스크래퍼 목록을 페이지 단위로 조회합니다.
한 페이지당 50개를 반환합니다. category·search_keyword로 결과를 좁힐 수 있습니다.
search_keyword는 스크래퍼 이름에 대한 부분 일치 검색입니다. 값에 %·_가 포함되면 SQL LIKE의 와일드카드로 해석되어 의도치 않은 결과가 나올 수 있습니다.
조건에 맞는 스크래퍼가 한 건도 없으면 성공 응답이 아닌 에러 응답을 반환합니다.
요청 파라미터
-
api_key: String해시스크래퍼 API 키API키 확인하기
-
page: optional Integer조회할 페이지 번호.
-
category: optional Integer카테고리 ID로 결과를 필터링합니다. 정수만 허용됩니다.
-
search_keyword: optional String스크래퍼 이름에 대한 부분 일치 키워드.
응답 필드
-
result: String요청 처리 결과.
-
version: StringAPI 버전.
-
current_page: Integer현재 페이지 번호. 요청 시 전달한
page값과 동일합니다. -
total_page: Integer필터 적용 후 결과를 기준으로 한 전체 페이지 수.
-
schedules: Array<Object>스크래퍼 배열.
-
name: String스크래퍼 이름.
-
point: Integer1회 수집에 차감되는 크레딧.
-
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응답 생성에 걸린 시간(초 단위 숫자).
에러 응답
-
Invalid page
{ "result": "error", "version": "v2", "message": "올바른 page 값을 넣어주세요. page: ..." } -
Invalid category
{ "result": "error", "version": "v2", "message": "올바른 카테고리 번호를 입력해주세요. category: ..." } -
No schedules found
{ "result": "error", "version": "v2", "message": "입력하신 조건에 맞는 크롤링 봇을 찾지 못했습니다. 조건을 다시 확인해주세요." }
관련 가이드
요청 예시
옵션 파라미터
응답 예시 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
}