get/api/v2/shopping/items

List shopping result items.

List shopping result items.

Requires bearer API key

Parameters

X-Project-Id

header

Required for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.

Schema: string

page

query

No description provided.

Schema: integer

size

query

No description provided.

Schema: integer

startDate

query

No description provided.

Schema: string:date-time

endDate

query

No description provided.

Schema: string:date-time

range

query

Shortcut for the last 7 or 90 days. Date filters take precedence when present.

Schema: string (7, 90)

q

query

Product-name search. Alias: productSearch.

Schema: string

productSearch

query

Alias for q product-name search.

Schema: string

merchant

query

Single merchant-domain filter used by the workspace UI.

Schema: string

merchantDomains

query

Comma-separated merchant domains are accepted.

Schema: string

response

query

Filter to product cards extracted from one persisted response. Alias: responseId.

Schema: string

responseId

query

Alias for response.

Schema: string

monitorIds

query

Comma-separated values are accepted.

Schema: string

modelIds

query

Comma-separated values are accepted.

Schema: string

Responses

200

Successful JSON response.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "productName": {
            "type": "string"
          },
          "price": {
            "type": "string",
            "nullable": true
          },
          "merchantDomain": {
            "type": "string",
            "nullable": true
          },
          "rating": {
            "type": "number",
            "nullable": true
          },
          "reviewsCount": {
            "type": "integer",
            "nullable": true
          },
          "position": {
            "type": "integer",
            "nullable": true
          },
          "observedAt": {
            "type": "string",
            "format": "date-time"
          },
          "sourceModel": {
            "type": "string",
            "nullable": true
          },
          "sourceLabel": {
            "type": "string"
          },
          "sourceTone": {
            "type": "string"
          },
          "providerRunId": {
            "type": "string",
            "nullable": true
          },
          "executionModel": {
            "type": "string",
            "nullable": true
          },
          "prompt": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "productName",
          "price",
          "merchantDomain",
          "rating",
          "reviewsCount",
          "position",
          "observedAt",
          "sourceModel",
          "sourceLabel",
          "sourceTone",
          "providerRunId",
          "executionModel",
          "prompt"
        ]
      }
    },
    "total": {
      "type": "integer"
    },
    "page": {
      "type": "integer"
    },
    "size": {
      "type": "integer"
    },
    "totalPages": {
      "type": "integer"
    }
  },
  "required": [
    "items",
    "total",
    "page",
    "size",
    "totalPages"
  ]
}

Try it

Send this request to the local WatchLLM REST handler. Use a key from `/workspace/api`; organization keys can include `X-Project-Id` only when the endpoint documents that header.