socialtap 1.485.28 → 1.496.28

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.485.28). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.496.28). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
@@ -188,6 +188,16 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
188
188
  | `linkme.profile` | `client.linkme.profile.get()` | 1 credit |
189
189
  | `linktree.profile` | `client.linktree.profile.get()` | 1 credit |
190
190
  | `pillar.page` | `client.pillar.page.get()` | 1 credit |
191
+ | `pinterest.board` | `client.pinterest.board.get()` | 1 credit |
192
+ | `pinterest.board_pins` | `client.pinterest.boardPins.list()` | 1 credit |
193
+ | `pinterest.boards` | `client.pinterest.boards.list()` | 1 credit |
194
+ | `pinterest.pin` | `client.pinterest.pin.get()` | 1 credit |
195
+ | `pinterest.pins` | `client.pinterest.pins.list()` | 1 credit |
196
+ | `pinterest.profile` | `client.pinterest.profile.get()` | 1 credit |
197
+ | `pinterest.search_pins` | `client.pinterest.searchPins.list()` | 1 credit |
198
+ | `pinterest.top_trends` | `client.pinterest.topTrends.list()` | 1 credit |
199
+ | `pinterest.topic` | `client.pinterest.topic.get()` | 1 credit |
200
+ | `pinterest.web_page` | `client.pinterest.webPage.get()` | 1 credit |
191
201
  | `reddit.comments` | `client.reddit.comments.list()` | 1 credit |
192
202
  | `reddit.engagement` | `client.reddit.engagement.get()` | 1 credit |
193
203
  | `reddit.post` | `client.reddit.post.get()` | 1 credit |
@@ -489,6 +499,7 @@ console.log(r.isError, r.output);
489
499
  | `list_community_posts` | Community posts |
490
500
  | `list_hashtag_posts` | Hashtag posts |
491
501
  | `list_place_posts` | Place posts |
502
+ | `list_playlist_posts` | Playlist posts |
492
503
  | `list_reels` | Reels of a profile |
493
504
  | `list_sound_posts` | Sound posts |
494
505
  | `list_top_posts` | Top posts |
@@ -497,7 +508,7 @@ console.log(r.isError, r.output);
497
508
  | `list_effect_posts` | Effect posts |
498
509
  | `list_liked_posts` | Liked posts of a profile |
499
510
  | `list_photos` | Photos of a profile |
500
- | `list_playlist_posts` | Playlist posts |
511
+ | `list_pins` | Pins of a profile |
501
512
  | `list_playlist_stories` | Playlist stories |
502
513
  | `list_playlist_tracks` | Playlist tracks |
503
514
  | `list_podcast_episodes` | Podcast episodes |
@@ -517,18 +528,20 @@ console.log(r.isError, r.output);
517
528
  | `list_trending_hashtags` | Trending hashtags |
518
529
  | `get_community` | Community by link |
519
530
  | `get_album` | Album by link |
531
+ | `get_playlist` | Playlist by link |
520
532
  | `get_product` | Product by link |
521
533
  | `get_sound` | Sound by link |
534
+ | `get_topic` | Topic by link |
522
535
  | `get_download` | Download by link |
523
536
  | `get_effect` | Effect by link |
524
537
  | `get_embed` | Embed by link |
525
538
  | `get_event` | Event by link |
526
539
  | `get_live` | Live by handle |
527
540
  | `get_place` | Place by link |
528
- | `get_playlist` | Playlist by link |
529
541
  | `get_podcast` | Podcast by link |
530
- | `get_topic` | Topic by link |
531
542
  | `get_username` | Username by handle |
543
+ | `get_web_page` | Web page by link |
544
+ | `list_boards` | Boards of a profile |
532
545
  | `list_events` | Events of a profile |
533
546
  | `list_highlights` | Highlights of a profile |
534
547
  | `list_place_events` | Place events |
@@ -538,6 +551,7 @@ console.log(r.isError, r.output);
538
551
  | `list_schedule` | Schedule of a profile |
539
552
  | `list_top_albums` | Top albums |
540
553
  | `list_top_playlists` | Top playlists |
554
+ | `list_top_trends` | Top trends |
541
555
  | `create_job` | Create a background job |
542
556
  | `get_job` | Get a background job |
543
557
  | `list_job_results` | List a job's results |
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, 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 { 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).
@@ -10,14 +10,15 @@ import { Webhooks } from "./webhooks.ts";
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
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, Spotify and TikTok; podcasts on Spotify; posts on
14
- * Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Reddit, Rumble, Snapchat, SoundCloud,
15
- * Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Facebook and TikTok Shop;
16
- * profiles on Apple Music, Bluesky, Facebook, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree,
17
- * Lnk.Bio, Pillar, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social,
18
- * Twitch, X and YouTube; reviews on TikTok Shop; sounds on Instagram and TikTok; suggestions on Google and
19
- * Instagram; topics on Instagram; transcripts on Facebook, Instagram, Kick, Reddit, Rumble, TikTok, Twitch and
20
- * YouTube; usernames on Instagram; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
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.
21
22
  */
22
23
  export declare class SocialTap extends Core {
23
24
  /** Apple Music endpoints. */
@@ -46,6 +47,8 @@ export declare class SocialTap extends Core {
46
47
  readonly linktree: Linktree;
47
48
  /** Pillar endpoints. */
48
49
  readonly pillar: Pillar;
50
+ /** Pinterest endpoints. */
51
+ readonly pinterest: Pinterest;
49
52
  /** Reddit endpoints. */
50
53
  readonly reddit: Reddit;
51
54
  /** Rumble 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, 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 { 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).
@@ -11,14 +11,15 @@ import { Webhooks } from "./webhooks.js";
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
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, Spotify and TikTok; podcasts on Spotify; posts on
15
- * Apple Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Reddit, Rumble, Snapchat, SoundCloud,
16
- * Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Facebook and TikTok Shop;
17
- * profiles on Apple Music, Bluesky, Facebook, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree,
18
- * Lnk.Bio, Pillar, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social,
19
- * Twitch, X and YouTube; reviews on TikTok Shop; sounds on Instagram and TikTok; suggestions on Google and
20
- * Instagram; topics on Instagram; transcripts on Facebook, Instagram, Kick, Reddit, Rumble, TikTok, Twitch and
21
- * YouTube; usernames on Instagram; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
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.
22
23
  */
23
24
  export class SocialTap extends Core {
24
25
  /** Apple Music endpoints. */
@@ -47,6 +48,8 @@ export class SocialTap extends Core {
47
48
  linktree;
48
49
  /** Pillar endpoints. */
49
50
  pillar;
51
+ /** Pinterest endpoints. */
52
+ pinterest;
50
53
  /** Reddit endpoints. */
51
54
  reddit;
52
55
  /** Rumble endpoints. */
@@ -116,6 +119,7 @@ export class SocialTap extends Core {
116
119
  this.linkme = new Linkme(this);
117
120
  this.linktree = new Linktree(this);
118
121
  this.pillar = new Pillar(this);
122
+ this.pinterest = new Pinterest(this);
119
123
  this.reddit = new Reddit(this);
120
124
  this.rumble = new Rumble(this);
121
125
  this.snapchat = new Snapchat(this);
package/dist/commands.js CHANGED
@@ -1600,6 +1600,170 @@ export const COMMANDS = [
1600
1600
  ],
1601
1601
  get: (c, p, o) => c.pillar.page.get(p, o),
1602
1602
  },
1603
+ {
1604
+ kind: "get",
1605
+ platform: "pinterest",
1606
+ name: "board",
1607
+ endpoint: "pinterest.board",
1608
+ summary: "Board with exact pins, followers and collaborators",
1609
+ price: "1 credit",
1610
+ params: [
1611
+ { name: "url", type: "string", required: true, description: "The board: its link (pinterest.com/<username>/<board>/, also on a country's site such as uk.pinterest.com or pinterest.co.uk), a link to one of its sections (pinterest.com/ikeausa/living-rooms/sofas-armchairs/), a short link (pin.it/<code>) or its ID. At most 2048 characters. Example: https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/" },
1612
+ { 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." },
1613
+ { 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." },
1614
+ ],
1615
+ get: (c, p, o) => c.pinterest.board.get(p, o),
1616
+ },
1617
+ {
1618
+ kind: "list",
1619
+ platform: "pinterest",
1620
+ name: "board_pins",
1621
+ endpoint: "pinterest.board_pins",
1622
+ summary: "Pins saved to a board, page by page",
1623
+ price: "1 credit",
1624
+ params: [
1625
+ { name: "url", type: "string", required: true, description: "The board: its link (pinterest.com/<username>/<board>/, also on a country's site such as uk.pinterest.com or pinterest.co.uk), a section's link (pinterest.com/<username>/<board>/<section_name>/) for that section's pins, a short link (pin.it/<code>) or the board's ID. At most 2048 characters. Example: https://www.pinterest.com/pinterest/easy-and-chic-holiday-nail-ideas/" },
1626
+ { 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." },
1627
+ { 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." },
1628
+ { 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." },
1629
+ { 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." },
1630
+ ],
1631
+ list: (c, p, o) => c.pinterest.boardPins.list(p, o),
1632
+ iterate: (c, p, o) => c.pinterest.boardPins.iterate(p, o),
1633
+ },
1634
+ {
1635
+ kind: "list",
1636
+ platform: "pinterest",
1637
+ name: "boards",
1638
+ endpoint: "pinterest.boards",
1639
+ summary: "Account's boards with pin counts, covers and links",
1640
+ price: "1 credit",
1641
+ params: [
1642
+ { name: "handle", type: "string", required: true, description: "The Pinterest account: its username (any case, with or without the @), its profile link (pinterest.com/pinterest/, any tab of it, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its numeric account ID. At most 2048 characters. Example: pinterest" },
1643
+ { 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." },
1644
+ { 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." },
1645
+ { 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." },
1646
+ { 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." },
1647
+ ],
1648
+ list: (c, p, o) => c.pinterest.boards.list(p, o),
1649
+ iterate: (c, p, o) => c.pinterest.boards.iterate(p, o),
1650
+ },
1651
+ {
1652
+ kind: "get",
1653
+ platform: "pinterest",
1654
+ name: "pin",
1655
+ endpoint: "pinterest.pin",
1656
+ summary: "Pin with saves, reactions, media and its link",
1657
+ price: "1 credit",
1658
+ params: [
1659
+ { name: "url", type: "string", required: true, description: "The pin: its link (pinterest.com/pin/424605071146283650/, also on a country's site such as uk.pinterest.com or pinterest.co.uk, its pinterest.com/pin/<words>--<id>/ link, its AMP page), a short link (pin.it/<code>) or its ID. At most 2048 characters. Example: https://www.pinterest.com/pin/424605071146283650/" },
1660
+ { 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." },
1661
+ { 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." },
1662
+ ],
1663
+ get: (c, p, o) => c.pinterest.pin.get(p, o),
1664
+ },
1665
+ {
1666
+ kind: "list",
1667
+ platform: "pinterest",
1668
+ name: "pins",
1669
+ endpoint: "pinterest.pins",
1670
+ summary: "Every pin an account saved or created, page by page",
1671
+ price: "1 credit",
1672
+ params: [
1673
+ { name: "handle", type: "string", required: true, description: "The Pinterest account: its username (any case, with or without the @), its profile link (pinterest.com/<username>/, any of its tabs such as /_created/ or /_pins/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its numeric ID. At most 2048 characters. Example: pinterest" },
1674
+ { 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. A saved pin counts from when the account saved it. On tab=saved it only filters each page, as Pinterest can list a pin out of order there; on tab=created paging stops once it is reached. Example: 2026-10-01" },
1675
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
1676
+ { name: "tab", type: "string", required: false, description: "Which pins: saved (default), every pin the account saved, its own and the ones it saved from others, as its profile's Pins tab lists them; created, the pins it made itself (its Created tab). A link to the account's /_created/ tab sent without tab lists created. One of: saved, created. Example: created", enum: ["saved", "created"] },
1677
+ { 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." },
1678
+ { 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." },
1679
+ { 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 25. Default: 25." },
1680
+ { 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." },
1681
+ ],
1682
+ list: (c, p, o) => c.pinterest.pins.list(p, o),
1683
+ iterate: (c, p, o) => c.pinterest.pins.iterate(p, o),
1684
+ },
1685
+ {
1686
+ kind: "get",
1687
+ platform: "pinterest",
1688
+ name: "profile",
1689
+ endpoint: "pinterest.profile",
1690
+ summary: "Exact followers, pins, boards and monthly views",
1691
+ price: "1 credit",
1692
+ params: [
1693
+ { name: "handle", type: "string", required: true, description: "The Pinterest account: its username (any case, with or without the @), its profile link (pinterest.com/<username>/, any of its tabs such as /_created/ or /_saved/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its numeric ID. At most 2048 characters. Example: pinterest" },
1694
+ { 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." },
1695
+ { 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." },
1696
+ ],
1697
+ get: (c, p, o) => c.pinterest.profile.get(p, o),
1698
+ },
1699
+ {
1700
+ kind: "list",
1701
+ platform: "pinterest",
1702
+ name: "search_pins",
1703
+ endpoint: "pinterest.search_pins",
1704
+ summary: "Pins matching a keyword, with pictures and pinners",
1705
+ price: "1 credit",
1706
+ params: [
1707
+ { name: "query", type: "string", required: true, description: "What to search for, in any language, as you would type it in Pinterest's search box: words, a phrase, emoji. A Pinterest search link (pinterest.com/search/pins/?q=…) is read as its words. At most 500 characters. Example: nail art" },
1708
+ { 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." },
1709
+ { 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." },
1710
+ { 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 25. Default: 25." },
1711
+ { 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." },
1712
+ ],
1713
+ list: (c, p, o) => c.pinterest.searchPins.list(p, o),
1714
+ iterate: (c, p, o) => c.pinterest.searchPins.iterate(p, o),
1715
+ },
1716
+ {
1717
+ kind: "list",
1718
+ platform: "pinterest",
1719
+ name: "top_trends",
1720
+ endpoint: "pinterest.top_trends",
1721
+ summary: "Top, rising and seasonal searches by country",
1722
+ price: "1 credit",
1723
+ params: [
1724
+ { name: "country", type: "string", required: false, description: "Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive). The country whose searches to rank: US, CA, GB, DE, FR, IT, ES, MX, AR, CO, BR, ID, IN, MY, PH, TH, SA, EG, TR or KR, each with a board of its own; or IE, AT, CH, PT, GR, MT, SE, DK, FI, NO, NL, BE, LU, PL, RO, HU, SK, CZ, CL, AU, NZ, CR, DO, EC, GT, PE or CY, which Pinterest counts together with their neighbors: those read the shared board, and market_country_codes names its countries. Default: US. Example: US" },
1725
+ { name: "kind", type: "string", required: false, description: "Which board: top_monthly (the default: the most searched terms this month), top_yearly (this year), growing (the terms whose searches rose most this month) or seasonal (terms searched at this time every year, now rising). One of: top_monthly, top_yearly, growing, seasonal. Default: top_monthly. Example: growing", enum: ["top_monthly", "top_yearly", "growing", "seasonal"] },
1726
+ { name: "category", type: "string", required: false, description: "Only terms Pinterest files under this interest, and each term's categories filled in. Omit for every interest. One of: womens_fashion, mens_fashion, childrens_fashion, beauty, health, design, wedding, travel, gardening, finance, vehicles, architecture, food_and_drinks, sport, parenting, education, animals, diy_and_crafts, home_decor, event_planning, quotes, entertainment, electronics, art. Example: beauty", enum: ["womens_fashion", "mens_fashion", "childrens_fashion", "beauty", "health", "design", "wedding", "travel", "gardening", "finance", "vehicles", "architecture", "food_and_drinks", "sport", "parenting", "education", "animals", "diy_and_crafts", "home_decor", "event_planning", "quotes", "entertainment", "electronics", "art"] },
1727
+ { name: "age", type: "string", required: false, description: "Rank by the searches of people of this age only. One of: 18-24, 25-34, 35-44, 45-49, 50-54, 55-64, 65-plus. Example: 25-34", enum: ["18-24", "25-34", "35-44", "45-49", "50-54", "55-64", "65-plus"] },
1728
+ { name: "gender", type: "string", required: false, description: "Rank by the searches of people of this gender only (unspecified: those who gave none). One of: female, male, unspecified. Example: female", enum: ["female", "male", "unspecified"] },
1729
+ { name: "contains", type: "string", required: false, description: "Only terms containing one of these keywords, comma-separated (at most ten). Example: nails" },
1730
+ { name: "excludes", type: "string", required: false, description: "Leave out terms containing any of these keywords, comma-separated (at most ten). Example: halloween" },
1731
+ { 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." },
1732
+ { 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." },
1733
+ { 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." },
1734
+ { 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." },
1735
+ ],
1736
+ list: (c, p, o) => c.pinterest.topTrends.list(p, o),
1737
+ iterate: (c, p, o) => c.pinterest.topTrends.iterate(p, o),
1738
+ },
1739
+ {
1740
+ kind: "get",
1741
+ platform: "pinterest",
1742
+ name: "topic",
1743
+ endpoint: "pinterest.topic",
1744
+ summary: "Ideas page with related topics and search count",
1745
+ price: "1 credit",
1746
+ params: [
1747
+ { name: "url", type: "string", required: true, description: "The topic: its ideas page link (pinterest.com/ideas/star-nail-designs/961385779129/, also on a country's site such as uk.pinterest.com or pinterest.co.uk) or its words (star nail designs). Words are matched as Pinterest matches them: case and hyphens are ignored. At most 2048 characters. Example: https://www.pinterest.com/ideas/star-nail-designs/961385779129/" },
1748
+ { 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." },
1749
+ { 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." },
1750
+ ],
1751
+ get: (c, p, o) => c.pinterest.topic.get(p, o),
1752
+ },
1753
+ {
1754
+ kind: "get",
1755
+ platform: "pinterest",
1756
+ name: "web_page",
1757
+ endpoint: "pinterest.web_page",
1758
+ summary: "Exact Pinterest saves of any web page's link",
1759
+ price: "1 credit",
1760
+ params: [
1761
+ { name: "url", type: "string", required: true, description: "Any web page's link, exactly as people save it: an article, a recipe, a product page, another platform's video. Pinterest counts the exact string, so http and https, a trailing slash, a query string or a #fragment each count apart. At most 2048 characters. Example: https://www.allrecipes.com/recipe/10813/best-chocolate-chip-cookies/" },
1762
+ { 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." },
1763
+ { 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." },
1764
+ ],
1765
+ get: (c, p, o) => c.pinterest.webPage.get(p, o),
1766
+ },
1603
1767
  {
1604
1768
  kind: "list",
1605
1769
  platform: "reddit",
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.485.28";
2
+ export declare const VERSION = "1.496.28";
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.485.28";
3
+ export const VERSION = "1.496.28";
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. */