Get Catalog and Lasso product analytics

GET

analytics

products

summary

cURL

curl --request GET \
  --url "https://app.productlasso.com/api/v1/analytics/products/summary?from=2026-08-01&to=2026-08-31&scope=all" \
  --header "Authorization: Bearer $LASSO_API_KEY"

const params = new URLSearchParams({
  from: "2026-08-01",
  to: "2026-08-31",
  scope: "all",
});
const response = await fetch(
  `https://app.productlasso.com/api/v1/analytics/products/summary?${params}`,
  { headers: { Authorization: `Bearer ${process.env.LASSO_API_KEY}` } },
);

if (!response.ok) throw new Error(await response.text());
const summary = await response.json();

import os
import requests

response = requests.get(
    "https://app.productlasso.com/api/v1/analytics/products/summary",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    params={"from": "2026-08-01", "to": "2026-08-31", "scope": "all"},
    timeout=30,
)
response.raise_for_status()
summary = response.json()

{
  "period": {
    "from": "2023-12-25",
    "to": "2023-12-25"
  },
  "filters": {
    "catalog_status": "all",
    "user_id": "<string>",
    "schema_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source": "manual"
  },
  "catalog": {
    "summary": {
      "unique_products": 1,
      "new_products": 1,
      "updated_existing": 1,
      "total_actions": 1
    },
    "current": {
      "all_live": 1,
      "active": 1,
      "draft": 1,
      "archived": 1
    },
    "daily": [
      {
        "date": "2023-12-25",
        "unique_products": 1,
        "new_products": 1,
        "updated_existing": 1
      }
    ],
    "by_user": [
      {
        "user": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "unique_products": 1,
        "new_products": 1,
        "updated_existing": 1,
        "total_actions": 1
      }
    ]
  },
  "extraction": {
    "summary": {
      "products_prepared": 1,
      "tables": 1
    },
    "daily": [
      {
        "date": "2023-12-25",
        "products_prepared": 1
      }
    ],
    "by_user": [
      {
        "user": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "products_prepared": 1,
        "tables": 1
      }
    ],
    "by_table": [
      {
        "table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "table_name": "<string>",
        "initiator": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "products_prepared": 1
      }
    ]
  }
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Metric semantics

from and to are inclusive dates. scope defaults to all; sections outside a selected narrower scope are omitted.
Catalog unique products count live products with at least one meaningful field write in the period. Repeated edits to one product count once.
Catalog new_products and updated_existing are mutually exclusive and add up to the unique product count.
Current Catalog totals are inventory snapshots. Date and user filters do not change them; status, schema, and source filters do.
Lasso products prepared count extraction result rows created in the period and attribute them to the table initiator.

source is a Catalog-only filter and requires scope=catalog.

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.

string<date>

required

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

scope

enum<string>

default:all

Available options:

all,

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

Response

Product analytics summary. Sections outside the selected scope are omitted.

period

object

required

Show child attributes

filters

object

required

Show child attributes

catalog

object

Show child attributes

extraction

object

Show child attributes

cURL

curl --request GET \
  --url "https://app.productlasso.com/api/v1/analytics/products/summary?from=2026-08-01&to=2026-08-31&scope=all" \
  --header "Authorization: Bearer $LASSO_API_KEY"

const params = new URLSearchParams({
  from: "2026-08-01",
  to: "2026-08-31",
  scope: "all",
});
const response = await fetch(
  `https://app.productlasso.com/api/v1/analytics/products/summary?${params}`,
  { headers: { Authorization: `Bearer ${process.env.LASSO_API_KEY}` } },
);

if (!response.ok) throw new Error(await response.text());
const summary = await response.json();

import os
import requests

response = requests.get(
    "https://app.productlasso.com/api/v1/analytics/products/summary",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    params={"from": "2026-08-01", "to": "2026-08-31", "scope": "all"},
    timeout=30,
)
response.raise_for_status()
summary = response.json()

{
  "period": {
    "from": "2023-12-25",
    "to": "2023-12-25"
  },
  "filters": {
    "catalog_status": "all",
    "user_id": "<string>",
    "schema_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source": "manual"
  },
  "catalog": {
    "summary": {
      "unique_products": 1,
      "new_products": 1,
      "updated_existing": 1,
      "total_actions": 1
    },
    "current": {
      "all_live": 1,
      "active": 1,
      "draft": 1,
      "archived": 1
    },
    "daily": [
      {
        "date": "2023-12-25",
        "unique_products": 1,
        "new_products": 1,
        "updated_existing": 1
      }
    ],
    "by_user": [
      {
        "user": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "unique_products": 1,
        "new_products": 1,
        "updated_existing": 1,
        "total_actions": 1
      }
    ]
  },
  "extraction": {
    "summary": {
      "products_prepared": 1,
      "tables": 1
    },
    "daily": [
      {
        "date": "2023-12-25",
        "products_prepared": 1
      }
    ],
    "by_user": [
      {
        "user": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "products_prepared": 1,
        "tables": 1
      }
    ],
    "by_table": [
      {
        "table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "table_name": "<string>",
        "initiator": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "email": "jsmith@example.com",
          "avatar_url": "<string>",
          "avatar_kind": "upload",
          "avatar_config": {},
          "avatar_storage_path": "<string>",
          "permission_preset": "<string>",
          "is_former_member": true
        },
        "products_prepared": 1
      }
    ]
  }
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Product analytics

Catalog

Catalog Webhooks

Get Catalog and Lasso product analytics

Metric semantics

Authorizations

Query Parameters

Response

​Metric semantics

Authorizations

Query Parameters

Response

Metric semantics