Improve pricing

AI-generated Key Takeaways

• The Merchant API is the new version of the Content API for Shopping and represents the future of product data integration.

• You can use the Price Insights report to see suggested sale prices for your products and predictions for performance changes.

• Query PriceInsightsProductView to retrieve suggested sale prices, predicted impressions, clicks, and conversions change fraction based on price adjustments.

• A sample query and response demonstrate how to use the reports.search method to access price insights data for your products.

You can use the price insights view to see suggested sale prices for your products, and predictions for the performance that you can expect if you update your products' prices. Using the price insights report can help you price your products more effectively.

See Improve product pricing with the price insights report for more information.

Query PriceInsightsProductView to view suggested sale prices for your products.

Here's a sample you can use to view suggested sales prices for your products. To make the request, pass the following Merchant Center Query Language statement to the reports.search method:

SELECT
  product_view.id, product_view.title, product_view.brand,
  product_view.price_micros, 
  product_view.currency_code, price_insights.suggested_price_micros,
  price_insights.suggested_price_currency_code,
  price_insights.predicted_impressions_change_fraction,
  price_insights.predicted_clicks_change_fraction,
  price_insights.predicted_conversions_change_fraction
FROM PriceInsightsProductView

Run

Click Run to try the sample in the API Explorer. After you click Run, update the merchant ID placeholder to your own merchant ID in the request URL. You can modify the query. The full query must remain on one line to work with the API explorer.

Here's a sample response from the preceding query:

{
  "results": [
    {
      "productView": {
        "id": "online:en:US:12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "priceMicros": "124990000"
        "currencyCode": "USD"
      }
      "priceInsights": {
        "suggestedPriceMicros": "135680000",
        "suggestedPriceCurrencyCode": "USD",
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "productView": {
        "id": "online:en:US:12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "categoryL1": "Apparel & Accessories",
        "priceMicros": "119990000"
        "currencyCode": "USD"
      }
      "priceInsights": {
        "suggestedPriceMicros": "125440000",
        "suggestedPriceCurrencyCode": "USD",
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "productView": {
        "id": "online:en:US:12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "categoryL1": "Apparel & Accessories",
        "priceMicros": "84990000"
        "currencyCode": "USD"
      }
      "priceInsights": {
        "suggestedPriceMicros": "82000000",
        "suggestedPriceCurrencyCode": "USD",
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}