Get Dataset Results V2

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

Retrieve records from a specific dataset, paged.

Up to 100 records are returned per request. Choose between page-based pagination via page, or cursor-based by passing the response's max_id as next_id on the next call.

Calling the same cursor again past the last page returns an empty response with data_count: 0.

The returned columns vary per scraper and are determined by that scraper's result-column configuration.

Use since to retrieve only records created on or after a given time. All timestamps are in Korea Standard Time (Asia/Seoul).

next_id is applied as id > next_id regardless of sort direction. It is designed to be used with sorting=asc; combining it with sorting=desc returns ids greater than next_id sorted in descending order, which does not behave as standard pagination.

When next_id or since is applied, total_page and data_count reflect the filtered subset, not the entire dataset.

Request Parameters

  • api_key: String
    HashScraper API key
    Example YOUR_API_KEY
  • schedule_result_id: Integer
    ID of the dataset to read. Pass the value returned by collect as-is.
    Example YOUR_SCHEDULE_RESULT_ID
  • page: optional Integer
    Page number to retrieve. Do not combine with cursor pagination (next_id). When both are provided, the cursor filter is applied first and page is applied on top, which may yield unexpected results.
    Default 1
  • sorting: optional String
    Sort direction by id.
    Default asc Allowed asc, desc
  • next_id: optional Integer
    Pass the max_id value from the previous response as-is.
  • since: optional String
    Retrieve records created on or after the given time (inclusive). %Y-%m-%d %H:%M:%S format, Korea Standard Time.
    Example 2026-04-27 00:00:00

Response Fields

  • result: String
    Request outcome.
    Allowed success, error
  • version: String
    API version.
    Example v2
  • data_count: Integer
    Number of items in this page.
  • current_page: Integer
    Current page number. Matches the page value sent in the request.
  • total_page: Integer
    Total number of pages. When next_id or since is applied, this reflects the filtered subset, not the entire dataset.
  • min_id: Integer
    Minimum id among items in this page.
  • max_id: Integer
    Maximum id among items in this page. Use it as next_id on the next request.
  • data: Array<Object>
    Array of result records.
    • id: Integer
      Unique record identifier.
    • created_at: String (ISO 8601)
      Collection timestamp (ISO 8601, Asia/Seoul).
    • updated_at: String (ISO 8601)
      Last update timestamp (ISO 8601, Asia/Seoul). Scraped records are typically not modified, so this usually matches created_at.
    • <dynamic fields>: Any
      Dynamic fields. The set of keys depends on the scraper's result-column configuration.
  • elapsed_time: Float
    Server-side processing time (seconds, as a numeric value).
    Example 0.0234

Error Responses

  • schedule_result_id missing
    Required parameter schedule_result_id was not provided.
    {
      "result": "error",
      "version": "v2",
      "message": "`schedule_result_id` parameter is required"
    }
  • Schedule result not found
    No dataset matches the provided schedule_result_id, or it is not accessible.
    {
      "result": "error",
      "version": "v2",
      "message": "schedule_result(id: YOUR_SCHEDULE_RESULT_ID) not found"
    }
  • Invalid page
    page must be an integer.
    {
      "result": "error",
      "version": "v2",
      "message": "올바른 page 값을 넣어주세요. page: ..."
    }
  • Invalid sorting
    sorting must be asc or desc.
    {
      "result": "error",
      "version": "v2",
      "message": "올바른 sorting 값을 입력해주세요.(asc, desc) sorting: ..."
    }
  • Invalid next_id
    next_id must be an integer.
    {
      "result": "error",
      "version": "v2",
      "message": "정수 타입의 next_id 값을 입력해주세요. next_id: ..."
    }
  • Invalid since
    since could not be parsed as a valid timestamp.
    {
      "result": "error",
      "version": "v2",
      "message": "since 형식이 잘못되었습니다. since: ..."
    }

Related Guides

Example Request
  • cURL
  • Ruby
  • Python
  • NodeJS
  • PHP
  • Java
Optional parameters
Example Response 200
{
  "result": "success",
  "version": "v2",
  "data_count": 3,
  "current_page": 1,
  "total_page": 1,
  "min_id": 26283699,
  "max_id": 26284152,
  "data": [
    {
      "id": 26283699,
      "created_at": "2026-04-27T16:20:19.000+09:00",
      "updated_at": "2026-04-27T16:20:19.000+09:00",
      "제목": "함께할 개발자 모집 (C#)",
      "회사명": "에딤스 주식회사",
      "회사 주소": "부산 사상구",
      "경력": "신입·경력",
      "학력": "초대졸↑",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    },
    {
      "id": 26283700,
      "created_at": "2026-04-27T16:20:19.000+09:00",
      "updated_at": "2026-04-27T16:20:19.000+09:00",
      "제목": "백엔드 개발자",
      "회사명": "(주)텍스트웨이",
      "회사 주소": "서울전체",
      "경력": "경력 3~7년",
      "학력": "학력무관",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    },
    {
      "id": 26284152,
      "created_at": "2026-04-27T16:52:49.000+09:00",
      "updated_at": "2026-04-27T16:52:49.000+09:00",
      "제목": "함께할 개발자 모집 (C#)",
      "회사명": "에딤스 주식회사",
      "회사 주소": "부산 사상구",
      "경력": "신입·경력",
      "학력": "초대졸↑",
      "정규직/비정규직": "정규직",
      "연봉": null,
      "URL": "https://www.saramin.co.kr/..."
    }
  ],
  "elapsed_time": 0.0234
}