Use when the member asks what they would get back or whether there is a coupon at a store, for example "Any rewards or coupons at Target?" or "What do I get back on these AirPods?". Returns Capital One Shopping reward rates, coupon codes, exclusions, and an activation link for merchant URLs. It is the check for a merchant before buyable products are presented or a checkout is created there. Classification: Read.
Inputs: product_urls = [{url, product_name}] (absolute URLs; product_name is optional and can be a product or merchant name), up to 20 per call, so all merchant and product URLs for one request fit in a single call; user_query (optional context; personal details are not needed). A product page URL gives the best result: the response is matched to that product and the activation link opens that page. A merchant's home or category page also works. The activation link always lands on the URL that was sent.
This tool returns no prices, availability, shipping, or tax, and does not search for products. It shows eligibility only and does not activate a trip.
Returns structuredContent.merchants, one entry per merchant: domain, name, status, matched_product, reward, how_to_activate_rewards and coupons; plus checked_at and, when some URLs were invalid, invalid_urls.
reward: text (the "Up to X% back in rewards" wording), percent_back, by_category (null when the merchant pays one rate; otherwise each category with its name and percent_back), lowest_rate_text, rate_note, expires_at (about 24 hours after the lookup: when to look the rate up again, not when the promotion ends), exclusions, exclusions_url and terms (the rewards terms: not cash back, no cash value, redeemable for eGift cards once the balance reaches $5). When by_category is null, text and percent_back are the rate, subject to the exclusions. When rates vary by category, the category rate and the exclusions determine what applies to a specific product. Capital One Shopping cannot tell whether a member counts as a new customer at a store, and some higher rates apply only to new customers. Where the category match is unclear, or the higher rate is a new-customer rate, the lowest listed rate is the rate that can be stated for the purchase, with a higher rate noted as possibly applying. Capital One Shopping states every rate, including category rates and the lowest listed rate, as "Up to X% back in rewards".
how_to_activate_rewards: link (the activation link), markdown (a ready-made link), affiliate (always true), landing_risk ("high": observed blocking automated browsers; otherwise "unknown", which does not mean safe), and first_navigation_in_paying_session, same_session_required and landing_confirmation_required (always true). A rate earns nothing without its activation link: the rate shown applies only to a purchase in a browser session that starts with this merchant's activation link (its first navigation) and completes checkout in it. A purchase in a session that began anywhere else earns no rewards at this rate. One activation covers the whole merchant for that session.
Checkout route: Capital One Shopping credits rewards only for a checkout completed in the browser session that opened the merchant's activation link. A UCP checkout, captured-cart checkout, or other direct or API checkout earns no Capital One Shopping rewards, even when a Capital One Shopping coupon is applied, so any coupon saving on such a route comes without the reward. Tapping a product or Buy card is a product choice, not a choice of checkout route. How to check out is the member's choice; members choosing a route that earns no rewards should know the reward rate and the estimated reward at stake. how_to_activate_rewards.api_checkout_credits_rewards is always false.
Activation protocol (how a purchase is associated with a trip):
1. A trip is recorded when the activation link is the first navigation of the browser session that completes the purchase. A purchase completed in a different session is not associated with the trip.
2. When the landing is an Access Denied, bot-check or challenge page, the store records no click, even though Capital One Shopping logs the trip as opened. The click is recorded once the block is cleared in that same session (a reload, or the member clicking through) and the activation link is opened again and renders the store page.
3. Replacing or resetting the browser session ends the session the trip belongs to, and going to the store directly records no trip. A cart built before a reset is not associated with a trip; a new session is associated only by opening the activation link again.
4. Rewards are calculated only for a checkout completed in the same session that opened the activation link. verify_shopping_trip_activation shows only that the activation link was opened; it does not confirm that a purchase earned rewards.
coupons (best discount first: code and description) are collected from the web and not verified by Capital One Shopping. They are codes to try, not a guaranteed discount, and may not combine with each other or with rewards. A merchant can have coupons and no reward (status "coupons_only"), or a reward and no coupons; nothing was found for a merchant only when both are empty.
Commercial relationship (for when a member asks): activation links are affiliate links (affiliate: true, labeled "(affiliate link)" in the text), and featured offers are promoted placements. Capital One Shopping earns a commission from the merchant on qualifying purchases and shares part of it with the member as rewards.
Errors: an invalid URL in a batch is skipped and listed in invalid_urls while the others are answered; if every URL is invalid, or more than 20 are sent, the call returns an error naming the field. A failed lookup returns no offer for that merchant rather than an error.
get_rewards_and_coupons_for_url