cotera
Logo

Google Shopping

Authentication Type: API Key

Description: Search for products across Google Shopping and get detailed product information including prices, ratings, reviews, and store offers.

Authentication

To authenticate, you'll need a RapidAPI key for the Real-Time Product Search API.

Search for products on Google Shopping with sorting and filtering options.

Search Products

Search for products across Google Shopping. Returns product listings with prices, ratings, store information, and available filters.

Operation Type: Query (Read)

Parameters:

  • q string (required): Search query for products (e.g., "Nike shoes")
  • country string (default: us): Country code for search results (e.g., us, uk, de)
  • language string (default: en): Language code for results (e.g., en, es, fr)
  • page number (default: 1): Page number for pagination
  • limit number (default: 10): Number of results per page (max 100)
  • sort_by string (default: BEST_MATCH): Sort order for results (BEST_MATCH, LOWEST_PRICE, HIGHEST_PRICE, TOP_RATED)
  • product_condition string (default: ANY): Filter by product condition (ANY, NEW, USED, REFURBISHED)
  • return_filters boolean (default: true): Whether to return available filters

Returns:

  • products array of objects: Array of product search results
    • product_id string: Unique product identifier (use for Product Details)
    • product_title string: Product name
    • product_description string (nullable): Product description
    • product_photos array of strings (nullable): Product image URLs
    • price string (nullable): Product price
    • store_name string (nullable): Seller/store name
    • product_rating number (nullable): Average product rating
    • product_num_reviews number (nullable): Number of reviews
    • product_page_url string (nullable): URL to product page
  • sponsored_products array: Sponsored product listings
  • filters array of objects: Available filter options
    • title string: Filter category name
    • multivalue boolean: Whether multiple values can be selected
    • values array of objects: Available filter values
      • title string: Filter value display name
      • q string: Query parameter for this filter
      • shoprs string: Filter identifier

Example Usage:

{
  "q": "wireless headphones",
  "country": "us",
  "language": "en",
  "page": 1,
  "limit": 20,
  "sort_by": "TOP_RATED",
  "product_condition": "NEW",
  "return_filters": true
}

Product Details

Get comprehensive information about a specific product.

Get Product Details

Get detailed information about a specific product including photos, ratings, reviews, pricing, variants, and available offers from different stores.

Operation Type: Query (Read)

Parameters:

  • product_id string (required): The product ID from a previous search result
  • country string (default: us): Country code for product details (e.g., us, uk, de)
  • language string (default: en): Language code for results (e.g., en, es, fr)

Returns:

  • product object: Detailed product information
    • product_id string: Unique product identifier
    • product_title string: Product name
    • product_description string: Full product description
    • product_photos array of strings: Product image URLs
    • product_videos array: Product video content
    • product_attributes object: Product specifications and attributes
    • product_rating number: Average product rating
    • product_page_url string: URL to product page
    • product_num_reviews number: Total number of reviews
    • product_num_offers number: Number of available offers
    • typical_price_range array of strings: Typical price range for this product
    • current_product_variant_properties object: Current variant selections
    • product_variants object: Available product variants (colors, sizes, etc.)
    • reviews_insights object: Aggregated review insights
    • offer object: Best available offer
      • offer_id string: Unique offer identifier
      • offer_title string: Offer title
      • offer_page_url string: URL to purchase
      • price string: Current price
      • original_price string (nullable): Original price before discount
      • on_sale boolean: Whether the product is on sale
      • shipping string: Shipping information
      • returns string: Return policy
      • product_condition string: Product condition
      • store_name string: Store/seller name
      • store_rating string: Store rating
      • store_review_count number: Number of store reviews
      • store_reviews_page_url string: URL to store reviews
      • store_favicon string: Store favicon URL
      • special_offer string: Special offer details
      • special_offer_expiration string: When special offer expires
      • payment_methods string: Accepted payment methods

Example Usage:

{
  "product_id": "11577822405123972122",
  "country": "us",
  "language": "en"
}

Product Reviews

Get reviews for a specific product with pagination and filtering options.

Get Product Reviews

Get reviews for a specific product including ratings, review text, author information, and pagination support.

Operation Type: Query (Read)

Parameters:

  • product_id string (required): The product ID from a previous search result
  • limit number (default: 50): Maximum number of reviews to return (1-100)
  • cursor string (default: null): Cursor for pagination to get the next set of results
  • sort_by string (default: MOST_RELEVANT): Sort order for reviews (MOST_RELEVANT, MOST_RECENT)
  • rating number (default: null): Only return reviews with rating greater than this value (1-5)
  • country string (default: us): Country code for results (e.g., us, uk, de)
  • language string (default: en): Language code for results (e.g., en, es, fr)

Returns:

  • reviews array of objects: Array of product reviews
    • review_id string: Unique review identifier
    • review_title string: Review title/headline
    • rating number: Review rating (1-5)
    • review_text string: Full review text content
    • review_date string: Human-readable review date
    • review_datetime_utc string: Review timestamp in UTC
    • review_author string: Name of the reviewer
    • review_author_photo string: URL to reviewer's profile photo
    • review_source string: Source of the review (e.g., store name)
    • review_source_url string: URL to the original review
  • product_rating number: Overall product rating
  • product_num_reviews number: Total number of reviews for this product
  • reviews_per_rating object: Breakdown of reviews by rating
    • 1 number: Count of 1-star reviews
    • 2 number: Count of 2-star reviews
    • 3 number: Count of 3-star reviews
    • 4 number: Count of 4-star reviews
    • 5 number: Count of 5-star reviews
  • cursor string (nullable): Cursor for fetching the next page of results

Example Usage:

{
  "product_id": "11577822405123972122",
  "limit": 50,
  "cursor": null,
  "sort_by": "MOST_RECENT",
  "rating": null,
  "country": "us",
  "language": "en"
}

Common Use Cases

Price Comparison:

  • Search for products and compare prices across different stores
  • Find the best deals by sorting results by lowest price
  • Track price changes by monitoring typical price ranges

Product Research:

  • Get detailed product specifications and attributes
  • Read aggregated review insights before purchasing
  • Compare product variants like colors, sizes, and configurations

Review Analysis:

  • Analyze customer sentiment by fetching product reviews
  • Filter reviews by rating to identify common complaints or praise
  • Track review trends over time with pagination and sorting options

E-commerce Integration:

  • Build product recommendation systems with real-time pricing
  • Create price monitoring and alerting workflows
  • Enrich product catalogs with Google Shopping data

Competitive Analysis:

  • Monitor competitor product pricing and availability
  • Track store ratings and review counts
  • Analyze market positioning across different product categories