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.
/api/product-schema
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.
{
"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
ProductSchemaTools
GenerateProductSchema()
Description
Generates JSON-LD Product structured data for SEO