read

Returns cost data and margin analysis for products. Confidence tier A = verified Shopify COGS, B = reverse-image AliExpr

Returns cost data and margin analysis for products. Confidence tier A = verified Shopify COGS, B = reverse-image AliExpress estimate, C = unknown. Use when the user asks about margins, costs, profitability, or which products have unverified costs.

post/api/v1/tools/get_product_costs

Request

  • Base URL: https://app.magistry.io
  • URL: https://app.magistry.io/api/v1/tools/get_product_costs
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.magistry.io/api/oauth/authorize, token URL https://app.magistry.io/api/oauth/token, scopes: costs:read)

Request body

product_idsstring[]

Optional list of product UUIDs to filter to (max 50). Omit to return latest costs across the store.

confidence_tier'A' | 'B' | 'C'

Optional: filter to a specific cost confidence tier.

Response

Tool result

okboolean required
resultunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.