Api Endpoint

Forest Commerce

Normalize a public product URL into current title, selected variant, price, currency, availability and buyability. Uses bounded read-only provider responses or JSON-LD; it never buys, logs in or guarantees unpublished stock. Base mainnet USDC

Open interactive test console

Offering

Provider
http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Business And Commerce
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/commerce/product-state
MIME type
Not provided
First seen
2026-10-16T01:50:45.949Z
Last seen
Tags
commerce, product

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.003 USDC
Atomic price: 3000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "payTo": "0xb48D918151311F982d542eF5C84cc1cd54CFf7a9"
  }
]

Observed health

Status
Reachable
Latest latency
265 ms
Average latency
493 ms
HTTP status
405
Last checked
Reachability
100% over 11 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "url": {
          "description": "Public HTTP(S) URL to inspect, resolve, or compare.",
          "maxLength": 2048,
          "pattern": "^https?://",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "url": {
              "description": "Public HTTP(S) URL to inspect, resolve, or compare.",
              "maxLength": 2048,
              "pattern": "^https?://",
              "type": "string"
            }
          },
          "required": [
            "url"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": false,
          "properties": {
            "capability": {
              "const": "commerce.product-state",
              "description": "Public capability value used to scope this lookup."
            },
            "data": {
              "additionalProperties": false,
              "description": "Public data value used to scope this lookup.",
              "properties": {
                "availability": {
                  "description": "Public availability value used to scope this lookup.",
                  "enum": [
                    "in_stock",
                    "out_of_stock",
                    "preorder",
                    "backorder",
                    "limited",
                    "discontinued",
                    "unknown",
                    null
                  ]
                },
                "brand": {
                  "description": "Public brand value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "buyable": {
                  "description": "Public buyable value used to scope this lookup.",
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "canonical_url": {
                  "description": "Public canonical url value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "compare_at_price": {
                  "description": "Public compare at price value used to scope this lookup.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "currency": {
                  "description": "Public currency value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "evidence": {
                  "description": "Public evidence value used to scope this lookup.",
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "identifiers": {
                  "additionalProperties": true,
                  "description": "Public identifiers value used to scope this lookup.",
                  "type": "object"
                },
                "platform": {
                  "description": "Public platform value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "price": {
                  "description": "Public price value used to scope this lookup.",
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "product_id": {
                  "description": "Public product id value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "purchase_route": {
                  "description": "Public purchase route value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "selected_variant": {
                  "anyOf": [
                    {
                      "additionalProperties": true,
                      "description": "Public identifiers value used to scope this lookup.",
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Public selected variant value used to scope this lookup."
                },
                "seller": {
                  "anyOf": [
                    {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    {
                      "additionalProperties": true,
                      "description": "Public identifiers value used to scope this lookup.",
                      "type": "object"
                    }
                  ],
                  "description": "Public seller value used to scope this lookup."
                },
                "title": {
                  "description": "Public title value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "platform",
                "canonical_url",
                "product_id",
                "title",
                "brand",
                "selected_variant",
                "price",
                "compare_at_price",
                "currency",
                "availability",
                "buyable",
                "seller",
                "identifiers",
                "purchase_route",
                "evidence"
              ],
              "type": "object"
            },
            "meta": {
              "additionalProperties": false,
              "description": "Public meta value used to scope this lookup.",
              "properties": {
                "cache": {
                  "description": "Public cache value used to scope this lookup.",
                  "enum": [
                    "hit",
                    "miss",
                    "bypass"
                  ]
                },
                "checked_at": {
                  "description": "Public checked at value used to scope this lookup.",
                  "type": "string"
                },
                "duration_ms": {
                  "description": "Public duration ms value used to scope this lookup.",
                  "minimum": 0,
                  "type": "integer"
                },
                "provider": {
                  "description": "Public provider value used to scope this lookup.",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "provider",
                "checked_at",
                "cache",
                "duration_ms"
              ],
              "type": "object"
            },
            "ok": {
              "const": true,
              "description": "Public ok value used to scope this lookup."
            },
            "version": {
              "const": "1",
              "description": "Package version whose public metadata should be checked."
            }
          },
          "required": [
            "ok",
            "capability",
            "version",
            "data",
            "meta"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}