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.

GET /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.

73+
Validation Fields
Comprehensive coverage
89%
Average GMC Compliance
Across all categories
42%
Return Reduction
Through accurate specs
6
Specialized Categories
Production-ready validators

Validation System Architecture

Four-tier validation system providing comprehensive product data analysis and optimization.

Universal Core Validation

Essential GMC fields validated for all products

Product Identity (ID, Brand, GTIN, MPN)
Content (Title, Description, Link)
Pricing (Price, Availability, Condition)
Media (Image Link)
Inventory (Shipping Weight)
Category (Google Category, Product Type)
Additional Fields
80% GMC compliance baseline

Category-Specific Validation

Specialized validation rules for different product categories

6 specialized category validators
Average 10 fields per category
Category-specific business rules
Industry compliance requirements
Product type optimization
Specialized field validation
90%+ GMC compliance with category expertise

Revenue Impact Analysis

Business prioritization and optimization recommendations

Revenue impact calculations
Priority-based error classification
Optimization recommendations
Business intelligence reporting
Production tier required

Google Content Intelligence

Advanced Google Shopping optimization

Google Shopping performance analysis
Content optimization recommendations
Competitive positioning insights
Feed-level optimization roadmaps
Production tier required

Categories System Overview

ValidationCore supports 6 specialized categories plus universal core validation for comprehensive product coverage.

6
Categories
73
Validation Fields
89%
Avg GMC Compliance
2.0.0
System Version

🌟 Universal Core

Essential GMC fields validated for all products regardless of category

Field Count
14 fields
GMC Compliance
80%
Product identity validation (ID, Brand, GTIN, MPN)
Content validation (Title, Description, Link)
Pricing validation (Price, Availability, Condition)
Media validation (Image Link)
Inventory validation (Shipping Weight)
Category validation (Google Category, Product Type)
Additional fields validation

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

Category Fields
6
Total Fields
20
GMC Compliance
92%
Tier Required
test
Business Value
Reduces returns through accurate technical specifications
Key Features:
Technical specifications validation
Energy efficiency compliance
Operating system compatibility
Common Issues Detected:
Missing RAM specifications
Invalid energy efficiency ratings

Apparel & Fashion

Clothing and fashion items with sizing, materials, and style information

Category Fields
8
Total Fields
22
GMC Compliance
100%
Tier Required
test
Business Value
Reduces returns by 31% through accurate sizing information
Key Features:
Size and fit validation
Material composition analysis
Age and gender targeting
Common Issues Detected:
Missing size charts
Inconsistent color descriptions

Health & Beauty

Cosmetics, skincare, and wellness products with safety and compliance focus

Category Fields
15
Total Fields
29
GMC Compliance
90%
Tier Required
test
Business Value
Ensures regulatory compliance and builds consumer trust
Key Features:
FDA compliance validation
Ingredient transparency analysis
Safety warning requirements
Common Issues Detected:
Missing ingredient lists
Invalid expiration dates

Automotive

Vehicle parts and accessories with compatibility and safety focus

Category Fields
12
Total Fields
26
GMC Compliance
91%
Tier Required
test
Business Value
Reduces returns by 42% through accurate fitment information
Key Features:
Vehicle compatibility validation
OEM part number verification
Installation complexity analysis
Common Issues Detected:
Missing vehicle compatibility
Invalid part numbers

Home & Garden

Home improvement, furniture, and garden products with specifications

Category Fields
10
Total Fields
24
GMC Compliance
87%
Tier Required
test
Business Value
Improves customer satisfaction through accurate specifications
Key Features:
Dimension and space validation
Assembly requirements analysis
Material safety compliance
Common Issues Detected:
Missing product dimensions
Unclear assembly requirements

Sports & Outdoors

Athletic equipment and outdoor gear with safety and performance focus

Category Fields
8
Total Fields
22
GMC Compliance
89%
Tier Required
test
Business Value
Ensures safety compliance and appropriate targeting
Key Features:
Activity classification validation
Skill level appropriateness
Safety certification analysis
Common Issues Detected:
Missing activity specifications
Unclear skill level requirements

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

Free
1,000 validations
All categories available
  • 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

$0.05 per validation
Unlimited
All categories with premium features
  • 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";
}
?>