socialtap 1.496.28 → 1.506.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a search and get live data back in one schema. Failed requests are free.
6
6
 
7
7
  The TypeScript SDK for the SocialTap API: a method for every endpoint, typed models and errors, retries and pagination.
8
- Generated from the SocialTap catalog (version 1.496.28). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.506.29). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
@@ -97,6 +97,16 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
97
97
 
98
98
  | endpoint | method | cost |
99
99
  |---|---|---|
100
+ | `amazon.deal_products` | `client.amazon.dealProducts.list()` | 1 credit |
101
+ | `amazon.offers` | `client.amazon.offers.list()` | 1 credit |
102
+ | `amazon.product` | `client.amazon.product.get()` | 1 credit |
103
+ | `amazon.reviews` | `client.amazon.reviews.list()` | 1 credit |
104
+ | `amazon.search_products` | `client.amazon.searchProducts.list()` | 1 credit |
105
+ | `amazon.seller` | `client.amazon.seller.get()` | 1 credit |
106
+ | `amazon.shop` | `client.amazon.shop.get()` | 1 credit |
107
+ | `amazon.shop_lists` | `client.amazon.shopLists.list()` | 1 credit |
108
+ | `amazon.shop_posts` | `client.amazon.shopPosts.list()` | 1 credit |
109
+ | `amazon.top_products` | `client.amazon.topProducts.list()` | 1 credit |
100
110
  | `applemusic.album` | `client.applemusic.album.get()` | 1 credit |
101
111
  | `applemusic.artist` | `client.applemusic.artist.get()` | 1 credit |
102
112
  | `applemusic.search_albums` | `client.applemusic.searchAlbums.list()` | 1 credit |
@@ -380,7 +390,7 @@ stopped it) and `endReason` (the API's `page.end_reason`) say what happened.
380
390
  Each page is checked against its catalog price before it is fetched, and an empty page with `has_more` is not the end.
381
391
 
382
392
  ```ts
383
- const items = client.applemusic.searchAlbums.iterate({ query: "lover" }, { maxPages: 10, maxCredits: 100 });
393
+ const items = client.amazon.dealProducts.iterate({}, { maxPages: 10, maxCredits: 100 });
384
394
  for await (const item of items) {
385
395
  console.log(item);
386
396
  }
@@ -512,8 +522,11 @@ console.log(r.isError, r.output);
512
522
  | `list_playlist_stories` | Playlist stories |
513
523
  | `list_playlist_tracks` | Playlist tracks |
514
524
  | `list_podcast_episodes` | Podcast episodes |
525
+ | `list_shop_posts` | Shop posts of a profile |
515
526
  | `list_tracks` | Tracks of a profile |
516
527
  | `list_videos` | Videos of a profile |
528
+ | `get_seller` | Seller by handle |
529
+ | `get_shop` | Shop by handle |
517
530
  | `list_followers` | Followers of a profile |
518
531
  | `list_following` | Following of a profile |
519
532
  | `list_similar_profiles` | Similar profiles of a profile |
@@ -527,9 +540,9 @@ console.log(r.isError, r.output);
527
540
  | `get_hashtag` | Hashtag by link |
528
541
  | `list_trending_hashtags` | Trending hashtags |
529
542
  | `get_community` | Community by link |
543
+ | `get_product` | Product by link |
530
544
  | `get_album` | Album by link |
531
545
  | `get_playlist` | Playlist by link |
532
- | `get_product` | Product by link |
533
546
  | `get_sound` | Sound by link |
534
547
  | `get_topic` | Topic by link |
535
548
  | `get_download` | Download by link |
@@ -541,16 +554,20 @@ console.log(r.isError, r.output);
541
554
  | `get_podcast` | Podcast by link |
542
555
  | `get_username` | Username by handle |
543
556
  | `get_web_page` | Web page by link |
557
+ | `list_reviews` | Reviews of a product |
544
558
  | `list_boards` | Boards of a profile |
559
+ | `list_deal_products` | Deal products |
545
560
  | `list_events` | Events of a profile |
546
561
  | `list_highlights` | Highlights of a profile |
562
+ | `list_offers` | Offers of a product |
547
563
  | `list_place_events` | Place events |
548
564
  | `list_playlists` | Playlists of a profile |
549
565
  | `list_products` | Products of a profile |
550
- | `list_reviews` | Reviews of a product |
551
566
  | `list_schedule` | Schedule of a profile |
567
+ | `list_shop_lists` | Shop lists of a profile |
552
568
  | `list_top_albums` | Top albums |
553
569
  | `list_top_playlists` | Top playlists |
570
+ | `list_top_products` | Top products |
554
571
  | `list_top_trends` | Top trends |
555
572
  | `create_job` | Create a background job |
556
573
  | `get_job` | Get a background job |
package/dist/client.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { type ClientOptions, Core } from "./core.ts";
2
- import { AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.ts";
2
+ import { Amazon, AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.ts";
3
3
  import { Webhooks } from "./webhooks.ts";
4
4
  /**
5
5
  * The SocialTap API client: `new SocialTap({ apiKey })` (default: the SOCIALTAP_API_KEY environment variable).
@@ -9,18 +9,21 @@ import { Webhooks } from "./webhooks.ts";
9
9
  * LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook, Instagram, Reddit,
10
10
  * Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X; downloads on TikTok;
11
11
  * effects on TikTok; embeds on Instagram; engagement stats on Facebook, Instagram, Reddit, Rumble, TikTok and
12
- * YouTube; events on Facebook; hashtags on Instagram and TikTok; livestreams on TikTok and Twitch; places on
13
- * Facebook and Instagram; playlists on Apple Music, Instagram, Pinterest, Spotify and TikTok; podcasts on
14
- * Spotify; posts on Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble,
15
- * Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on
16
- * Facebook and TikTok Shop; profiles on Apple Music, Bluesky, Facebook, Google, Instagram, Komi, Kwai, LinkedIn,
17
- * Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram,
18
- * Threads, TikTok, Truth Social, Twitch, X and YouTube; reviews on TikTok Shop; sounds on Instagram and TikTok;
19
- * suggestions on Google and Instagram; topics on Instagram and Pinterest; transcripts on Facebook, Instagram,
20
- * Kick, Reddit, Rumble, TikTok, Twitch and YouTube; trends on Pinterest; usernames on Instagram; web pages on
21
- * Pinterest; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
12
+ * YouTube; events on Facebook; hashtags on Instagram and TikTok; livestreams on TikTok and Twitch; offers on
13
+ * Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music, Instagram, Pinterest, Spotify and
14
+ * TikTok; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn,
15
+ * Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X
16
+ * and YouTube; products on Amazon, Facebook and TikTok Shop; profiles on Amazon, Apple Music, Bluesky, Facebook,
17
+ * Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble,
18
+ * Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; reviews on
19
+ * Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on Google and Instagram; topics on
20
+ * Instagram and Pinterest; transcripts on Facebook, Instagram, Kick, Reddit, Rumble, TikTok, Twitch and YouTube;
21
+ * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
22
+ * LinkedIn, Telegram, TikTok and X.
22
23
  */
23
24
  export declare class SocialTap extends Core {
25
+ /** Amazon endpoints. */
26
+ readonly amazon: Amazon;
24
27
  /** Apple Music endpoints. */
25
28
  readonly applemusic: AppleMusic;
26
29
  /** Bluesky endpoints. */
package/dist/client.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Code generated by engine/cmd/gensdk (make gen) from catalog/catalog.gen.json; DO NOT EDIT.
2
2
  import { Core } from "./core.js";
3
- import { AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.js";
3
+ import { Amazon, AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.js";
4
4
  import { Webhooks } from "./webhooks.js";
5
5
  /**
6
6
  * The SocialTap API client: `new SocialTap({ apiKey })` (default: the SOCIALTAP_API_KEY environment variable).
@@ -10,18 +10,21 @@ import { Webhooks } from "./webhooks.js";
10
10
  * LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook, Instagram, Reddit,
11
11
  * Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X; downloads on TikTok;
12
12
  * effects on TikTok; embeds on Instagram; engagement stats on Facebook, Instagram, Reddit, Rumble, TikTok and
13
- * YouTube; events on Facebook; hashtags on Instagram and TikTok; livestreams on TikTok and Twitch; places on
14
- * Facebook and Instagram; playlists on Apple Music, Instagram, Pinterest, Spotify and TikTok; podcasts on
15
- * Spotify; posts on Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble,
16
- * Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on
17
- * Facebook and TikTok Shop; profiles on Apple Music, Bluesky, Facebook, Google, Instagram, Komi, Kwai, LinkedIn,
18
- * Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram,
19
- * Threads, TikTok, Truth Social, Twitch, X and YouTube; reviews on TikTok Shop; sounds on Instagram and TikTok;
20
- * suggestions on Google and Instagram; topics on Instagram and Pinterest; transcripts on Facebook, Instagram,
21
- * Kick, Reddit, Rumble, TikTok, Twitch and YouTube; trends on Pinterest; usernames on Instagram; web pages on
22
- * Pinterest; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
13
+ * YouTube; events on Facebook; hashtags on Instagram and TikTok; livestreams on TikTok and Twitch; offers on
14
+ * Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music, Instagram, Pinterest, Spotify and
15
+ * TikTok; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn,
16
+ * Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X
17
+ * and YouTube; products on Amazon, Facebook and TikTok Shop; profiles on Amazon, Apple Music, Bluesky, Facebook,
18
+ * Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble,
19
+ * Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; reviews on
20
+ * Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on Google and Instagram; topics on
21
+ * Instagram and Pinterest; transcripts on Facebook, Instagram, Kick, Reddit, Rumble, TikTok, Twitch and YouTube;
22
+ * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
23
+ * LinkedIn, Telegram, TikTok and X.
23
24
  */
24
25
  export class SocialTap extends Core {
26
+ /** Amazon endpoints. */
27
+ amazon;
25
28
  /** Apple Music endpoints. */
26
29
  applemusic;
27
30
  /** Bluesky endpoints. */
@@ -106,6 +109,7 @@ export class SocialTap extends Core {
106
109
  webhooks = new Webhooks();
107
110
  constructor(options = {}) {
108
111
  super(options);
112
+ this.amazon = new Amazon(this);
109
113
  this.applemusic = new AppleMusic(this);
110
114
  this.bluesky = new Bluesky(this);
111
115
  this.facebook = new Facebook(this);
package/dist/commands.js CHANGED
@@ -10,6 +10,182 @@ export const SKILLS_INDEX_PATH = "/.well-known/agent-skills/index.json";
10
10
  export const AGENTS_DOCS_URL = "https://socialtap.dev/docs/agents/";
11
11
  /** Every public endpoint, by platform. Params are checked by the API; the CLI checks presence and type. */
12
12
  export const COMMANDS = [
13
+ {
14
+ kind: "list",
15
+ platform: "amazon",
16
+ name: "deal_products",
17
+ endpoint: "amazon.deal_products",
18
+ summary: "Today's Deals with deal price, badge and end time",
19
+ price: "1 credit",
20
+ params: [
21
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace whose deals to read, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … Prices are that marketplace's, in its currency. Default: the category link's marketplace, else US. A country other than the category link's is refused. Example: US" },
22
+ { name: "category", type: "string", required: false, description: "Only the deals of one category: its browse node ID (172282 is Electronics on amazon.com), or a link that names one: a category link (amazon.com/b?node=172282), a search link filtered to a department, or a Today's Deals link with a department picked (its price and discount filters aren't applied). A product's platform_specific.amazon.categories[].id and a deal's platform_specific.amazon.deal.department_ids are such IDs. Omit for every deal. Browse nodes are each marketplace's own. At most 2048 characters. Example: 172282" },
23
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
24
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
25
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 100. Default: 100." },
26
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
27
+ ],
28
+ list: (c, p, o) => c.amazon.dealProducts.list(p, o),
29
+ iterate: (c, p, o) => c.amazon.dealProducts.iterate(p, o),
30
+ },
31
+ {
32
+ kind: "list",
33
+ platform: "amazon",
34
+ name: "offers",
35
+ endpoint: "amazon.offers",
36
+ summary: "Every seller's price, condition and delivery for an ASIN",
37
+ price: "1 credit",
38
+ params: [
39
+ { name: "url", type: "string", required: true, description: "The product: its link on any Amazon marketplace (amazon.com/dp/B0FQFB8FMG, with or without the title before /dp/, /gp/product/, /gp/aw/d/, /gp/offer-listing/, /product-reviews/ and the older /exec/obidos/ASIN/ links), a short link (amzn.to, a.co/d/, amzn.eu/d/, amzn.asia/d/, amzn.com), or its ASIN alone (B0FQFB8FMG, or a book's ISBN-10). At most 2048 characters. Example: https://www.amazon.com/dp/B0FQFB8FMG" },
40
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … Offers, prices and delivery are that marketplace's. Default: the link's marketplace, else US. Example: US" },
41
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
42
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
43
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 11. Default: 11." },
44
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
45
+ ],
46
+ list: (c, p, o) => c.amazon.offers.list(p, o),
47
+ iterate: (c, p, o) => c.amazon.offers.iterate(p, o),
48
+ },
49
+ {
50
+ kind: "get",
51
+ platform: "amazon",
52
+ name: "product",
53
+ endpoint: "amazon.product",
54
+ summary: "Price, rating, monthly sales and specs by ASIN",
55
+ price: "1 credit",
56
+ params: [
57
+ { name: "url", type: "string", required: true, description: "The product: its link on any Amazon marketplace (amazon.com/dp/B0FQFB8FMG, with or without the title before /dp/, /gp/product/, /gp/aw/d/, /product-reviews/ and the older /exec/obidos/ASIN/ links), a short link (amzn.to, a.co/d/, amzn.eu/d/, amzn.asia/d/, amzn.com), or its ASIN alone (B0FQFB8FMG, or a book's ISBN-10). At most 2048 characters. Example: https://www.amazon.com/dp/B0FQFB8FMG" },
58
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … Prices, stock and sellers are that marketplace's. Default: the link's marketplace, else US. Example: US" },
59
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
60
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
61
+ ],
62
+ get: (c, p, o) => c.amazon.product.get(p, o),
63
+ },
64
+ {
65
+ kind: "list",
66
+ platform: "amazon",
67
+ name: "reviews",
68
+ endpoint: "amazon.reviews",
69
+ summary: "Top customer reviews of a product, by marketplace",
70
+ price: "1 credit",
71
+ params: [
72
+ { name: "url", type: "string", required: true, description: "The product: its link on any Amazon marketplace (amazon.co.uk/dp/B003AIF4Q4, with or without the title before /dp/, /gp/product/, /gp/aw/d/, /product-reviews/ and the older /exec/obidos/ASIN/ links), a short link (amzn.to, a.co/d/, amzn.eu/d/, amzn.asia/d/, amzn.com), or its ASIN alone (B003AIF4Q4, or a book's ISBN-10) with country. At most 2048 characters. Example: https://www.amazon.co.uk/dp/B003AIF4Q4" },
73
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: GB (amazon.co.uk), DE, FR, IT, ES, CA, JP, IN, AU, … Each shows its own customers' top reviews first, then top reviews from other countries. Default: the link's marketplace, else US (amazon.com, which shows reviews only to signed-in visitors). Example: GB" },
74
+ { name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Example: 2026-10-01" },
75
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
76
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
77
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
78
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 20. Default: 20." },
79
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
80
+ ],
81
+ list: (c, p, o) => c.amazon.reviews.list(p, o),
82
+ iterate: (c, p, o) => c.amazon.reviews.iterate(p, o),
83
+ },
84
+ {
85
+ kind: "list",
86
+ platform: "amazon",
87
+ name: "search_products",
88
+ endpoint: "amazon.search_products",
89
+ summary: "Products by keyword with price, rating and sales",
90
+ price: "1 credit",
91
+ params: [
92
+ { name: "query", type: "string", required: true, description: "What to search for, as typed into Amazon's search box: keywords, a brand, a model or an ISBN. An Amazon search results link searches its keywords on its marketplace. At most 200 characters. Example: wireless earbuds" },
93
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to search, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … Results, prices and currency are that marketplace's. Default: US. Example: US" },
94
+ { name: "sort", type: "string", required: false, description: "Order of the results. relevance (default): Amazon's Featured order. price_asc, price_desc: the lowest or the highest price first. newest: Amazon's Newest Arrivals. popular: Amazon's Best Sellers order. One of: relevance, price_asc, price_desc, newest, popular. Default: relevance.", enum: ["relevance", "price_asc", "price_desc", "newest", "popular"] },
95
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
96
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
97
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 60. Default: 60." },
98
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
99
+ ],
100
+ list: (c, p, o) => c.amazon.searchProducts.list(p, o),
101
+ iterate: (c, p, o) => c.amazon.searchProducts.iterate(p, o),
102
+ },
103
+ {
104
+ kind: "get",
105
+ platform: "amazon",
106
+ name: "seller",
107
+ endpoint: "amazon.seller",
108
+ summary: "Seller ratings, feedback counts and business details",
109
+ price: "1 credit",
110
+ params: [
111
+ { name: "handle", type: "string", required: true, description: "The seller: its merchant ID (A3A7XJ7DLGM1CB, the seller= in its links) or its link on any Amazon marketplace: its page (amazon.com/sp?seller=…), the older /gp/aag/main?seller=, /gp/help/seller/at-a-glance.html?seller= and /shops/… links, or its storefront (amazon.com/s?me=…, /sp/redirect/storefront?seller=…). Sellers have no username. At most 2048 characters. Example: AN8LN2YPKS7DF" },
112
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … A seller's ratings and details are that marketplace's. Default: the link's marketplace, else US. Example: US" },
113
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
114
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
115
+ ],
116
+ get: (c, p, o) => c.amazon.seller.get(p, o),
117
+ },
118
+ {
119
+ kind: "get",
120
+ platform: "amazon",
121
+ name: "shop",
122
+ endpoint: "amazon.shop",
123
+ summary: "Influencer storefront profiles, curations and picks",
124
+ price: "1 credit",
125
+ params: [
126
+ { name: "handle", type: "string", required: true, description: "The influencer's storefront: its handle (sydneydelrey, the name after /shop/ in its link, any case, with or without the @), its link on any Amazon marketplace (amazon.com/shop/sydneydelrey, or a link to one of its photos, videos or curations), or its account ID (amzn1.account.…, the id this API returns) or amazon.com/gp/profile/ link. At most 2048 characters. Example: sydneydelrey" },
127
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, CA, IN, … A storefront shows that marketplace's prices; Amazon shows a creator's storefront on other marketplaces too. Default: the link's marketplace, else US. Example: US" },
128
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
129
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
130
+ ],
131
+ get: (c, p, o) => c.amazon.shop.get(p, o),
132
+ },
133
+ {
134
+ kind: "list",
135
+ platform: "amazon",
136
+ name: "shop_lists",
137
+ endpoint: "amazon.shop_lists",
138
+ summary: "Influencer idea lists with product counts and products",
139
+ price: "1 credit",
140
+ params: [
141
+ { name: "handle", type: "string", required: true, description: "The influencer's storefront: its handle (sydneydelrey, the name after /shop/ in its link, any case, with or without the @), its link on any Amazon marketplace (amazon.com/shop/sydneydelrey, or a link to one of its photos, videos or curations), or its account ID (amzn1.account.…, the id the Amazon Shop API returns) or amazon.com/gp/profile/ link. At most 2048 characters. Example: sydneydelrey" },
142
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, CA, IN, … A storefront shows that marketplace's prices; Amazon shows a creator's storefront on other marketplaces too. Default: the link's marketplace, else US. Example: US" },
143
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
144
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
145
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 20. Default: 20." },
146
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
147
+ ],
148
+ list: (c, p, o) => c.amazon.shopLists.list(p, o),
149
+ iterate: (c, p, o) => c.amazon.shopLists.iterate(p, o),
150
+ },
151
+ {
152
+ kind: "list",
153
+ platform: "amazon",
154
+ name: "shop_posts",
155
+ endpoint: "amazon.shop_posts",
156
+ summary: "Influencer storefront videos and photos with tagged products",
157
+ price: "1 credit",
158
+ params: [
159
+ { name: "handle", type: "string", required: true, description: "The influencer's storefront: its handle (sydneydelrey, the name after /shop/ in its link, any case, with or without the @) or its link on any Amazon marketplace (amazon.com/shop/sydneydelrey, or a link to one of its photos, videos or lists), or its account ID (amzn1.account.…, the id the Amazon Shop API returns) or amazon.com/gp/profile/ link. At most 2048 characters. Example: sydneydelrey" },
160
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace to read, by country: US (amazon.com), GB (amazon.co.uk), DE, CA, IN, … Amazon shows a creator's storefront on other marketplaces too. Default: the link's marketplace, else US. Example: US" },
161
+ { name: "type", type: "string", required: false, description: "Which posts: all (default: the videos, then the photos), video (the Videos tab) or photo (the Photos tab). Each comes newest first, after the ones the influencer pinned. One of: all, video, photo. Default: all. Example: video", enum: ["all", "video", "photo"] },
162
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
163
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
164
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 20. Default: 20." },
165
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
166
+ ],
167
+ list: (c, p, o) => c.amazon.shopPosts.list(p, o),
168
+ iterate: (c, p, o) => c.amazon.shopPosts.iterate(p, o),
169
+ },
170
+ {
171
+ kind: "list",
172
+ platform: "amazon",
173
+ name: "top_products",
174
+ endpoint: "amazon.top_products",
175
+ summary: "Top 100 products of any category, ranked",
176
+ price: "1 credit",
177
+ params: [
178
+ { name: "category", type: "string", required: true, description: "The category: its department's slug as Amazon's Best Sellers links write it (electronics, books, or ce-de on Amazon Germany), optionally with a browse node after a slash (electronics/12097478011), the browse node alone (12097478011), or the list's link itself (amazon.com/gp/bestsellers/electronics/12097478011, a /zgbs/ link, or a New Releases, Movers & Shakers, Most Wished For or Gift Ideas link). A product's platform_specific.amazon.best_sellers_ranks[].category_id is one of these. At most 2048 characters. Example: electronics" },
179
+ { name: "list", type: "string", required: false, description: "Which of the category's lists: best_sellers (the most sold), new_releases (the best-selling new and upcoming products), movers_and_shakers (the biggest sales rank gains in a day), most_wished_for (the most added to wish lists) or gift_ideas (the most bought as gifts). Amazon shows no products in the last three today. Default: the link's list, else best_sellers. One of: best_sellers, new_releases, movers_and_shakers, most_wished_for, gift_ideas. Example: new_releases", enum: ["best_sellers", "new_releases", "movers_and_shakers", "most_wished_for", "gift_ideas"] },
180
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The Amazon marketplace whose list to read, by country: US (amazon.com), GB (amazon.co.uk), DE, JP, IN, … Departments and their slugs are each marketplace's own. Default: the link's marketplace, else US. Example: US" },
181
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
182
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
183
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 50. Default: 50." },
184
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
185
+ ],
186
+ list: (c, p, o) => c.amazon.topProducts.list(p, o),
187
+ iterate: (c, p, o) => c.amazon.topProducts.iterate(p, o),
188
+ },
13
189
  {
14
190
  kind: "get",
15
191
  platform: "applemusic",
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.496.28";
2
+ export declare const VERSION = "1.506.29";
3
3
  /** The production API origin. */
4
4
  export declare const DEFAULT_BASE_URL = "https://socialtap.dev";
5
5
  /** Environment variable the API key is read from. */
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Code generated by engine/cmd/gensdk (make gen) from catalog/catalog.gen.json; DO NOT EDIT.
2
2
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
3
- export const VERSION = "1.496.28";
3
+ export const VERSION = "1.506.29";
4
4
  /** The production API origin. */
5
5
  export const DEFAULT_BASE_URL = "https://socialtap.dev";
6
6
  /** Environment variable the API key is read from. */