shopgraph

Extract comprehensive product data from a URL including name, price, brand, images, availability, and more. Uses schema.org structured data when available, with LLM fallback. Costs $0.02 per call (cached results are free). Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Product page URL to extract data from"
    },
    "payment_method_id": {
      "type": "string",
      "description": "Stripe payment method ID for MPP payment"
    },
    "strict_confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Fields below this confidence will be nulled with explanation. Default: off."
    },
    "force_refresh": {
      "type": "boolean",
      "description": "Bypass cache entirely. Always triggers live extraction. Costs 3x credits."
    },
    "minimum_confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Auto-refresh if any cached field's DECAYED confidence falls below this threshold. Costs 2x credits when refresh triggers, 0.25x on cache hit."
    },
    "format": {
      "type": "string",
      "enum": [
        "default",
        "ucp"
      ],
      "default": "default",
      "description": "Output format. \"ucp\" returns UCP line_item format. Default: \"default\"."
    },
    "include_score": {
      "type": "boolean",
      "description": "Include agent-readiness score in response."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Extract basic product attributes from a URL (name, price, brand, availability). Faster and cheaper than enrich_product. 50 free calls/month — no payment needed. Paid: $0.01 per call after free tier. Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Product page URL to extract data from"
    },
    "payment_method_id": {
      "type": "string",
      "description": "Stripe payment method ID for MPP payment"
    },
    "strict_confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Fields below this confidence will be nulled with explanation. Default: off."
    },
    "force_refresh": {
      "type": "boolean",
      "description": "Bypass cache entirely. Always triggers live extraction. Costs 3x credits."
    },
    "minimum_confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Auto-refresh if any cached field's DECAYED confidence falls below this threshold. Costs 2x credits when refresh triggers, 0.25x on cache hit."
    },
    "format": {
      "type": "string",
      "enum": [
        "default",
        "ucp"
      ],
      "default": "default",
      "description": "Output format. \"ucp\" returns UCP line_item format. Default: \"default\"."
    },
    "include_score": {
      "type": "boolean",
      "description": "Include agent-readiness score in response."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Extract product data from raw HTML you already have (no HTTP fetch needed). Ideal when using Bright Data, Firecrawl, or any scraping API — pipe the HTML through ShopGraph for structured product data. Uses schema.org + LLM fallback. Costs $0.02 per call (cached results are free). Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "Raw HTML content of the product page"
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Original URL of the page (used for context and caching)"
    },
    "payment_method_id": {
      "type": "string",
      "description": "Stripe payment method ID for MPP payment"
    },
    "strict_confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Fields below this confidence will be nulled with explanation. Default: off."
    },
    "force_refresh": {
      "type": "boolean",
      "description": "Bypass cache entirely. Always triggers live extraction. Costs 3x credits."
    },
    "minimum_confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Auto-refresh if any cached field's DECAYED confidence falls below this threshold."
    },
    "format": {
      "type": "string",
      "enum": [
        "default",
        "ucp"
      ],
      "default": "default",
      "description": "Output format. \"ucp\" returns UCP line_item format. Default: \"default\"."
    },
    "include_score": {
      "type": "boolean",
      "description": "Include agent-readiness score in response."
    }
  },
  "required": [
    "html",
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Extract product data and return agent-readiness score (0-100). Scores structured data completeness, semantic richness, UCP compatibility, pricing clarity, and inventory signals. Full scoring breakdown included.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Product page URL to extract and score"
    },
    "payment_method_id": {
      "type": "string",
      "description": "Stripe payment method ID for MPP payment"
    },
    "strict_confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Fields below this confidence will be nulled with explanation. Default: off."
    },
    "format": {
      "type": "string",
      "enum": [
        "default",
        "ucp"
      ],
      "default": "default",
      "description": "Output format. \"ucp\" returns UCP line_item format. Default: \"default\"."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}