{"uid":"cap_6uz1KL0YykUJaQVs6wmL5","slug":"agents-openwebninja-com-product-price-history-44174096","name":"Product Price History","description":"Get a product's full details along with the price history of each offer/store selling it. The response mirrors the Product Details endpoint, with every entry in the `offers` array additionally enriched with its dated `price_history`. Use the `page` parameter to page through the offers (page 1 returns the top offers, subsequent pages return additional stores/offers).","url":"https://agents.openwebninja.com/realtime-product-search/v2/product-price-history-v2?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["product_id"],"properties":{"page":{"type":"integer","default":1,"description":"The page of offers to return price history for. Page 1 returns the top offers; each subsequent page pages through the remaining stores/offers."},"country":{"type":"string","default":"us","description":"Country code of the region/country for the call. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"},"language":{"type":"string","default":"en","description":"The language of the results. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes."},"product_id":{"type":"string","description":"Product id of the product for which to get price history."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"offers":{"type":"array","items":{"type":"object","properties":{"price":{"type":"string","nullable":true,"description":"The current price for this offer."},"on_sale":{"type":"boolean","nullable":true,"description":"Indicates whether the offer is currently on sale."},"returns":{"type":"string","nullable":true,"description":"The returns policy of the offer."},"offer_id":{"type":"string","nullable":true,"description":"The unique identifier for the offer."},"shipping":{"type":"string","nullable":true,"description":"The shipping details of the offer."},"store_name":{"type":"string","nullable":true,"description":"The name of the store/seller for this offer."},"merchant_id":{"type":"string","nullable":true,"description":"The identifier of the merchant."},"offer_title":{"type":"string","nullable":true,"description":"The title of the offer."},"store_rating":{"type":"string","nullable":true,"description":"The rating of the store."},"price_history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"The date of the recorded price."},"price":{"type":"string","description":"The recorded price on that date."}}},"description":"The dated price points for this offer (can be empty when no history is available)."},"store_favicon":{"type":"string","nullable":true,"description":"The favicon URL of the store."},"offer_page_url":{"type":"string","nullable":true,"description":"The URL of the offer page."},"original_price":{"type":"string","nullable":true,"description":"The original price before any discount."},"payment_methods":{"type":"string","nullable":true,"description":"The available payment methods for the offer."},"product_condition":{"type":"string","nullable":true,"description":"The condition of the product (e.g. NEW)."},"store_review_count":{"type":"integer","nullable":true,"description":"The number of reviews for the store."},"store_reviews_page_url":{"type":"string","nullable":true,"description":"The URL of the store's reviews page."}}},"description":"The offers for the current page, each enriched with its dated price history. Use the page parameter to page through offers."},"product_id":{"type":"string","description":"The unique identifier of the product. The response also carries the full Product Details payload (product_title, product_photos, product_rating, top_insights, videos, discussions_and_forums, etc.); see the Product Details endpoint for the complete product schema."},"product_title":{"type":"string","description":"The title of the product."},"product_rating":{"type":"number","description":"The average rating of the product."},"product_num_offers":{"type":"integer","description":"The total number of available offers for the product."}}},"status":{"type":"string","description":"The status of the API response."},"request_id":{"type":"string","description":"A unique identifier for this request."}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_qJk03XkiifrZtUgkAe_7F","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns full product details plus dated price history for each store/offer selling the product, paginated by offer page.","exampleAgentPrompt":"Can you pull up the full price history across all stores for product ID 'B09G3HRMVB' in the US? I want to see how the price has changed over time and which sellers have the best deal right now.","exampleUseCases":[{"title":"Spot a price drop before buying","prompt":"I'm thinking of buying this product — its ID is B08N5WRWNW. Can you check the price history across stores in the US so I can see if the current price is actually a good deal or if it usually sells cheaper?"},{"title":"Monitor seasonal pricing trends","prompt":"I want to understand how the price of product ID 12345678 has fluctuated over the past year across different retailers. Can you get me the full price history for all offers in the US?"},{"title":"Validate a claimed sale discount","prompt":"This listing says it's 40% off but I'm skeptical — can you pull the price history for product ID B07XJ8C8F5 and tell me what the original price was and whether it's actually lower than usual right now?"}],"resultDescription":"A JSON object containing full product details mirroring the Product Details endpoint, with the offers array enriched so each offer includes a price_history array of dated price points. Each offer also contains current price, original price, sale status, shipping details, store name, store rating, store review count, payment methods, product condition, and a link to the offer page. Results are paginated; page 1 returns top offers and subsequent pages return additional stores.","failureModes":["Invalid or unknown product_id returns empty or null data","Unsupported country code may return no results or default to US","Price history array may be empty if no historical data is available for that offer","Pagination beyond available pages returns empty offers array","Rate limiting or payment errors return 402 or 429 HTTP status codes","Truncated response schema may omit some fields for certain product types"],"whenToPreferThis":"Use this endpoint when you need to see how a product's price has changed over time across multiple stores, not just the current price. It is the right choice when evaluating whether a current price is a genuine discount, when tracking price volatility for a product, or when comparing historical price trends across sellers. Prefer this over the basic Product Details endpoint whenever temporal price data is needed rather than just a snapshot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:36.829Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-product-price-history-44174096"}