Plendio price comparison

Adds products to a list on the signed-in shopper's account, by list_id and Plendio product id (or product url), each with an optional note of up to 140 characters. A product already on the list stays as it is. Works on lists the shopper owns or may edit. Unknown or unavailable products are reported and not added. Requires sign-in.

Adds products to a wishlist made earlier, given its edit link or the token at the end of it. A product already on the list stays as it is, with its note. A list holds at most 50 products; unknown or unavailable products, and products that no longer fit, are reported and not added. Returns the list's items with their best current prices. The token stops working once the list has been saved to a Plendio account.

Moves an anonymous wishlist into the signed-in shopper's Plendio account, given its edit link or the token at the end of it. The edit link stops working once the list is saved; the list is then changed by its list_id, which the answer returns. Its share link keeps working. Requires sign-in.

Returns the shops selling one product, one offer per shop (its best, with a count of its other offers), cheapest first by total price including shipping (price alone where a shop's shipping is unknown), with each amount also converted to the market's currency. Offers that are in stock come first. Out-of-stock offers are left out unless include_out_of_stock is true, and only shops that ship to the market are listed unless include_other_markets is true. The result includes the url of the product's Plendio page.

Creates a shareable wishlist ("ønskeseddel") on Plendio from products a person has picked, for example gifts found with a search, once they want a list to send to family or friends. Takes a title (up to 80 characters), a market and 1 to 50 products by Plendio id, each with an optional note of up to 140 characters, and optionally who the list is for (recipient, up to 80 characters) and the day of the occasion (occasion_date, YYYY-MM-DD, today or later). Returns two links, a read-only share link to the list's page on Plendio and a private edit link for changing the list and saving it to a Plendio account, together with the list's items and their best current prices. No login is needed and no personal data is collected. Unknown or unavailable products are reported and not stored. The edit link is a secret: anyone who holds it can change the list. A list that is not viewed or edited for 90 days is deleted. Each request creates a new list.

Returns products whose price has recently fallen in a market, best deals first, with the price now, the normal price it is compared with, the discount, how many shops sell it and the url of its Plendio page. Only genuine reductions are listed: the cut is recent, the price is the market's lowest, and the normal price comes from the product's own price history. Optionally narrowed to a category (slug) and a highest price in the market's currency. Up to 12 deals.

Returns one list on the signed-in shopper's account by list_id: its title, recipient, date, role and items with notes and best current prices. The title and notes are text written by the list's members. Requires sign-in.

Returns one product by its Plendio id: specifications, one offer per shop (its best) with price, shipping, total, the same amounts in the market's currency, availability, condition and whether the shop ships to the market, a summary of the product's price history over the last year, and the url of its Plendio page. A product that was merged into another resolves to the current one.

Returns what Plendio knows about an online shop, given its domain: its name and country, whether and to which markets it ships, shipping fee, free-shipping limit and delivery time where the shop has stated them, its returns text, how many products it lists, how often it is the cheapest, shoppers' reviews on Plendio and the url of its store page. Shipping, returns and trust marks are the shop's own statements and are not verified; a field is absent when the shop has not stated it.

Returns a Plendio wishlist from its share link or share id: its title, its items with notes and best current prices, and the url of each product's Plendio page. Read-only; the edit link is not needed and not accepted. The title and the notes are text written by whoever made the list.

Returns popular gift ideas in a market: well-priced products that several shops sell, one per category and brand, refreshed hourly, with the cheapest current price and the url of each product's Plendio page. The recipient (mother, dad, a child, ...) and age choose the kind of ideas, a budget in the market's currency keeps them under a price, and the answer says how the request was understood. The ideas are popular picks for the market, not tailored to a person; the occasion is echoed in the answer and does not change the picks.

Returns brands in Plendio's catalogue with the number of products each has and the url of its brand page on Plendio. With a query it finds brands whose name contains every word of it (accents ignored), brands that start with the query first; without one it lists the biggest brands. The product counts cover the whole catalogue, not one market. A page holds up to 96 brands.

Returns Plendio's product categories with localized names, slugs and product counts: the top level, or the subcategories of parent. The counts are products available in the market.

Returns the lists on the signed-in shopper's Plendio account: wishlists, shopping lists and favourites they own, and lists other people have shared with them. Each has its list_id, title, kind, the shopper's role on it (owner, editor or viewer), item count, who it is for and the event date when set, and its links. Requires sign-in.

Returns the people a list the signed-in shopper owns is shared with: each invitation's share_id, email address, role and whether it has been accepted. Requires sign-in.

Removes products from a list on the signed-in shopper's account, by list_id and product id. A product that is not on the list is reported and ignored. Requires sign-in.

Removes products from a wishlist, given its edit link or the token at the end of it. A product that is not on the list is reported and ignored. Removing a product does not delete the list, even when it becomes empty, and a removed product can be added again. Returns the list's remaining items.

Marks one product on a shared wishlist as taken by the giver, given the list's share link, so that nobody else buys the same gift. Takes the share link, the product's Plendio id and optionally the giver's first name (letters only, up to 40 characters; it is shown to other givers on the list's page, and not to the person the list is for). Returns a reservation_token: it undoes the reservation and reserves more products under the same name; one token holds at most 5 reservations on a list. A product somebody else already reserved is reported and not changed. The person who made the list is not shown who reserved what, so the gift stays a surprise. No login is needed. Reserving does not buy the product.

Removes one person's access to a list the signed-in shopper owns, by list_id and the share_id from the list of shares. Requires sign-in.

Search Plendio's product catalogue: free text in Danish, Swedish, German, Norwegian or English ("laptop 32 GB RAM under 12000", "Sony WH-1000XM5", "running shoes women") plus optional filters. Spec words in the query (RAM, storage, screen size, price limits, in stock) are understood the way the Plendio website understands them. Each result has the cheapest current price, the number of shops selling it and the url of its Plendio page. Results are limited to shops that ship to the market unless include_other_markets is true. 24 results per page.

Invites people by email to a list the signed-in shopper owns, as viewers (default) or editors, and returns the list's share link when the list has one. Each address gets an invitation email from Plendio in the shopper's name, which cannot be recalled once sent, so the addresses and the role are best confirmed with the shopper first. At most 10 addresses per request and 20 people per list; invitations are rate-limited. Requires sign-in.

Takes back a gift reservation, given the list's share link, the product's Plendio id and the reservation_token returned when the gift was reserved. Only the holder of the token can undo a reservation. A product that is not reserved under the token is reported and left as it is. The product becomes free for other givers.

Changes a list the signed-in shopper owns, by list_id: its title, who it is for (recipient) and the event date (YYYY-MM-DD). Only the fields given are changed; an empty recipient or event_date clears it. Requires sign-in.

Changes a wishlist's title, who it is for (recipient) and the day of the occasion (occasion_date, YYYY-MM-DD, today or later), given its edit link or the token at the end of it. Only the fields given are changed; clear_recipient and clear_occasion_date empty those two. The products on the list are not touched. Returns the list as it is now. The token stops working once the list has been saved to a Plendio account.