---
title: "Get outputs for a scraping group"
method: GET
path: "/v1/outputs/{group_id}"
tags: ["Public"]
---

# Get outputs for a scraping group

`GET /v1/outputs/{group_id}`

Allows you to fetch all outputs for a given scraping group. The results are a
materialized view of the outputs for the group; meaning the results are
deduplicated. This view is updated depending on how often the group is scheduled
to be re-scraped.

The results are paginated and sorted by the `create_date` of items in ascending order.
You can fetch the next page by using the `next_url` or `next_cursor` fields in the
response metadata.

Typically, you'd also want to provide a `created_after` filter to only fetch outputs
created after a certain date. This is useful when you want to fetch new outputs
since the last time you fetched outputs; thus allowing you to maintain a "real-time"
view of the outputs.

## Path parameters

- `group_id` string, required — ID of the scraping group you want to fetch outputs for. This can be found on the groups page in the individual group card.

## Query parameters

- `job_id` string, nullable — ID of the root scraping job to filter outputs by. Useful when you need to fetch results from a specific domain or data source within a group. When omitted, outputs from all jobs in the group will be returned.
- `created_after` string, date-time, nullable — Filter outputs to only include those created or updated on or after this timestamp. Accepts ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ). Essential for incremental data syncing to avoid fetching the entire dataset on each request.
- `url` string, nullable — Complete URL to fetch outputs for, including protocol and path. Must match exactly the URL that was processed by the scraper.
- `limit` integer — Number of results to return per page
- `cursor` integer — Cursor to paginate through results
- `country` string, nullable — Name of the country to filter by (eg: United States)
- `region` string, nullable — ISO 3166-2 code of the region to filter by (eg: US-CA)

## Response `200`

Successful Response

- PaginatedOutput
  - `metadata` PaginatedMetadata, required
    - `next_url` string, nullable, required — URL to the next page. Null if no next page.
    - `next_cursor` integer, nullable, required — Cursor to the next page. Null if no next page.
  - `items` Output[], required
    - `source_url` string, required
    - `data` object, required — The extracted data normalized to the schema of the scraping group
    - `id` integer, required
    - `output_id` string, required
    - `root_job_id` string, required — The ID of the root job that this output was created from
    - `create_date` string, required — The date when this output was first created in the system
    - `update_date` string, required — The date when the output data was last modified
    - `last_scraped_date` string, required — The date when this output was most recently scraped, even if no changes were detected
    - `change_type` 'CREATE' | 'UPDATE' | 'DELETE' | 'NOOP', required — Denotes which type of change was made to a resource. If an output row has never been seen before, it is considered a `CREATE`. If an output row has been seen before, but has changed, it is considered an `UPDATE`. If an output row has been seen before, but is no longer present, it is considered a `DELETE`. If an output row has been seen before, and has not changed, it is considered a `NOOP`.
    - `key_hash` string, required
    - `value_hash` string, required
    - `is_approved` boolean, required — A boolean describing whether or not the job this output was created from has been marked as `APPROVED`
    - `tags` object, required — Custom user-defined metadata associated with the source job the output was produced from. Country and region information is automatically added to the tags.
    - `files` Download[], required — The files that were extracted by the scraper
      - `id` string, required
      - `field` string, required
      - `url_etag_hash` string, required
      - `s3_key` string, required
      - `s3_url` string, required — A pre-signed URL to download the file
      - `source_url` string, nullable, required
      - `create_date` string, required
      - `file_url` string, nullable, required
      - `file_type` string, nullable, required
      - `file_checksum` string, required
      - `file_metadata` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reworkd/apis/reworkd-scraping-api.md) · [All operations](https://skmtc.dev/reworkd/apis/reworkd-scraping-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reworkd/reworkd-scraping-api/revisions/153f788d97fc/schema)