CROP
ProjectsParts ServicesMedia

Amazon Product Data Fields

Available Data from Amazon Product Advertising API

Amazon Product Data Fields

Available Data from Amazon Product Advertising API

Priority 1: Critical Fields

1. About This Item (Features/Bullets)

API Path: ItemInfo.Features.DisplayValues

Example for 1722887SM:

{
  "features": [
    "Genuine Briggs & Stratton part designed to exact OEM standards",
    "Yellow push-to-choke PTO switch for lawn mower applications",
    "Dimensions: 1.63 x 1.50 x 3.00 inches; Weight: 0.16 ounces",
    "Compatible with Simplicity, Snapper, Ferris, and Murray equipment",
    "Easy plug-and-play installation with no modifications required",
    "Ensures EPA emission compliance when installed properly"
  ]
}

Usage in CROP:

  • Enhanced product descriptions
  • SEO optimization (keywords)
  • Compatibility filters
  • Selling bullet points on product cards

2. Product Description

API Path: ItemInfo.ProductInfo.ItemDescription

Example:

This Briggs & Stratton PTO switch is designed for reliable
operation in outdoor power equipment. Features durable
construction and easy installation.

Usage:

  • Extended description on product page
  • Search optimization
  • Context for AI recommendations

3. Dimensions

API Path: ItemInfo.ProductInfo.ItemDimensions

Format:

{
  "dimensions": {
    "length": { "value": 1.63, "unit": "Inches" },
    "width": { "value": 1.50, "unit": "Inches" },
    "height": { "value": 3.00, "unit": "Inches" }
  }
}

Usage:

  • Shipping cost calculation
  • Size filters
  • Compatible parts matching

4. Weight

API Path: ItemInfo.ProductInfo.ItemDimensions.Weight

Format:

{
  "weight": {
    "value": 0.16,
    "unit": "Ounces"
  }
}

Usage:

  • Shipping cost
  • Light/heavy product grouping

5. UPC / GTIN / EAN

API Path: ItemInfo.ProductInfo.UPCList

Format:

{
  "upc": ["024847032031"],
  "gtin": "00024847032031",
  "ean": "0024847032031"
}

Usage:

  • Unique identification
  • Cross-reference with other catalogs
  • POS system integration
  • Duplicate avoidance

6. Images (High Resolution)

API Path: Images.Primary, Images.Variants

Format:

{
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/71ABC123.jpg",
      "variant": "primary",
      "width": 1500,
      "height": 1500
    },
    {
      "url": "https://m.media-amazon.com/images/I/71XYZ456.jpg",
      "variant": "additional",
      "width": 1000,
      "height": 1000
    }
  ]
}

Usage:

  • High-quality product photos
  • Zoom on product cards
  • Visual comparison

Priority 2: High-Value Fields

7. Product Categories

API Path: BrowseNodeInfo.BrowseNodes

Amazon categories for 1722887SM:

Patio, Lawn & Garden > Outdoor Power Equipment Parts & Accessories >
Lawn Mower Parts & Accessories > Electrical Parts > Switches

Mapped to CROP:

ELECTRICAL > Switches > PTO Switches

Usage:

  • Automatic categorization
  • Navigation filters
  • SEO breadcrumbs

8. Technical Specifications

API Path: ItemInfo.TechnicalInfo

Example:

{
  "specifications": {
    "Brand": "Briggs & Stratton",
    "Model Number": "1722887SM",
    "Color": "Yellow",
    "Material": "Plastic",
    "Voltage": "12V",
    "Amperage": "10A",
    "Warranty": "90 days",
    "Country of Origin": "USA"
  }
}

Usage:

  • Detailed specifications
  • Characteristic filters
  • Product comparison

9. Brand Information

API Path: ItemInfo.ByLineInfo.Brand

Format:

{
  "brand": {
    "name": "Briggs & Stratton",
    "logo": "https://logo-url.com/briggs.png",
    "verified": true
  }
}

Usage:

  • Manufacturer verification
  • Brand filter
  • Brand pages

10. Model Number

API Path: ItemInfo.ProductInfo.ModelNumber

Example: 1722887SM

Usage:

  • Cross-reference
  • Model search
  • Duplicate avoidance

Priority 3: Nice to Have

11. Customer Reviews

API Path: CustomerReviews

Format:

{
  "customerRating": {
    "average": 4.5,
    "count": 127,
    "distribution": {
      "5_star": 78,
      "4_star": 35,
      "3_star": 10,
      "2_star": 3,
      "1_star": 1
    }
  }
}

Usage:

  • Social proof
  • Sort by rating
  • Quality score

12. Q&A Count

API Path: CustomerQuestions.QuestionCount

Example: 23 questions

Usage:

  • Engagement metric
  • Popular products indicator

13. Warranty Information

API Path: ItemInfo.ProductInfo.Warranty

Example: "90 days manufacturer warranty"

Usage:

  • Customer confidence
  • Filter by warranty

14. Package Information

API Path: ItemInfo.ProductInfo.PackageInfo

Format:

{
  "packaging": {
    "quantity": 1,
    "type": "Retail Packaging",
    "dimensions": {
      "length": 4.5,
      "width": 3.0,
      "height": 3.5,
      "unit": "in"
    }
  }
}

API Path: SimilarProducts, AlsoBought

Format:

{
  "relatedProducts": [
    {
      "asin": "B01ABCD123",
      "title": "Briggs & Stratton Ignition Coil",
      "relationship": "frequently_bought_together"
    }
  ]
}

Usage:

  • Recommendations
  • Cross-sell
  • Related parts suggestions

Amazon PA API Resources

Full list of available resources:

const AMAZON_PA_RESOURCES = [
  // Item Info
  'ItemInfo.Title',
  'ItemInfo.ByLineInfo',
  'ItemInfo.ContentInfo',
  'ItemInfo.Features',              // "About this item"
  'ItemInfo.ManufactureInfo',
  'ItemInfo.ProductInfo',
  'ItemInfo.TechnicalInfo',

  // Images
  'Images.Primary.Large',
  'Images.Primary.Medium',
  'Images.Variants.Large',
  'Images.Variants.Medium',

  // Browse Nodes (Categories)
  'BrowseNodeInfo.BrowseNodes',
  'BrowseNodeInfo.WebsiteSalesRank',

  // Reviews
  'CustomerReviews.Count',
  'CustomerReviews.StarRating',

  // Offers (Pricing)
  'Offers.Listings.Price',
  'Offers.Listings.Availability',

  // Parent/Variations
  'ParentASIN',
  'VariationSummary',
];

Comparison: Current CROP vs. Amazon Enriched

FieldCurrent CROPAfter Amazon Enrichment
Description"SWITCH-PTO PUSH"6-bullet detailed description
DimensionsMissing1.63 x 1.50 x 3.00 in
Weight10 kg (generic)0.16 oz (accurate)
UPCMissing024847032031
Images1 low-res4 high-res (1500px)
CategoriesGenericELECTRICAL > Switches
SpecsBasic10+ detailed specs
ReviewsN/A4.5 (127 reviews)

Implementation Example

Real Amazon PA API Call

import { ProductAdvertisingAPIClient } from 'amazon-paapi';

const client = new ProductAdvertisingAPIClient({
  accessKey: process.env.AMAZON_PA_ACCESS_KEY,
  secretKey: process.env.AMAZON_PA_SECRET_KEY,
  partnerTag: process.env.AMAZON_PA_PARTNER_TAG,
  region: 'us-east-1'
});

// Search by part number
const response = await client.searchItems({
  keywords: 'Briggs Stratton 1722887SM',
  searchIndex: 'AutomotiveParts',
  itemCount: 10,
  resources: [
    'ItemInfo.Title',
    'ItemInfo.Features',           // About this item
    'ItemInfo.ProductInfo',         // Dimensions, Weight, UPC
    'Images.Primary.Large',
    'BrowseNodeInfo.BrowseNodes',
    'CustomerReviews.StarRating',
  ]
});

// Extract data
const item = response.SearchResult.Items[0];

console.log(item.ItemInfo.Features.DisplayValues);
// [
//   "Genuine Briggs & Stratton part...",
//   "Yellow push-to-choke PTO switch...",
//   ...
// ]

console.log(item.ItemInfo.ProductInfo.ItemDimensions);
// {
//   Length: { DisplayValue: "1.63", Unit: "Inches" },
//   Width: { DisplayValue: "1.50", Unit: "Inches" },
//   Height: { DisplayValue: "3.00", Unit: "Inches" },
//   Weight: { DisplayValue: "0.16", Unit: "Ounces" }
// }

console.log(item.ItemInfo.ProductInfo.UPCList);
// { DisplayValues: ["024847032031"] }

Data Enrichment Coverage

For 56,000 parts:

Data FieldCoverage (Estimated)Source
Features/Bullets65%Amazon PA API
Dimensions70%Amazon PA API
Weight75%Amazon PA API
UPC80%Amazon PA API
Images (High-res)65%Amazon PA API
Categories70%Amazon PA API
Specifications60%Amazon PA API
Reviews50%Amazon PA API

Overall enrichment rate: ~70% (39,200 parts)

Cost per Field

FieldAPI CostValue
Features$0.00015High
Dimensions$0.00015High
Weight$0.00015Medium
UPC$0.00015High
Images$0.00015High
Specs$0.00015Medium
Reviews$0.00015Low

Note: All fields come in one API call - no additional cost per field!

Next Steps

  1. Get API Keys:

  2. Test with Real API:

    # Add keys to .env
AMAZON_PA_ACCESS_KEY=your_key
AMAZON_PA_SECRET_KEY=your_secret
AMAZON_PA_PARTNER_TAG=your_tag

# Run test
bun scripts/enrich-with-real-api.ts 1722887SM

  3. Pilot Enrichment:

    • 100 parts
    • Validate quality
    • Measure costs

  4. Full Rollout:

    • 56,000 parts
    • Monitor performance
    • Continuous updates

Last Updated: 2025-11-24

Manufacturer Aliases Reference

The manufacturer alias system enables partial manufacturer name queries to work in autocomplete. For example: - "newh" → "New Holland" - "nh" → "New Holland" -...

Amazon Product Data Enrichment

Comprehensive plan for enriching CROP product data using Amazon's product information.

On this page

Amazon Product Data FieldsAvailable Data from Amazon Product Advertising APIPriority 1: Critical Fields1. About This Item (Features/Bullets)2. Product Description3. Dimensions4. Weight5. UPC / GTIN / EAN6. Images (High Resolution)Priority 2: High-Value Fields7. Product Categories8. Technical Specifications9. Brand Information10. Model NumberPriority 3: Nice to Have11. Customer Reviews12. Q&A Count13. Warranty Information14. Package Information15. Related ProductsAmazon PA API ResourcesComparison: Current CROP vs. Amazon EnrichedImplementation ExampleReal Amazon PA API CallData Enrichment CoverageCost per FieldNext Steps