Schema.org · JSON Structure

Schema Org Offer

An offer to transfer some rights to an item or to provide a service.

Type: object Properties: 30

Schema.orgStructured DataLinked DataJSON-LDVocabularySEOWeb StandardsRDFOntology

Offer is a JSON Structure definition published by Schema.org, describing 30 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

type context name description url price priceCurrency priceValidUntil availability availabilityStarts availabilityEnds itemCondition seller offeredBy itemOffered sku gtin mpn validFrom validThrough eligibleRegion eligibleQuantity shippingDetails hasMerchantReturnPolicy review aggregateRating lowPrice highPrice offerCount sameAs

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "type": "object",
  "name": "Offer",
  "description": "An offer to transfer some rights to an item or to provide a service.",
  "properties": {
    "type": { "type": "string" },
    "context": { "type": "string" },
    "name": { "type": "string" },
    "description": { "type": "string" },
    "url": { "type": "string" },
    "price": { "type": "decimal", "precision": 10, "scale": 2 },
    "priceCurrency": { "type": "string" },
    "priceValidUntil": { "type": "date" },
    "availability": { "type": "string" },
    "availabilityStarts": { "type": "datetime" },
    "availabilityEnds": { "type": "datetime" },
    "itemCondition": { "type": "string" },
    "seller": { "type": { "$ref": "schema-org-organization.json" } },
    "offeredBy": { "type": { "$ref": "schema-org-organization.json" } },
    "itemOffered": { "type": "string" },
    "sku": { "type": "string" },
    "gtin": { "type": "string" },
    "mpn": { "type": "string" },
    "validFrom": { "type": "datetime" },
    "validThrough": { "type": "datetime" },
    "eligibleRegion": { "type": "string" },
    "eligibleQuantity": { "type": { "$ref": "schema-org-quantitative-value.json" } },
    "shippingDetails": { "type": { "$ref": "#/definitions/OfferShippingDetails" } },
    "hasMerchantReturnPolicy": { "type": { "$ref": "#/definitions/MerchantReturnPolicy" } },
    "review": { "type": "array", "items": { "type": { "$ref": "schema-org-review.json" } } },
    "aggregateRating": { "type": { "$ref": "schema-org-aggregate-rating.json" } },
    "lowPrice": { "type": "decimal", "precision": 10, "scale": 2 },
    "highPrice": { "type": "decimal", "precision": 10, "scale": 2 },
    "offerCount": { "type": "int32" },
    "sameAs": { "type": "array", "items": { "type": "string" } }
  },
  "definitions": {
    "OfferShippingDetails": {
      "type": "object",
      "name": "OfferShippingDetails",
      "properties": {
        "type": { "type": "string" },
        "shippingRate": { "type": { "$ref": "#/definitions/MonetaryAmount" } },
        "shippingDestination": { "type": { "$ref": "#/definitions/DefinedRegion" } }
      }
    },
    "MonetaryAmount": {
      "type": "object",
      "name": "MonetaryAmount",
      "properties": {
        "type": { "type": "string" },
        "value": { "type": "decimal", "precision": 10, "scale": 2 },
        "currency": { "type": "string" }
      }
    },
    "DefinedRegion": {
      "type": "object",
      "name": "DefinedRegion",
      "properties": {
        "type": { "type": "string" },
        "addressCountry": { "type": "string" }
      }
    },
    "MerchantReturnPolicy": {
      "type": "object",
      "name": "MerchantReturnPolicy",
      "properties": {
        "type": { "type": "string" },
        "applicableCountry": { "type": "string" },
        "returnPolicyCategory": { "type": "string" },
        "merchantReturnDays": { "type": "int32" },
        "returnMethod": { "type": "string" },
        "returnFees": { "type": "string" }
      }
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this

find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This JSON Structure

curl "https://apis.io/api/v1/json-structures/schema-org-offer"

All json structure

curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.