Skip to main content
GET
List the exact products or result rows behind a metric

Usage notes

Use this endpoint to drill from an aggregate metric into the exact Catalog products or Lasso result rows behind it. Keep the same date range, scope, and filters that you used for the summary or leaderboard. The response uses cursor pagination. Pass next_cursor unchanged to the next request. Do not interpret or construct cursors yourself.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from
string<date>
required

Inclusive reporting-period start.

to
string<date>
required

Inclusive reporting-period end. The range may contain at most 1,830 days.

scope
enum<string>
required
Available options:
catalog,
extraction
catalog_status
enum<string>
default:all

Current Catalog status to include. all means active and draft products.

Available options:
all,
active,
draft,
archived
user_id
string

Current or former user UUID, or system for unattributed automation.

schema_id
string<uuid>

Filters both Catalog products and Lasso extraction tables by schema.

table_id
string<uuid>

Filters Lasso analytics to one extraction table.

source
enum<string>

Catalog-only source filter. Requires scope=catalog.

Available options:
manual,
product_extraction,
shopify
cursor
string

Opaque next_cursor returned by the previous page.

limit
integer
default:25
Required range: 1 <= x <= 100

Response

Keyset-paginated Catalog products or Lasso result rows.

scope
enum<string>
required
Available options:
catalog,
extraction
items
object[]
required
next_cursor
string | null
required

Opaque cursor for the next page, or null when no more rows remain.