List Scrapers V2

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

List the scrapers owned by the current user, paged.

50 scrapers are returned per page. Narrow the result with category and search_keyword.

search_keyword performs a partial-match search on the scraper name. Characters like % and _ are interpreted as SQL LIKE wildcards and may yield unexpected matches.

If no scraper matches the filters, an error response is returned instead of an empty success.

Request Parameters

  • api_key: String
    HashScraper API key
    Example YOUR_API_KEY
  • page: optional Integer
    Page number to retrieve.
    Default 1
  • category: optional Integer
    Filter by category ID. Integer only.
  • search_keyword: optional String
    Partial-match keyword against the scraper name.

Response Fields

  • result: String
    Request outcome.
    Allowed success, error
  • version: String
    API version.
    Example v2
  • current_page: Integer
    Current page number. Matches the page value sent in the request.
  • total_page: Integer
    Total pages after filters.
  • schedules: Array<Object>
    Array of scrapers.
    • name: String
      Scraper name.
    • point: Integer
      Credits charged per collection.
    • update_at: String | null
      Last updated date of the scraper worker (YYYY-MM-DD).
    • version: String | null
      Scraper worker version.
    • category: Integer
      Category ID. Returns 6 (Other) when unclassified.
    • schedule_id: String
      Scraper identifier. Pass it to other endpoints as schedule_id.
    • param_info: Object
      Snapshot of the parameters currently used by the scraper. Only param1~param5 that are enabled are included, and keys carry the parameter labels (e.g. param1(keyword)). When the scraper has no label configured, the label slot may be empty (param1()) or a placeholder (param1(param1)).
    • period: String
      Collection period. One of manual, hour, day.
    • union: Boolean
      Union option.
    • description: String | null
      Scraper description.
  • elapsed_time: Float
    Server-side processing time (seconds, as a numeric value).
    Example 0.0234

Error Responses

  • Invalid page
    page must be an integer.
    {
  "result": "error",
  "version": "v2",
  "message": "올바른 page 값을 넣어주세요. page: ..."
}
  • Invalid category
    category must be an integer.
    {
  "result": "error",
  "version": "v2",
  "message": "올바른 카테고리 번호를 입력해주세요. category: ..."
}
  • No schedules found
    Returned when no scraper matches the filters. The response is an error, not an empty success.
    {
  "result": "error",
  "version": "v2",
  "message": "입력하신 조건에 맞는 크롤링 봇을 찾지 못했습니다. 조건을 다시 확인해주세요."
}

Related Guides

Example Request
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
Optional parameters
Example Response 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
}