Batch Validation

High-performance batch validation for up to 1,000 products per request. Ideal for bulk operations, catalog imports, and enterprise-scale validation workflows with comprehensive dual-score analytics.

POST /api/v2/validate/batch

Batch validation of 1-1,000 products with GMC compliance and performance optimization insights.

Key Features

⚡

High-Volume Processing

Validate up to 1,000 products in a single request

⚡

Dual-Score Architecture

GMC compliance + performance optimization metrics

⚡

Batch Analytics

Comprehensive batch-level insights and trends

⚡

Enterprise Performance

Optimized for large-scale catalog operations

Authentication

This endpoint requires API key authentication:

Authorization: Bearer adb_test_your_api_key_here

Request Format

Request Body

JSON Schema

{
  "products": [
    {
      "id": "product-1",
      "title": "Samsung Galaxy S23 Ultra 256GB",
      "description": "Latest flagship smartphone with advanced camera system",
      "price": "1199.99 USD",
      "gtin": "8806094517001",
      "category": "Electronics",
      "brand": "Samsung",
      "imageLink": "https://example.com/galaxy-s23.jpg",
      "availability": "in_stock",
      "condition": "new"
    },
    {
      "id": "product-2", 
      "title": "Apple MacBook Air M2",
      "description": "13-inch laptop with M2 chip",
      "price": "999.99 USD",
      "gtin": "194252577691",
      "category": "Electronics",
      "brand": "Apple"
    }
  ],
  "enableGoogleIntelligence": true
}

Parameters

Parameter	Type	Required	Description
products	array	Required	Array of products to validate (1-1,000 items)
enableGoogleIntelligence	boolean	Optional	Enable advanced category intelligence (default: true)

Product Object Structure

Field	Type	Required	Description
title	string	Required	Product title
description	string	Required	Product description
price	string	Required	Product price with currency
gtin	string	Optional	Product GTIN/UPC code
category	string	Optional	Product category
brand	string	Optional	Product brand

Response Format

JSON Response

{
  "success": true,
  "batchCompliance": {
    "gmcCompliant": "85%",
    "fullyCompliantProducts": 17,
    "totalProducts": 20,
    "message": "Batch Google Merchant Center compliance analysis"
  },
  "batchOptimization": {
    "averageOptimizationScore": 78,
    "totalOptimizationOpportunities": 42,
    "estimatedBatchRevenueGain": 15420,
    "message": "Batch average 22% optimization opportunity"
  },
  "batchSummary": {
    "totalProducts": 20,
    "validProducts": 17,
    "productsWithErrors": 3,
    "totalRevenueAtRisk": 15420,
    "avgComplianceScore": 0.85,
    "processingTime": 1247
  },
  "results": [
    {
      "gmcCompliance": {
        "status": "fully_compliant",
        "coverage": "100%",
        "message": "Google Merchant Center requirements satisfied"
      },
      "performanceOptimization": {
        "overallScore": 92,
        "message": "8% optimization opportunity identified",
        "estimatedRevenueGain": 127
      },
      "productId": "product-1",
      "validationScore": 92,
      "totalErrors": 1,
      "totalRevenueImpact": 127,
      "overallPriority": "low",
      "results": {
        "identity": { "hasErrors": false, "errorCount": 0 },
        "content": { "hasErrors": false, "errorCount": 0 },
        "pricing": { "hasErrors": false, "errorCount": 0 },
        "media": { "hasErrors": true, "errorCount": 1 },
        "inventory": { "hasErrors": false, "errorCount": 0 },
        "category": { "hasErrors": false, "errorCount": 0 }
      }
    }
  ],
  "billing": {
    "cost": 0,
    "testMode": true,
    "productCount": 20
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2025-08-07T21:45:00Z",
    "processingTime": 1247,
    "apiVersion": "2.0.0",
    "endpoint": "/api/v2/validate/batch",
    "method": "POST",
    "tier": "test",
    "usage": {
      "monthly": 501,
      "limit": 1000,
      "remaining": 499
    }
  }
}

✅ Understanding Batch Validation Scores

Batch validation provides enterprise-scale dual scoring intelligence across up to 1,000 products, delivering both individual product insights and comprehensive batch-level analytics.

Batch GMC Compliance

(0-100%)

Purpose: Aggregate Google Merchant Center compliance across entire product catalog

Impact: Overall marketplace readiness and bulk approval likelihood

Example: 85% batch compliance

17 of 20 products fully compliant for Google Shopping

Batch Performance Optimization

(0-100%)

Purpose: Enterprise-scale revenue optimization across product portfolio

Impact: Catalog-wide performance improvement and revenue scaling

Example: 78% average optimization

$15,420 total revenue opportunity identified

Enterprise Batch Analytics

Total Products

Valid Products

Optimization Opportunities

1.2s

Processing Time

Batch Revenue Impact Intelligence

Total Estimated Batch Gain: $15,420

Average Per-Product Impact: $771

Batch Optimization Opportunity: 22%

Products at Risk:

3 products with critical compliance issues

Quick Wins Available:

15 products ready for immediate optimization

Batch Validation Categories

Identity Fields 19/20

Content Quality 18/20

Pricing Data 20/20

Media Assets 17/20

Inventory Status 19/20

Category Mapping 18/20

Enterprise Scoring Methodology

Learn about dual scoring across batch operations and enterprise-scale analytics

View Full Guide 🔗

Error Responses

400

Bad Request

Invalid request format or missing required fields

{"error": "products array is required", "code": "MISSING_PRODUCTS"}

401

Unauthorized

Invalid or missing API key

{"error": "Invalid API key", "code": "INVALID_AUTH"}

413

Payload Too Large

Batch size exceeds 1,000 products limit

{"error": "Batch size exceeds maximum of 1,000 products", "code": "BATCH_TOO_LARGE"}

Code Examples

cURL

cURL Request

curl -X POST https://api.validationcore.dev/api/v2/validate/batch \
  -H "Authorization: Bearer adb_test_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "id": "batch-product-1",
        "title": "Samsung Galaxy S23 Ultra 256GB",
        "description": "Latest flagship smartphone with advanced camera system",
        "price": "1199.99 USD",
        "gtin": "8806094517001",
        "category": "Electronics",
        "brand": "Samsung"
      },
      {
        "id": "batch-product-2",
        "title": "Apple MacBook Air M2",
        "description": "13-inch laptop with M2 chip",
        "price": "999.99 USD",
        "gtin": "194252577691",
        "category": "Electronics",
        "brand": "Apple"
      }
    ],
    "enableGoogleIntelligence": true
  }'

JavaScript (Node.js)

const response = await fetch('https://api.validationcore.dev/api/v2/validate/batch', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer adb_test_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    products: [
      {
        id: 'batch-product-1',
        title: 'Samsung Galaxy S23 Ultra 256GB',
        description: 'Latest flagship smartphone with advanced camera system',
        price: '1199.99 USD',
        gtin: '8806094517001',
        category: 'Electronics',
        brand: 'Samsung'
      },
      {
        id: 'batch-product-2',
        title: 'Apple MacBook Air M2',
        description: '13-inch laptop with M2 chip',
        price: '999.99 USD',
        gtin: '194252577691',
        category: 'Electronics',
        brand: 'Apple'
      }
    ],
    enableGoogleIntelligence: true
  })
});

const data = await response.json();

// Access dual-score batch results
console.log('Overall GMC Compliance:', data.gmcCompliance.coverage);
console.log('Batch Performance Score:', data.performanceOptimization.overallScore);
console.log('Products Processed:', data.summary.totalProducts);

// Process individual products
data.results.forEach((product, index) => {
  console.log(`Product ${index + 1}:`);
  console.log('  Issues:', product.issues.length);
  console.log('  Revenue Impact:', product.businessIntelligence.revenueImpact);
});

Best Practices

✓ Optimal batch size: 20-100 products for best performance

✓ Include product IDs for easier result mapping

✓ Enable Google Intelligence for advanced category validation

✓ Process batches sequentially to respect rate limits

✓ Use test mode (adb_test_*) for development and testing

Ready to Get Started?

Start batch validating your products with our professional API

Get API Key 🔗 Access the Playground