Categories Discovery API
Comprehensive category information endpoint for partner onboarding and API discovery. Access all 6 production categories with 73+ validation fields, tier-based pricing, and GMC compliance data.
/api/v2/categories
Public endpoint for discovering ValidationCore's comprehensive category validation capabilities
Key Features
6 Production Categories
Electronics, Apparel, Health & Beauty, Automotive, Home & Garden, Sports & Outdoors with specialized validation rules
73+ Validation Fields
14 universal core fields plus 59 category-specific fields for comprehensive product validation
GMC Compliance Data
Real-time compliance percentages (80-100%) and coverage statistics for informed integration decisions
No Authentication Required
Public discovery endpoint for easy partner evaluation and integration planning
Clear Tier Pricing
Transparent test and production tier information with feature breakdowns and monthly limits
Business Intelligence
Revenue impact data and business value metrics for each category specialization
Strategic Partner Value
Enable informed integration decisions with comprehensive validation capabilities and clear upgrade paths.
Validation System Architecture
Four-tier validation system providing comprehensive product data analysis and optimization.
Universal Core Validation
Essential GMC fields validated for all products
Category-Specific Validation
Specialized validation rules for different product categories
Revenue Impact Analysis
Business prioritization and optimization recommendations
Google Content Intelligence
Advanced Google Shopping optimization
Categories System Overview
ValidationCore supports 6 specialized categories plus universal core validation for comprehensive product coverage.
🌟 Universal Core
Essential GMC fields validated for all products regardless of category
Category-Specific Validators
Each category provides specialized validation rules and business intelligence for optimal product performance.
Electronics
Consumer electronics with technical specifications and energy efficiency
Apparel & Fashion
Clothing and fashion items with sizing, materials, and style information
Health & Beauty
Cosmetics, skincare, and wellness products with safety and compliance focus
Automotive
Vehicle parts and accessories with compatibility and safety focus
Home & Garden
Home improvement, furniture, and garden products with specifications
Sports & Outdoors
Athletic equipment and outdoor gear with safety and performance focus
Dual Scoring Intelligence
Advanced dual-score system providing both GMC compliance validation and business optimization insights.
✅ GMC Compliance Validation
Comprehensive Google Merchant Center field requirements verification
- • 100% field coverage verification
- • Real-time compliance status
- • Missing field identification
- • Format validation analysis
- • Policy compliance checking
- • Feed-level compliance scoring
📈 Business Optimization Analysis
Revenue impact assessment and performance optimization recommendations
- • Return reduction analysis (up to 42%)
- • Revenue impact calculations
- • Customer satisfaction metrics
- • Competitive positioning insights
- • Performance optimization roadmaps
- • Business intelligence reporting
Transparent Tier Pricing
Clear pricing structure designed for seamless integration and cost-effective scaling.
Test Environment
- ✓ Complete validation system access
- ✓ All 6 category validators (73+ fields)
- ✓ Universal + category-specific validation
- ✓ GTIN intelligence and business analytics
- ✓ Full API documentation access
- ✓ Community support and integration guides
Production Environment
- ✓ Enterprise-grade infrastructure
- ✓ Advanced business intelligence
- ✓ Priority support and SLA guarantee
- ✓ Custom integration assistance
- ✓ Dedicated account management
- ✓ White-label API access
- ℹ No setup fees or monthly minimums
- ℹ Free test environment for risk-free integration
- ℹ Volume discounts available for enterprise customers
- ℹ All pricing includes comprehensive category validation
Authentication
Public endpoint requiring no authentication for easy partner discovery and evaluation.
curl -X GET "https://api.validationcore.dev/v2/categories" \
-H "Accept: application/json"
Request Format
Simple GET request with optional query parameters for customized responses.
Query Parameters
format
string
Optional
Response format: 'json' (default), 'summary', 'detailed'
tier
string
Optional
Filter by tier: 'test', 'production', 'all' (default)
category
string
Optional
Specific category info: 'electronics', 'apparel', 'health_beauty', 'automotive', 'home_garden', 'sporting_goods'
Request Examples
Basic Categories Request
Get complete categories overview with all system information
curl -X GET "https://api.validationcore.dev/v2/categories" \
-H "Accept: application/json"
Summary Format Request
Get condensed categories overview for quick integration decisions
curl -X GET "https://api.validationcore.dev/v2/categories?format=summary" \
-H "Accept: application/json"
Specific Category Request
Get detailed information for a specific category validator
curl -X GET "https://api.validationcore.dev/v2/categories?category=electronics" \
-H "Accept: application/json"
Response Format
Comprehensive JSON response with categories, capabilities, pricing, and business intelligence data.
Response Fields
success
boolean
Request success status
data
object
Complete categories data including summary, capabilities, categories, and tiers
data.summary
object
System overview with total categories, fields, compliance averages, and version
data.capabilities
object
Four-tier validation system architecture details
data.universal
object
Universal core validation information (14 fields)
data.categories
object
Six specialized category validators with field counts, compliance, and features
data.tiers
object
Test and production tier pricing and feature information
metadata
object
API response metadata including request ID, timestamp, and version
Example Response
{
"success": true,
"data": {
"summary": {
"totalCategories": 6,
"totalUniversalFields": 14,
"totalCategoryFields": 59,
"totalSystemFields": 73,
"averageGmcCompliance": "89%",
"lastUpdated": "2025-01-27T10:30:00.000Z",
"systemVersion": "2.0.0"
},
"capabilities": {
"coreValidation": {
"name": "Universal Core Validation",
"fieldCount": 14,
"coverage": "80% GMC compliance baseline"
},
"categoryValidation": {
"name": "Category-Specific Validation",
"supportedCategories": 6,
"coverage": "90%+ GMC compliance with category expertise"
}
},
"universal": {
"name": "Universal Core",
"fieldCount": 14,
"gmcCompliance": "80%",
"features": ["Product identity validation", "Content validation", "Pricing validation"]
},
"categories": {
"electronics": {
"name": "Electronics",
"fieldCount": 6,
"totalFields": 20,
"gmcCompliance": "92%",
"tierRequired": "test"
},
"apparel": {
"name": "Apparel & Fashion",
"fieldCount": 8,
"totalFields": 22,
"gmcCompliance": "100%",
"tierRequired": "test"
}
},
"tiers": {
"test": {
"name": "Test Environment",
"price": "Free",
"monthlyLimit": 1000,
"categories": ["all"]
},
"production": {
"name": "Production Environment",
"price": "$0.05 per validation",
"monthlyLimit": "unlimited"
}
}
},
"metadata": {
"requestId": "cat_2025012710300001",
"timestamp": "2025-01-27T10:30:00.000Z",
"version": "2.0.0",
"processingTime": "45ms"
}
}
Error Handling
Professional error responses with clear resolution guidance for integration teams.
400
Invalid query parameters or malformed request
Resolution: Check parameter format and values. Refer to API documentation for valid options.
404
Specific category not found
Resolution: Use valid category names: electronics, apparel, health_beauty, automotive, home_garden, sporting_goods
429
Rate limit exceeded
Resolution: Reduce request frequency. Public endpoint has 50 requests per minute limit.
500
Internal server error during category data retrieval
Resolution: Contact support if issue persists. Include request ID for faster resolution.
SDK Integration Examples
Ready-to-use code examples for seamless integration across popular development platforms.
JavaScript/Node.js
Fetch categories data for partner onboarding or integration planning
const axios = require("text-blue-400">'axios"text-blue-400">');
// Get complete categories overview
async function getCategories() {
try {
const response = await axios.get("text-blue-400">'https://api.validationcore.dev/v2/categories"text-blue-400">');
const { summary, categories, tiers } = response.data.data;
console.log("text-blue-400">'Total Categories:"text-blue-400">', summary.totalCategories);
console.log("text-blue-400">'Total Fields:"text-blue-400">', summary.totalSystemFields);
console.log("text-blue-400">'Average GMC Compliance:"text-blue-400">', summary.averageGmcCompliance);
// Process category information
Object.keys(categories).forEach(categoryKey => {
const category = categories[categoryKey];
console.log(`${category.name}: ${category.totalFields} fields, ${category.gmcCompliance} GMC compliant`);
});
return response.data;
} catch (error) {
console.error("text-blue-400">'Categories API Error:"text-blue-400">', error.response?.data || error.message);
throw error;
}
}
Python
Integration planning and tier evaluation for Python applications
import requests
import json
def get_categories_info():
"""Get ValidationCore categories for integration planning."""
url = "https://api.validationcore.dev/v2/categories"
try:
response = requests.get(url)
response.raise_for_status()
data = response.json()["text-blue-400">'data"text-blue-400">']
summary = data["text-blue-400">'summary"text-blue-400">']
print(f"ValidationCore System Overview:")
print(f"Categories: {summary["text-blue-400">'totalCategories"text-blue-400">']}")
print(f"Total Fields: {summary["text-blue-400">'totalSystemFields"text-blue-400">']}")
print(f"Average GMC Compliance: {summary["text-blue-400">'averageGmcCompliance"text-blue-400">']}")
print(f"System Version: {summary["text-blue-400">'systemVersion"text-blue-400">']}")
# Analyze categories for business planning
for category_key, category in data["text-blue-400">'categories"text-blue-400">'].items():
print(f"\n{category["text-blue-400">'name"text-blue-400">']}:")
print(f" Fields: {category["text-blue-400">'totalFields"text-blue-400">']}")
print(f" GMC Compliance: {category["text-blue-400">'gmcCompliance"text-blue-400">']}")
print(f" Business Value: {category["text-blue-400">'businessValue"text-blue-400">']}")
return data
except requests.RequestException as e:
print(f"Categories API error: {e}")
raise
# Get categories for integration planning
categories_data = get_categories_info()
PHP
E-commerce platform integration with category discovery
"text-blue-400">'https://api.validationcore.dev/v2/categories"text-blue-400">';
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"text-blue-400">'Accept: application/json"text-blue-400">',
"text-blue-400">'User-Agent: E-commerce-Platform/1.0"text-blue-400">'
]
]);
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($httpCode !== 200) {
throw new Exception("Categories API error: HTTP $httpCode");
}
$data = json_decode($response, true);
if (!$data["text-blue-400">'success"text-blue-400">']) {
throw new Exception("text-blue-400">'Categories API returned error response"text-blue-400">');
}
$categories = $data["text-blue-400">'data"text-blue-400">']["text-blue-400">'categories"text-blue-400">'];
$summary = $data["text-blue-400">'data"text-blue-400">']["text-blue-400">'summary"text-blue-400">'];
echo "ValidationCore Categories Available:\n";
echo "Total System Fields: " . $summary["text-blue-400">'totalSystemFields"text-blue-400">'] . "\n";
echo "Average GMC Compliance: " . $summary["text-blue-400">'averageGmcCompliance"text-blue-400">'] . "\n";
// Process categories for integration decision
foreach ($categories as $key => $category) {
echo "\n{$category["text-blue-400">'name"text-blue-400">']}:\n";
echo " Total Fields: {$category["text-blue-400">'totalFields"text-blue-400">']}\n";
echo " GMC Compliance: {$category["text-blue-400">'gmcCompliance"text-blue-400">']}\n";
echo " Tier Required: {$category["text-blue-400">'tierRequired"text-blue-400">']}\n";
}
return $data;
}
try {
$categoriesData = getValidationCoreCategories();
} catch (Exception $e) {
echo "Error: " . $e->getMessage() . "\n";
}
?>