Product Resolution Engine

An Apify Actor that resolves any e-commerce product URL into structured, standardized product data with comprehensive buying options from Google Shopping.

🚀 Overview

The Product Resolution Engine is designed to take a messy, unstructured product URL from any merchant (like Amazon, Flipkart, Vijay Sales, etc.) and convert it into a rich, structured Google Shopping product profile.

Instead of just scraping the provided URL, it:

1. Preprocesses the input URL to extract canonical metadata, product slug, and store information.
2. Builds smart search queries to find the exact product on Google Shopping.
3. Searches for the product using downstream search actors.
4. Retrieves immersive details, exploring "immersive" Google Shopping product pages to gather deep specifications, variants, and a list of all competing merchants selling the same product.
5. Deduplicates & Matches the results intelligently using Google's internal prds identifiers.

This is extremely useful for building price comparison tools, cross-referencing merchant inventories, and standardizing product catalogs.

📦 Input Schema

Field	Type	Default	Description
url	string	—	Product URL to resolve (required). Works with any major e-commerce URL.
country	string	"in"	Google country code (e.g., us, gb, in) to localize search results.

📊 Output Data Structure

The Actor pushes structured data to the default Apify dataset. Each item contains the original input_url and a list of matched_products found on Google Shopping.

{
  "input_url": "https://www.vijaysales.com/apple-iphone-16-128gb-storage-white/p/P232288",
  "matched_products": [
    {
      "google_product_url": "https://www.google.com/search?...",
      "immersive_details": {
        "title": "Apple iPhone 16",
        "description": "The iPhone 16 features a beautiful aerospace-grade aluminum design...",
        "images": ["https://..."],
        "rating": 4.7,
        "review_count": 29000,
        "features": {
          "Display Size": "6.1 in",
          "Processor": "A18 chip",
          "Camera Resolution": "12 MP (Front Camera)"
        },
        "filters": [
          {
            "category": "Colour",
            "options": [{ "name": "White", "selected": true }, { "name": "Black", "selected": false }]
          },
          {
            "category": "Capacity",
            "options": [{ "name": "128 GB", "selected": true }]
          }
        ],
        "buying_options": [
          {
            "merchant": "Vijay Sales",
            "merchant_id": "116757378",
            "offer_id": "3268350979432508655",
            "title": "Apple iPhone 16 (128GB Storage, White)",
            "price": "₹66,490",
            "currency": "INR",
            "target_url": "https://www.vijaysales.com/...",
            "status": "In stock online",
            "delivery": "Free next-day delivery"
          }
        ],
        "competing_products": [
          {
            "product_id": "2221773634161838618",
            "text": "Apple iPhone 16 | ₹54,499 | Cashify"
          }
        ],
        "_source_url": "https://www.google.com/search?..."
      }
    }
  ]
}