Get Dataset Results V3

• 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
• 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

• result: String
  Request outcome.

  Allowed success, error
• version: String
  API version.

  Example v3
• total_data_count: Integer
  Total number of records in this dataset. This is a cached counter — records added very recently may not be reflected immediately.
• data_count: Integer
  Number of items in this response.
• min_id: Integer
  Minimum id among items in this response.
• max_id: Integer
  Maximum id among items in this response. Use it as next_id on the next request.
• empty_reason: String | null
  Why a finished dataset has no data: no_new_items (nothing new in the collection period), duplicates_only (everything found was already collected), not_found (the target could not be found). null when the dataset has data or no reason is known.
• 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: String
  Server-side processing time (seconds, as a formatted string).

  Example 0.0178s

Error Responses

• schedule_result_id missing
  Required parameter schedule_result_id was not provided.

  {
    "result": "error",
    "version": "v3",
    "message": "Required parameters(schedule_result_id) not found"
  }

• ScheduleResult not found
  No dataset matches the provided schedule_result_id, or it is not accessible.

  {
    "result": "error",
    "version": "v3",
    "message": "ScheduleResult(id: YOUR_SCHEDULE_RESULT_ID) not found"
  }

• Invalid sorting
  sorting must be asc or desc.

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `sorting` parameter: ..."
  }

• Invalid next_id
  next_id must be an integer.

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `next_id` parameter: ..."
  }

• Invalid since
  since could not be parsed as a valid timestamp.

  {
    "result": "error",
    "version": "v3",
    "message": "Invalid `since` parameter: ..."
  }

Related Guides

• Collect
• Collect Status
• Storage
• Data V2
• All Data of Bot V2
• All Data of Bot V3