Product Schema Auto-Rich

Turns raw e-commerce data into Google-ready JSON-LD Schema.org Product markup. Boost your SEO with structured data that search engines love.

POST /api/product-schema
Data Processing
~85ms latency
API Key auth
Free tier: 1,000/mo

Value Proposition

Automatically generate valid Schema.org Product JSON-LD markup from your raw e-commerce data. The API handles fuzzy mapping of availability and condition fields, ensuring your products appear with rich snippets in Google search results.

What It Does

The Product Schema Auto-Rich API transforms your product data into properly formatted Schema.org JSON-LD markup that search engines can understand and display as rich snippets. This improves your product visibility in search results with enhanced listings showing price, availability, ratings, and more.

Simply send your product information—name and price are required, plus optional fields like currency, availability, condition, brand, SKU, images, and description—and receive back a complete, validated JSON-LD object ready to embed in your HTML.

Key Features

  • Fuzzy Field Mapping: Automatically recognizes variations like "in stock", "available", "yes" for availability
  • Schema.org Validation: Output conforms to Google's structured data requirements
  • Rich Snippet Ready: Supports ratings, reviews, offers, and aggregate data
  • Zero Configuration: Works out of the box with sensible defaults

Code Examples

curl -X POST https://api.atomicapis.dev/api/product-schema \
  -H "X-RapidAPI-Proxy-Secret: YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Wireless Headphones Pro",
    "price": 79.99,
    "currency": "USD",
    "description": "Premium noise-cancelling headphones",
    "brand": "AudioTech",
    "availability": "InStock",
    "ratingValue": 4.5,
    "reviewCount": 128
  }'

Request Parameters

Parameter Type Required Description
name string Required Product name or title
price decimal Required Product price (>= 0)
currency string Optional ISO 4217 currency code (e.g., USD, EUR, GBP)
description string Optional Product description
imageUrl string Optional URL to product image
sku string Optional Stock Keeping Unit - unique product identifier
gtin string Optional Global Trade Item Number (UPC, EAN, ISBN, etc.)
brand string Optional Product brand or manufacturer name
url string Optional Canonical URL to the product page
availability string Optional Stock status (e.g., "InStock", "OutOfStock", "PreOrder")
condition string Optional Product condition (e.g., "new", "used", "refurbished", "damaged")
sellerName string Optional Name of the seller
priceValidUntil string Optional Date until the price is valid (ISO 8601)
ratingValue double Optional Average rating value
reviewCount integer Optional Total number of reviews
bestRating integer Optional Highest possible rating value (default: 5)
worstRating integer Optional Lowest possible rating value (default: 1)

Response Format

The API returns a JSON object containing the generated Schema.org Product markup. The jsonLd field contains the complete structured data object.

Response Body
{
  "jsonLd": {
    "@context": "https://schema.org",
    "@type": "Product",
    "name": "Wireless Headphones Pro",
    "description": "Premium noise-cancelling headphones",
    "brand": {
      "@type": "Brand",
      "name": "AudioTech"
    },
    "offers": {
      "@type": "Offer",
      "price": 79.99,
      "priceCurrency": "USD",
      "availability": "https://schema.org/InStock"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": 4.5,
      "reviewCount": 128,
      "bestRating": 5,
      "worstRating": 1
    }
  },
  "htmlScript": "<script type=\"application/ld+json\">...</script>"
}

Response Fields

Field Type Description
jsonLd object The complete Schema.org Product JSON-LD object
htmlScript string Ready-to-embed HTML script tag containing the JSON-LD markup

Use Cases

E-commerce SEO

Automatically generate structured data for all your product pages to improve search visibility and enable rich snippets with price, availability, and ratings directly in Google search results.

Product Feed Generation

Generate Schema.org markup for product feeds sent to Google Merchant Center, Facebook Catalog, and other shopping channels that require structured product data.

Marketplace Listings

Standardize product data from multiple sources when listing on marketplaces like Amazon, eBay, or Etsy. The API normalizes availability and condition values across different formats.

Build Constraints

Implementation Notes

The following technical constraints apply when implementing this API:

Fuzzy Availability Mapping

The API accepts various availability strings and maps them to Schema.org values: "in stock", "instock", "available"InStock; "out of stock", "unavailable", "sold out"OutOfStock; "pre-order"PreOrder; etc.

Fuzzy Condition Mapping

Condition values are normalized: "new"NewCondition; "used"UsedCondition; "refurbished", "renewed"RefurbishedCondition; "damaged"DamagedCondition.

Mandatory Fields

The name and price fields are required. Requests missing these will return a 400 Bad Request error with details about missing fields. The availability field defaults to InStock if omitted.

Price Validation

Price must be a non-negative number (zero or greater). Negative values or non-numeric inputs will be rejected with validation errors.

Error Codes

Code Status Description
400 Bad Request Missing required fields or invalid data format
401 Unauthorized Invalid or missing API key
429 Too Many Requests Rate limit exceeded
500 Server Error Internal server error - contact support

MCP Integration MCP Ready

What is MCP?

Model Context Protocol (MCP) allows AI assistants like Claude to call this API as a native tool during conversation. Instead of writing HTTP requests, the AI invokes the tool directly — no API keys or boilerplate needed on the client side.

Tool Details

Tool Class
ProductSchemaTools
Method
GenerateProductSchema()

Description

Generates JSON-LD Product structured data for SEO