Product Validation

Comprehensive product validation with GMC compliance, category-specific intelligence, and revenue impact analysis. Our most popular endpoint for validating product feeds.

POST /api/v2/validate/product

Validates products against 114+ validation rules with category-specific intelligence.

Key Features

✓

GMC Compliance

114+ Google Merchant Center validation rules

🎯

Category Intelligence

6 specialized category validators

Revenue Impact

Business intelligence and ROI calculations

⚡

Batch Processing

Validate up to 100 products per request

Authentication

This endpoint requires API key authentication:

Authorization: Bearer your_api_key

Request Body

JSON Schema

{
  "products": [
    {
      "title": "Samsung Galaxy S23 Ultra 256GB",
      "description": "Latest flagship smartphone with advanced camera system",
      "price": "1199.99 USD",
      "brand": "Samsung",
      "gtin": "8806094375820",
      "availability": "in_stock",
      "condition": "new",
      "link": "https://example.com/product/galaxy-s23",
      "image_link": "https://example.com/images/galaxy-s23.jpg",
      "google_product_category": "Electronics > Communications > Telephony > Mobile Phones",
      "product_type": "Smartphones > Android > Samsung Galaxy"
    }
  ],
  "options": {
    "enableGoogleIntelligence": true,
    "enableRecommendations": true,
    "includeBusinessIntelligence": true
  }
}

Required Fields

title Product name (25-150 characters)

price Price with currency (e.g., "99.99 USD")

link Product page URL

Response

JSON Response

{
  "success": true,
  "data": {
    "products": [
      {
        "productId": "unknown",
        "isValid": false,
        "totalErrors": 2,
        "totalRevenueImpact": 2493,
        "overallPriority": "critical",
        "gmcCompliance": {
          "status": "fully_compliant",
          "percentage": 100,
          "requiredFieldsCheck": {
            "title": "compliant",
            "description": "compliant",
            "price": "compliant",
            "link": "compliant",
            "imageLink": "compliant",
            "availability": "compliant",
            "condition": "compliant"
          },
          "violations": [],
          "message": "Fully compliant with Google Merchant Center requirements"
        },
        "performanceOptimization": {
          "overallScore": 52,
          "estimatedRevenueImpact": 202,
          "message": "Significant 48% optimization opportunity with ValidationCore enhanced quality standards"
        }
      }
    ],
    "summary": {
      "complianceScore": 52,
      "totalProducts": 1,
      "validatedProducts": 1
    },
    "billing": {
      "productsValidated": 1,
      "cost": 0,
      "environment": "test"
    }
  }
}

📊 Understanding Your Results

GMC Compliance Score

(0-100%)

Impact: Product approval likelihood for Google Shopping and ads. Example: 100% compliance ("fully_compliant") means ready for Google Shopping - all required fields validated.

Example: 100% compliance ("fully_compliant")

Ready for Google Shopping - all required fields validated

Performance Optimization

(0-100%)

Purpose: Revenue impact and conversion optimization beyond basic compliance. Impact includes sales performance, marketplace visibility, and conversion optimization.

Example: 52% optimization

$202 revenue opportunity identified through ValidationCore enhancements

Google Intelligence Dual Metrics

Content Compliance Score (91)

Advanced content policy adherence and quality standards

Content Performance Score (58)

Content optimization for marketplace performance and conversions

Revenue Impact Intelligence

Total Estimated Gain: $525

Priority Level: Medium

Payback Period: < 2 months

Top Opportunities:

Product Description $285 impact

Technical Specifications $240 impact

Category-Specific Intelligence

Detected Category: Electronics

Category Confidence: 95%

Category-Specific Score: 89%

Complete Scoring Methodology

Learn about our dual scoring system across all 6 product categories

View Full Guide 🔗

💰 Pricing

Two-Tier System: Test environment is FREE, Production uses volume-based pricing.

First 10,000 validations: $0.08 each

10,001 - 50,000 validations: $0.06 each

50,001 - 200,000 validations: $0.04 each

200,001+ validations: $0.02 each

Each product in the request array counts as one validation. Volume pricing applies to your total monthly usage.

Error Responses

400 - Invalid Request

Request body validation failed

{ "success": false, "error": { "code": "VALIDATION_ERROR", "message": "Products array is required" } }

401 - Unauthorized

Invalid or missing API key

{ "success": false, "error": { "code": "UNAUTHORIZED", "message": "Invalid API key" } }

413 - Payload Too Large

Too many products in request

{ "success": false, "error": { "code": "PAYLOAD_TOO_LARGE", "message": "Maximum 100 products per request" } }

429 - Rate Limited

Too many requests for your environment

{ "success": false, "error": { "code": "RATE_LIMIT_EXCEEDED", "retryAfter": 60 } }

Code Examples

cURL

cURL Request

curl -X POST https://api.validationcore.dev/api/v2/validate/product \
  -H "Authorization: Bearer adb_test_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [{
      "title": "Samsung Galaxy S23 Ultra",
      "price": "999.99 USD",
      "link": "https://example.com/galaxy-s23",
      "brand": "Samsung"
    }],
    "options": {
      "enableGoogleIntelligence": true,
      "includeBusinessIntelligence": true
    }
  }'

JavaScript (Node.js)

const response = await fetch('https://api.validationcore.dev/api/v2/validate/product', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer adb_test_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    products: [{
      title: 'Samsung Galaxy S23 Ultra',
      price: '999.99 USD',
      link: 'https://example.com/galaxy-s23',
      brand: 'Samsung'
    }],
    options: {
      enableGoogleIntelligence: true,
      includeBusinessIntelligence: true
    }
  })
});

const data = await response.json();

// Access dual-score results
console.log('GMC Compliance:', data.gmcCompliance.coverage);
console.log('Performance Score:', data.performanceOptimization.overallScore);

// Access individual product results
const product = data.results[0];
console.log('Product Issues:', product.issues.length);
console.log('Revenue Impact:', product.businessIntelligence.revenueImpact);

Best Practices

✓ Batch products in groups of 20-50 for optimal performance

✓ Enable Google Intelligence for advanced category-specific recommendations

✓ Include business intelligence for revenue impact analysis

✓ Monitor compliance scores to track feed quality improvements

Ready to Get Started?

Start validating your products with our professional API

Get API Key 🔗 Access the Playground