Skip to content

Commit b632395

Browse files
author
Josselin Liebe
committed
feat(asin): add Asin integration
Add an Asin block for Amazon price data across 11 Amazon stores: - Search Amazon products with ASIN, price, rating and review count - Read every seller's offer for an ASIN from Amazon now, or get the last known offers without reading Amazon again - Get a product's price history with its lowest, highest and average price Outputs follow the documented OpenAPI schemas and were checked against live responses. Credentials are an Asin API key sent as a bearer token.
1 parent 61843fe commit b632395

24 files changed

Lines changed: 1235 additions & 7 deletions

File tree

‎apps/docs/components/icons.tsx‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10459,3 +10459,25 @@ export function PlaneIcon(props: SVGProps<SVGSVGElement>) {
1045910459
</svg>
1046010460
)
1046110461
}
10462+
10463+
export function AsinIcon(props: SVGProps<SVGSVGElement>) {
10464+
return (
10465+
<svg viewBox='0 0 32 32' xmlns='http://www.w3.org/2000/svg' {...props}>
10466+
<title>Asin</title>
10467+
<rect width='32' height='32' rx='8' fill='#0f172a' />
10468+
<path
10469+
d='M8.5 6.5h8.2c.7 0 1.3.3 1.8.7l6.6 6.6c1 1 1 2.6 0 3.6l-7.4 7.4c-1 1-2.6 1-3.6 0l-6.6-6.6c-.5-.5-.7-1.1-.7-1.8V8.2c0-.9.8-1.7 1.7-1.7Z'
10470+
fill='#fff'
10471+
/>
10472+
<circle cx='11.4' cy='11.2' r='1.8' fill='#0f172a' />
10473+
<path
10474+
d='M11.8 19.6l2.6-2.6 2 2 3.6-3.6'
10475+
fill='none'
10476+
stroke='#0f172a'
10477+
strokeWidth='2'
10478+
strokeLinecap='round'
10479+
strokeLinejoin='round'
10480+
/>
10481+
</svg>
10482+
)
10483+
}

‎apps/docs/components/ui/icon-mapping.ts‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,7 @@ import {
3434
ArxivIcon,
3535
AsanaIcon,
3636
AshbyIcon,
37+
AsinIcon,
3738
AthenaIcon,
3839
AttioIcon,
3940
AzureDataExplorerIcon,
@@ -348,6 +349,7 @@ export const blockTypeToIconMap: Record<string, IconComponent> = {
348349
arxiv: ArxivIcon,
349350
asana: AsanaIcon,
350351
ashby: AshbyIcon,
352+
asin: AsinIcon,
351353
athena: AthenaIcon,
352354
attio: AttioIcon,
353355
azure_data_explorer: AzureDataExplorerIcon,

‎apps/docs/content/docs/integrations/asin.mdx‎

Lines changed: 171 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,171 @@
1+
---
2+
title: Asin
3+
description: Search Amazon and read product offers and price history
4+
integration:
5+
type: "asin"
6+
color: "#FFFFFF"
7+
---
8+
9+
import { ReferenceDetails } from "@/components/ui/reference-details"
10+
11+
12+
{/* MANUAL-CONTENT-START:intro */}
13+
[Asin](https://www.asin.dev/) tracks Amazon prices: it searches Amazon, reads every seller's offer for a product and keeps its price history, across 11 Amazon stores.
14+
15+
With the Asin block, you can:
16+
17+
- **Search Amazon**: find products in a store with their ASIN, price, rating and review count
18+
- **Read offers**: get every seller's offer for an ASIN, with Amazon's own price and the lowest new and used prices, either read live from Amazon or as last known
19+
- **Follow prices**: get a product's price history with its lowest, highest and average price, stock and Buy Box seller
20+
21+
Create a personal API key in your [Asin account](https://www.asin.dev/) and paste it into the block.
22+
23+
In Sim, the Asin block lets your agents watch competitor prices, spot unauthorized sellers on your listings and tell whether today's price is a real deal.
24+
{/* MANUAL-CONTENT-END */}
25+
26+
## Use the block [#usage-instructions]
27+
28+
Search an Amazon store, read every seller's offer for an ASIN with Amazon's own price and the lowest new and used offers, and get a product's price history with its lowest, highest and average price, across 11 Amazon marketplaces.
29+
30+
## Actions
31+
32+
### Asin Search Products
33+
34+
Search an Amazon store and get up to 60 results, sponsored ones included, with ASIN, title, price, rating and review count.
35+
36+
<ReferenceDetails>
37+
38+
#### Input
39+
40+
| Parameter | Type | Required | Description |
41+
| --------- | ---- | -------- | ----------- |
42+
| `query` | string | Yes | Search terms \(e.g., "wireless earbuds"\) |
43+
| `marketplace` | string | No | Amazon store: com, co.uk, de, fr, it, es, ca, co.jp, com.br, com.mx or in \(defaults to "com"\) |
44+
| `apiKey` | string | Yes | Asin API key |
45+
46+
#### Output
47+
48+
| Parameter | Type | Description |
49+
| --------- | ---- | ----------- |
50+
| `results` | array | Products found on Amazon |
51+
| ↳ `asin` | string | The ASIN of the product |
52+
| ↳ `title` | string | Product title |
53+
| ↳ `image` | string | URL of the main product image |
54+
| ↳ `price` | number | Price shown in the results |
55+
| ↳ `currency` | string | ISO 4217 code of the marketplace currency |
56+
| ↳ `rating` | number | Average rating out of 5 |
57+
| ↳ `reviewsCount` | number | Number of reviews |
58+
59+
</ReferenceDetails>
60+
61+
### Asin Read Offers
62+
63+
Read every offer for an ASIN from Amazon now (uses a credit): seller, price, Prime and FBA, delivery, with Amazon's own price and the lowest new and used offers.
64+
65+
<ReferenceDetails>
66+
67+
#### Input
68+
69+
| Parameter | Type | Required | Description |
70+
| --------- | ---- | -------- | ----------- |
71+
| `asin` | string | Yes | The 10-character ASIN of the product \(e.g., "B09DFCB66S"\) |
72+
| `marketplace` | string | No | Amazon store: com, co.uk, de, fr, it, es, ca, co.jp, com.br, com.mx or in \(defaults to "com"\) |
73+
| `apiKey` | string | Yes | Asin API key |
74+
75+
#### Output
76+
77+
| Parameter | Type | Description |
78+
| --------- | ---- | ----------- |
79+
| `asin` | string | The ASIN of the product |
80+
| `marketplace` | string | Amazon store the offers come from |
81+
| `currency` | string | ISO 4217 code of the marketplace currency |
82+
| `fetchedAt` | string | When Amazon was read; null when the product was never read |
83+
| `charged` | boolean | Whether the request used a credit |
84+
| `amazonPrice` | number | Amazon's own price, when Amazon sells the product |
85+
| `lowestNewPrice` | number | Lowest price among offers that are not used |
86+
| `lowestUsedPrice` | number | Lowest used or renewed price |
87+
| `offers` | array | Offers for the product, cheapest first |
88+
| ↳ `seller` | string | Name of the seller |
89+
| ↳ `sellerId` | string | Amazon's ID of the seller |
90+
| ↳ `price` | number | Price of the offer in the marketplace currency |
91+
| ↳ `amazon` | boolean | Whether Amazon itself sells the offer |
92+
| ↳ `fulfilledByAmazon` | boolean | Whether Amazon ships the offer |
93+
| ↳ `used` | boolean | Whether the offer is used or renewed |
94+
| ↳ `deliveryTime` | string | Delivery date, as Amazon shows it |
95+
| ↳ `deliveryPrice` | string | Delivery cost, as Amazon shows it |
96+
97+
</ReferenceDetails>
98+
99+
### Asin Get Last Known Offers
100+
101+
Get the offers last read for an ASIN, cheapest first, with Amazon's own price and the lowest new and used offers, without reading Amazon again.
102+
103+
<ReferenceDetails>
104+
105+
#### Input
106+
107+
| Parameter | Type | Required | Description |
108+
| --------- | ---- | -------- | ----------- |
109+
| `asin` | string | Yes | The 10-character ASIN of the product \(e.g., "B09DFCB66S"\) |
110+
| `marketplace` | string | No | Amazon store: com, co.uk, de, fr, it, es, ca, co.jp, com.br, com.mx or in \(defaults to "com"\) |
111+
| `apiKey` | string | Yes | Asin API key |
112+
113+
#### Output
114+
115+
| Parameter | Type | Description |
116+
| --------- | ---- | ----------- |
117+
| `asin` | string | The ASIN of the product |
118+
| `marketplace` | string | Amazon store the offers come from |
119+
| `currency` | string | ISO 4217 code of the marketplace currency |
120+
| `fetchedAt` | string | When Amazon was read; null when the product was never read |
121+
| `charged` | boolean | Whether the request used a credit |
122+
| `amazonPrice` | number | Amazon's own price, when Amazon sells the product |
123+
| `lowestNewPrice` | number | Lowest price among offers that are not used |
124+
| `lowestUsedPrice` | number | Lowest used or renewed price |
125+
| `offers` | array | Offers for the product, cheapest first |
126+
| ↳ `seller` | string | Name of the seller |
127+
| ↳ `sellerId` | string | Amazon's ID of the seller |
128+
| ↳ `price` | number | Price of the offer in the marketplace currency |
129+
| ↳ `amazon` | boolean | Whether Amazon itself sells the offer |
130+
| ↳ `fulfilledByAmazon` | boolean | Whether Amazon ships the offer |
131+
| ↳ `used` | boolean | Whether the offer is used or renewed |
132+
| ↳ `deliveryTime` | string | Delivery date, as Amazon shows it |
133+
| ↳ `deliveryPrice` | string | Delivery cost, as Amazon shows it |
134+
135+
</ReferenceDetails>
136+
137+
### Asin Get Price History
138+
139+
Get every price read for an ASIN over a period, oldest first, with its lowest, highest and average price.
140+
141+
<ReferenceDetails>
142+
143+
#### Input
144+
145+
| Parameter | Type | Required | Description |
146+
| --------- | ---- | -------- | ----------- |
147+
| `asin` | string | Yes | The 10-character ASIN of the product \(e.g., "B09DFCB66S"\) |
148+
| `marketplace` | string | No | Amazon store: com, co.uk, de, fr, it, es, ca, co.jp, com.br, com.mx or in \(defaults to "com"\) |
149+
| `days` | number | No | Days of history to return \(defaults to 30\) |
150+
| `apiKey` | string | Yes | Asin API key |
151+
152+
#### Output
153+
154+
| Parameter | Type | Description |
155+
| --------- | ---- | ----------- |
156+
| `asin` | string | The ASIN of the product |
157+
| `marketplace` | string | Amazon store the prices come from |
158+
| `currency` | string | ISO 4217 code of the marketplace currency |
159+
| `lowestPrice` | number | Lowest price of the period |
160+
| `highestPrice` | number | Highest price of the period |
161+
| `averagePrice` | number | Average price of the period |
162+
| `history` | array | Prices read over the period, oldest first |
163+
| ↳ `price` | number | Price of the offer shown; null when there was no offer |
164+
| ↳ `inStock` | boolean | Whether the product was in stock |
165+
| ↳ `coupon` | string | Coupon shown, if any |
166+
| ↳ `seller` | string | Seller of the offer shown \(Buy Box\) |
167+
| ↳ `checkedAt` | string | When Amazon was read |
168+
169+
</ReferenceDetails>
170+
171+

‎apps/docs/content/docs/integrations/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@
1717
"asana",
1818
"asana-service-account",
1919
"ashby",
20+
"asin",
2021
"athena",
2122
"atlassian-service-account",
2223
"attio",

0 commit comments

Comments
 (0)