socialtap 1.575.31 → 1.576.31

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.575.31). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.576.31). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
@@ -125,6 +125,7 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
125
125
  | `facebook.ad` | `client.facebook.ad.get()` | 1 credit |
126
126
  | `facebook.ad_transcript` | `client.facebook.adTranscript.get()` | 2 credits + 2 per started minute of media |
127
127
  | `facebook.ads` | `client.facebook.ads.list()` | 1 credit |
128
+ | `facebook.advertiser` | `client.facebook.advertiser.get()` | 1 credit |
128
129
  | `facebook.comments` | `client.facebook.comments.list()` | 1 credit |
129
130
  | `facebook.engagement` | `client.facebook.engagement.get()` | 1 credit |
130
131
  | `facebook.event` | `client.facebook.event.get()` | 1 credit |
@@ -195,6 +196,7 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
195
196
  | `instagram.place` | `client.instagram.place.get()` | 1 credit |
196
197
  | `instagram.place_posts` | `client.instagram.placePosts.list()` | 1 credit |
197
198
  | `instagram.playlist_stories` | `client.instagram.playlistStories.list()` | 1 credit |
199
+ | `instagram.popular_trends` | `client.instagram.popularTrends.list()` | 1 credit |
198
200
  | `instagram.post` | `client.instagram.post.get()` | 1 credit |
199
201
  | `instagram.posts` | `client.instagram.posts.list()` | 1 credit |
200
202
  | `instagram.profile` | `client.instagram.profile.get()` | 1 credit |
@@ -589,6 +591,7 @@ console.log(r.isError, r.output);
589
591
  | `list_user_favorites` | User favorites of a profile |
590
592
  | `list_user_stories` | User stories of a profile |
591
593
  | `list_videos` | Videos of a profile |
594
+ | `get_advertiser` | Advertiser by handle |
592
595
  | `get_seller` | Seller by handle |
593
596
  | `get_shop` | Shop by handle |
594
597
  | `list_following` | Following of a profile |
@@ -644,6 +647,7 @@ console.log(r.isError, r.output);
644
647
  | `list_pinned_repositories` | Pinned repositories of a profile |
645
648
  | `list_place_events` | Place events |
646
649
  | `list_playlists` | Playlists of a profile |
650
+ | `list_popular_trends` | Popular trends |
647
651
  | `list_products` | Products of a profile |
648
652
  | `list_profile_groups` | Profile groups |
649
653
  | `list_profile_pull_requests` | Profile pull requests |
package/dist/client.d.ts CHANGED
@@ -21,8 +21,8 @@ import { Webhooks } from "./webhooks.ts";
21
21
  * on GitHub; relationships on X; releases on GitHub; repositories on GitHub; reviews on Amazon and TikTok Shop;
22
22
  * sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on Instagram and
23
23
  * Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch, X and YouTube;
24
- * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
25
- * LinkedIn, Telegram, TikTok and X.
24
+ * trends on Instagram and Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook,
25
+ * Instagram, LinkedIn, Telegram, TikTok and X.
26
26
  */
27
27
  export declare class SocialTap extends Core {
28
28
  /** Amazon endpoints. */
package/dist/client.js CHANGED
@@ -22,8 +22,8 @@ import { Webhooks } from "./webhooks.js";
22
22
  * on GitHub; relationships on X; releases on GitHub; repositories on GitHub; reviews on Amazon and TikTok Shop;
23
23
  * sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on Instagram and
24
24
  * Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch, X and YouTube;
25
- * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
26
- * LinkedIn, Telegram, TikTok and X.
25
+ * trends on Instagram and Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook,
26
+ * Instagram, LinkedIn, Telegram, TikTok and X.
27
27
  */
28
28
  export class SocialTap extends Core {
29
29
  /** Amazon endpoints. */
package/dist/commands.js CHANGED
@@ -518,6 +518,20 @@ export const COMMANDS = [
518
518
  list: (c, p, o) => c.facebook.ads.list(p, o),
519
519
  iterate: (c, p, o) => c.facebook.ads.iterate(p, o),
520
520
  },
521
+ {
522
+ kind: "get",
523
+ platform: "facebook",
524
+ name: "advertiser",
525
+ endpoint: "facebook.advertiser",
526
+ summary: "Advertiser profile and linked Instagram",
527
+ price: "1 credit",
528
+ params: [
529
+ { name: "handle", type: "string", required: true, description: "The advertiser: its Ad Library link (facebook.com/ads/library/?view_all_page_id=…), its Facebook Page's link or name, or its Page ID. At most 2048 characters. Example: https://www.facebook.com/ads/library/?view_all_page_id=54971236771&search_type=page" },
530
+ { 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." },
531
+ { 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." },
532
+ ],
533
+ get: (c, p, o) => c.facebook.advertiser.get(p, o),
534
+ },
521
535
  {
522
536
  kind: "list",
523
537
  platform: "facebook",
@@ -1787,6 +1801,23 @@ export const COMMANDS = [
1787
1801
  list: (c, p, o) => c.instagram.playlistStories.list(p, o),
1788
1802
  iterate: (c, p, o) => c.instagram.playlistStories.iterate(p, o),
1789
1803
  },
1804
+ {
1805
+ kind: "list",
1806
+ platform: "instagram",
1807
+ name: "popular_trends",
1808
+ endpoint: "instagram.popular_trends",
1809
+ summary: "Promoted searches with exact post counts",
1810
+ price: "1 credit",
1811
+ params: [
1812
+ { name: "section", type: "string", required: false, description: "Only the terms of one section of Instagram's popular page: trending_now (Trending now), entertainment (Pop culture moments), get_inspired (Get inspired), learn_something_new (Learn something new), shop_the_trends (Shop the trends), trending_month (What's happening now) or browse_categories (Find what you're into). Every section, in the page's order, when omitted. One of: trending_now, entertainment, get_inspired, learn_something_new, shop_the_trends, trending_month, browse_categories. Example: trending_now", enum: ["trending_now", "entertainment", "get_inspired", "learn_something_new", "shop_the_trends", "trending_month", "browse_categories"] },
1813
+ { 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." },
1814
+ { 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." },
1815
+ { 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." },
1816
+ { 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." },
1817
+ ],
1818
+ list: (c, p, o) => c.instagram.popularTrends.list(p, o),
1819
+ iterate: (c, p, o) => c.instagram.popularTrends.iterate(p, o),
1820
+ },
1790
1821
  {
1791
1822
  kind: "get",
1792
1823
  platform: "instagram",
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.575.31";
2
+ export declare const VERSION = "1.576.31";
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.575.31";
3
+ export const VERSION = "1.576.31";
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. */
package/dist/models.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { AmazonDealProductsParams, AmazonOffersParams, AmazonProductParams, AmazonReviewsParams, AmazonSearchProductsParams, AmazonSellerParams, AmazonShopParams, AmazonShopListsParams, AmazonShopPostsParams, AmazonTopProductsParams, AppleMusicAlbumParams, AppleMusicArtistParams, AppleMusicSearchAlbumsParams, AppleMusicSearchArtistsParams, AppleMusicSearchPlaylistsParams, AppleMusicSearchTracksParams, AppleMusicTopAlbumsParams, AppleMusicTopPlaylistsParams, AppleMusicTopTracksParams, AppleMusicTrackParams, BlueskyCommentsParams, BlueskyPostParams, BlueskyPostsParams, BlueskyProfileParams, BlueskySearchPostsParams, FacebookAdParams, FacebookAdTranscriptParams, FacebookAdsParams, FacebookCommentsParams, FacebookEngagementParams, FacebookEventParams, FacebookEventsParams, FacebookGroupParams, FacebookGroupPostsParams, FacebookListingParams, FacebookPhotosParams, FacebookPlaceEventsParams, FacebookPostParams, FacebookPostsParams, FacebookProfileParams, FacebookReelsParams, FacebookRepliesParams, FacebookSearchAdsParams, FacebookSearchAdvertisersParams, FacebookSearchEventsParams, FacebookSearchGroupsParams, FacebookSearchListingsParams, FacebookSearchPlacesParams, FacebookSearchPostsParams, FacebookSearchProfilesParams, FacebookTranscriptParams, GitHubActivityParams, GitHubContributionsParams, GitHubFollowersParams, GitHubFollowingParams, GitHubIssueParams, GitHubIssueCommentsParams, GitHubIssuesParams, GitHubPinnedRepositoriesParams, GitHubProfileParams, GitHubProfilePullRequestsParams, GitHubReadmeParams, GitHubReleasesParams, GitHubRepositoriesParams, GitHubRepositoryParams, GitHubRepositoryContributorsParams, GitHubSearchIssuesParams, GitHubSearchProfilesParams, GitHubSearchRepositoriesParams, GitHubTrendingProfilesParams, GitHubTrendingRepositoriesParams, GoogleAdParams, GoogleAdsParams, GoogleAdvertiserParams, GoogleSearchAdsParams, GoogleSearchAdvertisersParams, GoogleSearchSuggestionsParams, HackerNewsCommentParams, HackerNewsCommentsParams, HackerNewsFeedStoriesParams, HackerNewsSearchCommentsParams, HackerNewsSearchStoriesParams, HackerNewsStoryParams, HackerNewsUserParams, HackerNewsUserCommentsParams, HackerNewsUserFavoritesParams, HackerNewsUserStoriesParams, HackerNewsWhoishiringJobsParams, InstagramCommentParams, InstagramCommentsParams, InstagramEmbedParams, InstagramEngagementParams, InstagramHashtagParams, InstagramHashtagPostsParams, InstagramHighlightsParams, InstagramPlaceParams, InstagramPlacePostsParams, InstagramPlaylistStoriesParams, InstagramPostParams, InstagramPostsParams, InstagramProfileParams, InstagramReelsParams, InstagramSearchHashtagsParams, InstagramSearchPlacesParams, InstagramSearchPostsParams, InstagramSearchProfilesParams, InstagramSearchSoundsParams, InstagramSearchSuggestionsParams, InstagramSimilarProfilesParams, InstagramSoundParams, InstagramSoundPostsParams, InstagramStoryParams, InstagramTopicParams, InstagramTranscriptParams, InstagramTrendingPostsParams, InstagramUsernameParams, KickPostParams, KickTranscriptParams, KomiPageParams, KwaiPostParams, KwaiPostsParams, KwaiProfileParams, LnkBioProfileParams, LinkedInAdParams, LinkedInCommentsParams, LinkedInEmployeesParams, LinkedInEngagementParams, LinkedInFollowingParams, LinkedInJobParams, LinkedInJobRelatedJobsParams, LinkedInJobsParams, LinkedInLikedPostsParams, LinkedInPostParams, LinkedInPostReactionsParams, LinkedInPostRepostsParams, LinkedInPostsParams, LinkedInProfileParams, LinkedInProfileCommentsParams, LinkedInProfileGroupsParams, LinkedInSearchAdsParams, LinkedInSearchJobsParams, LinkedInSearchPostsParams, LinkedInSearchProfilesParams, LinkedInTranscriptParams, LinkmeProfileParams, LinktreeProfileParams, PillarPageParams, PinterestBoardParams, PinterestBoardPinsParams, PinterestBoardsParams, PinterestPinParams, PinterestPinsParams, PinterestProfileParams, PinterestSearchPinsParams, PinterestTopTrendsParams, PinterestTopicParams, PinterestWebPageParams, RedditCommentsParams, RedditEngagementParams, RedditPostParams, RedditPostsParams, RedditProfileParams, RedditProfileCommentsParams, RedditSearchCommentsParams, RedditSearchPostsParams, RedditSearchProfilesParams, RedditSearchSubredditsParams, RedditSubredditParams, RedditSubredditPostsParams, RedditTranscriptParams, RumbleCommentsParams, RumbleEngagementParams, RumblePostParams, RumblePostsParams, RumbleProfileParams, RumbleSearchPostsParams, RumbleTranscriptParams, SnapchatCommentsParams, SnapchatProfileParams, SnapchatSpotlightParams, SoundCloudArtistParams, SoundCloudTrackParams, SoundCloudTracksParams, SpotifyAlbumParams, SpotifyArtistParams, SpotifyPlaylistParams, SpotifyPlaylistTracksParams, SpotifyPodcastParams, SpotifyPodcastEpisodesParams, SpotifySearchAlbumsParams, SpotifySearchArtistsParams, SpotifySearchPlaylistsParams, SpotifySearchPodcastsParams, SpotifySearchTracksParams, SpotifyTrackParams, TelegramChannelParams, TelegramChannelPostsParams, TelegramPostParams, TelegramSearchChannelsParams, ThreadsCommentsParams, ThreadsPostParams, ThreadsPostsParams, ThreadsProfileParams, ThreadsSearchPostsParams, ThreadsSearchProfilesParams, TikTokAdParams, TikTokCommentParams, TikTokCommentsParams, TikTokDownloadParams, TikTokEffectParams, TikTokEffectPostsParams, TikTokEngagementParams, TikTokFollowersParams, TikTokFollowingParams, TikTokHashtagParams, TikTokHashtagPostsParams, TikTokLikedPostsParams, TikTokLiveParams, TikTokPlacePostsParams, TikTokPlaylistPostsParams, TikTokPlaylistsParams, TikTokPostParams, TikTokPostsParams, TikTokProfileParams, TikTokRepliesParams, TikTokSearchAdsParams, TikTokSearchHashtagsParams, TikTokSearchPostsParams, TikTokSearchProfilesParams, TikTokSearchSoundsParams, TikTokSearchSuggestionsParams, TikTokSearchTopParams, TikTokSoundParams, TikTokSoundPostsParams, TikTokTopAdsParams, TikTokTopPostsParams, TikTokTranscriptParams, TikTokTrendingHashtagsParams, TikTokTrendingPostsParams, TikTokShopProductParams, TikTokShopProductsParams, TikTokShopReviewsParams, TikTokShopSearchProductsParams, TruthSocialPostParams, TruthSocialPostsParams, TruthSocialProfileParams, TwitchProfileParams, TwitchScheduleParams, TwitchTranscriptParams, TwitchVideoParams, TwitchVideosParams, XCommentsParams, XCommunityParams, XCommunityPostsParams, XEngagementParams, XFriendshipParams, XListParams, XListFollowersParams, XPostParams, XPostsParams, XProfileParams, XProfileMentionsParams, XSearchCommunitiesParams, XSearchHashtagsParams, XSearchPostsParams, XSearchProfilesParams, XSpaceParams, XTranscriptParams, YouTubeCommentsParams, YouTubeEngagementParams, YouTubePostParams, YouTubePostsParams, YouTubeProfileParams, YouTubeTranscriptParams } from "./resources.ts";
1
+ import type { AmazonDealProductsParams, AmazonOffersParams, AmazonProductParams, AmazonReviewsParams, AmazonSearchProductsParams, AmazonSellerParams, AmazonShopParams, AmazonShopListsParams, AmazonShopPostsParams, AmazonTopProductsParams, AppleMusicAlbumParams, AppleMusicArtistParams, AppleMusicSearchAlbumsParams, AppleMusicSearchArtistsParams, AppleMusicSearchPlaylistsParams, AppleMusicSearchTracksParams, AppleMusicTopAlbumsParams, AppleMusicTopPlaylistsParams, AppleMusicTopTracksParams, AppleMusicTrackParams, BlueskyCommentsParams, BlueskyPostParams, BlueskyPostsParams, BlueskyProfileParams, BlueskySearchPostsParams, FacebookAdParams, FacebookAdTranscriptParams, FacebookAdsParams, FacebookAdvertiserParams, FacebookCommentsParams, FacebookEngagementParams, FacebookEventParams, FacebookEventsParams, FacebookGroupParams, FacebookGroupPostsParams, FacebookListingParams, FacebookPhotosParams, FacebookPlaceEventsParams, FacebookPostParams, FacebookPostsParams, FacebookProfileParams, FacebookReelsParams, FacebookRepliesParams, FacebookSearchAdsParams, FacebookSearchAdvertisersParams, FacebookSearchEventsParams, FacebookSearchGroupsParams, FacebookSearchListingsParams, FacebookSearchPlacesParams, FacebookSearchPostsParams, FacebookSearchProfilesParams, FacebookTranscriptParams, GitHubActivityParams, GitHubContributionsParams, GitHubFollowersParams, GitHubFollowingParams, GitHubIssueParams, GitHubIssueCommentsParams, GitHubIssuesParams, GitHubPinnedRepositoriesParams, GitHubProfileParams, GitHubProfilePullRequestsParams, GitHubReadmeParams, GitHubReleasesParams, GitHubRepositoriesParams, GitHubRepositoryParams, GitHubRepositoryContributorsParams, GitHubSearchIssuesParams, GitHubSearchProfilesParams, GitHubSearchRepositoriesParams, GitHubTrendingProfilesParams, GitHubTrendingRepositoriesParams, GoogleAdParams, GoogleAdsParams, GoogleAdvertiserParams, GoogleSearchAdsParams, GoogleSearchAdvertisersParams, GoogleSearchSuggestionsParams, HackerNewsCommentParams, HackerNewsCommentsParams, HackerNewsFeedStoriesParams, HackerNewsSearchCommentsParams, HackerNewsSearchStoriesParams, HackerNewsStoryParams, HackerNewsUserParams, HackerNewsUserCommentsParams, HackerNewsUserFavoritesParams, HackerNewsUserStoriesParams, HackerNewsWhoishiringJobsParams, InstagramCommentParams, InstagramCommentsParams, InstagramEmbedParams, InstagramEngagementParams, InstagramHashtagParams, InstagramHashtagPostsParams, InstagramHighlightsParams, InstagramPlaceParams, InstagramPlacePostsParams, InstagramPlaylistStoriesParams, InstagramPopularTrendsParams, InstagramPostParams, InstagramPostsParams, InstagramProfileParams, InstagramReelsParams, InstagramSearchHashtagsParams, InstagramSearchPlacesParams, InstagramSearchPostsParams, InstagramSearchProfilesParams, InstagramSearchSoundsParams, InstagramSearchSuggestionsParams, InstagramSimilarProfilesParams, InstagramSoundParams, InstagramSoundPostsParams, InstagramStoryParams, InstagramTopicParams, InstagramTranscriptParams, InstagramTrendingPostsParams, InstagramUsernameParams, KickPostParams, KickTranscriptParams, KomiPageParams, KwaiPostParams, KwaiPostsParams, KwaiProfileParams, LnkBioProfileParams, LinkedInAdParams, LinkedInCommentsParams, LinkedInEmployeesParams, LinkedInEngagementParams, LinkedInFollowingParams, LinkedInJobParams, LinkedInJobRelatedJobsParams, LinkedInJobsParams, LinkedInLikedPostsParams, LinkedInPostParams, LinkedInPostReactionsParams, LinkedInPostRepostsParams, LinkedInPostsParams, LinkedInProfileParams, LinkedInProfileCommentsParams, LinkedInProfileGroupsParams, LinkedInSearchAdsParams, LinkedInSearchJobsParams, LinkedInSearchPostsParams, LinkedInSearchProfilesParams, LinkedInTranscriptParams, LinkmeProfileParams, LinktreeProfileParams, PillarPageParams, PinterestBoardParams, PinterestBoardPinsParams, PinterestBoardsParams, PinterestPinParams, PinterestPinsParams, PinterestProfileParams, PinterestSearchPinsParams, PinterestTopTrendsParams, PinterestTopicParams, PinterestWebPageParams, RedditCommentsParams, RedditEngagementParams, RedditPostParams, RedditPostsParams, RedditProfileParams, RedditProfileCommentsParams, RedditSearchCommentsParams, RedditSearchPostsParams, RedditSearchProfilesParams, RedditSearchSubredditsParams, RedditSubredditParams, RedditSubredditPostsParams, RedditTranscriptParams, RumbleCommentsParams, RumbleEngagementParams, RumblePostParams, RumblePostsParams, RumbleProfileParams, RumbleSearchPostsParams, RumbleTranscriptParams, SnapchatCommentsParams, SnapchatProfileParams, SnapchatSpotlightParams, SoundCloudArtistParams, SoundCloudTrackParams, SoundCloudTracksParams, SpotifyAlbumParams, SpotifyArtistParams, SpotifyPlaylistParams, SpotifyPlaylistTracksParams, SpotifyPodcastParams, SpotifyPodcastEpisodesParams, SpotifySearchAlbumsParams, SpotifySearchArtistsParams, SpotifySearchPlaylistsParams, SpotifySearchPodcastsParams, SpotifySearchTracksParams, SpotifyTrackParams, TelegramChannelParams, TelegramChannelPostsParams, TelegramPostParams, TelegramSearchChannelsParams, ThreadsCommentsParams, ThreadsPostParams, ThreadsPostsParams, ThreadsProfileParams, ThreadsSearchPostsParams, ThreadsSearchProfilesParams, TikTokAdParams, TikTokCommentParams, TikTokCommentsParams, TikTokDownloadParams, TikTokEffectParams, TikTokEffectPostsParams, TikTokEngagementParams, TikTokFollowersParams, TikTokFollowingParams, TikTokHashtagParams, TikTokHashtagPostsParams, TikTokLikedPostsParams, TikTokLiveParams, TikTokPlacePostsParams, TikTokPlaylistPostsParams, TikTokPlaylistsParams, TikTokPostParams, TikTokPostsParams, TikTokProfileParams, TikTokRepliesParams, TikTokSearchAdsParams, TikTokSearchHashtagsParams, TikTokSearchPostsParams, TikTokSearchProfilesParams, TikTokSearchSoundsParams, TikTokSearchSuggestionsParams, TikTokSearchTopParams, TikTokSoundParams, TikTokSoundPostsParams, TikTokTopAdsParams, TikTokTopPostsParams, TikTokTranscriptParams, TikTokTrendingHashtagsParams, TikTokTrendingPostsParams, TikTokShopProductParams, TikTokShopProductsParams, TikTokShopReviewsParams, TikTokShopSearchProductsParams, TruthSocialPostParams, TruthSocialPostsParams, TruthSocialProfileParams, TwitchProfileParams, TwitchScheduleParams, TwitchTranscriptParams, TwitchVideoParams, TwitchVideosParams, XCommentsParams, XCommunityParams, XCommunityPostsParams, XEngagementParams, XFriendshipParams, XListParams, XListFollowersParams, XPostParams, XPostsParams, XProfileParams, XProfileMentionsParams, XSearchCommunitiesParams, XSearchHashtagsParams, XSearchPostsParams, XSearchProfilesParams, XSpaceParams, XTranscriptParams, YouTubeCommentsParams, YouTubeEngagementParams, YouTubePostParams, YouTubePostsParams, YouTubeProfileParams, YouTubeTranscriptParams } from "./resources.ts";
2
2
  export interface ProfileRef {
3
3
  /** Platform-native account ID; null when only the handle is known. */
4
4
  id: string | null;
@@ -8435,11 +8435,37 @@ export interface PinterestTrendSpecific {
8435
8435
  */
8436
8436
  history: TrendPoint[];
8437
8437
  }
8438
+ export interface InstagramTrendMetrics {
8439
+ /** Posts Instagram counts under the term, exact; null when it shows none (its browse categories). */
8440
+ post_count: number | null;
8441
+ }
8442
+ export interface InstagramTrendSpecific {
8443
+ /**
8444
+ * The section of Instagram's popular page the term sits on, as Instagram names it internally, in lower case:
8445
+ * trending_now, entertainment, get_inspired, learn_something_new, shop_the_trends, trending_month or
8446
+ * browse_categories (new ones may appear). rank counts within it.
8447
+ */
8448
+ section: string | null;
8449
+ /**
8450
+ * The section's title as Instagram shows it (Trending now, Pop culture moments, Find what you're into):
8451
+ * Instagram's copy, which it may reword, so group or filter by section instead.
8452
+ */
8453
+ section_title: string | null;
8454
+ /**
8455
+ * The reel Instagram features for the term on its popular page; null when it features none (its browse
8456
+ * categories). Format: uri.
8457
+ */
8458
+ featured_post_url: string | null;
8459
+ /** Instagram's counts for the term; null = not shown. */
8460
+ metrics: InstagramTrendMetrics;
8461
+ }
8438
8462
  export interface TrendPlatformSpecific {
8439
8463
  /** A Google Trends trend's own fields. */
8440
8464
  google?: GoogleTrendSpecific | null;
8441
8465
  /** A Pinterest Trends trend's own fields. */
8442
8466
  pinterest?: PinterestTrendSpecific | null;
8467
+ /** An Instagram trend's own fields. */
8468
+ instagram?: InstagramTrendSpecific | null;
8443
8469
  }
8444
8470
  /**
8445
8471
  * What is trending on a platform: the searches or topics rising there, in the platform's rank order, with how
@@ -10166,7 +10192,7 @@ export interface JobRequestFor<E extends string, P> {
10166
10192
  max_pages?: number | null;
10167
10193
  }
10168
10194
  /** A job item: one member per endpoint, so `params` are checked against the endpoint `endpoint` names. */
10169
- export type JobRequest = JobRequestFor<"amazon.deal_products", AmazonDealProductsParams> | JobRequestFor<"amazon.offers", AmazonOffersParams> | JobRequestFor<"amazon.product", AmazonProductParams> | JobRequestFor<"amazon.reviews", AmazonReviewsParams> | JobRequestFor<"amazon.search_products", AmazonSearchProductsParams> | JobRequestFor<"amazon.seller", AmazonSellerParams> | JobRequestFor<"amazon.shop", AmazonShopParams> | JobRequestFor<"amazon.shop_lists", AmazonShopListsParams> | JobRequestFor<"amazon.shop_posts", AmazonShopPostsParams> | JobRequestFor<"amazon.top_products", AmazonTopProductsParams> | JobRequestFor<"applemusic.album", AppleMusicAlbumParams> | JobRequestFor<"applemusic.artist", AppleMusicArtistParams> | JobRequestFor<"applemusic.search_albums", AppleMusicSearchAlbumsParams> | JobRequestFor<"applemusic.search_artists", AppleMusicSearchArtistsParams> | JobRequestFor<"applemusic.search_playlists", AppleMusicSearchPlaylistsParams> | JobRequestFor<"applemusic.search_tracks", AppleMusicSearchTracksParams> | JobRequestFor<"applemusic.top_albums", AppleMusicTopAlbumsParams> | JobRequestFor<"applemusic.top_playlists", AppleMusicTopPlaylistsParams> | JobRequestFor<"applemusic.top_tracks", AppleMusicTopTracksParams> | JobRequestFor<"applemusic.track", AppleMusicTrackParams> | JobRequestFor<"bluesky.comments", BlueskyCommentsParams> | JobRequestFor<"bluesky.post", BlueskyPostParams> | JobRequestFor<"bluesky.posts", BlueskyPostsParams> | JobRequestFor<"bluesky.profile", BlueskyProfileParams> | JobRequestFor<"bluesky.search_posts", BlueskySearchPostsParams> | JobRequestFor<"facebook.ad", FacebookAdParams> | JobRequestFor<"facebook.ad_transcript", FacebookAdTranscriptParams> | JobRequestFor<"facebook.ads", FacebookAdsParams> | JobRequestFor<"facebook.comments", FacebookCommentsParams> | JobRequestFor<"facebook.engagement", FacebookEngagementParams> | JobRequestFor<"facebook.event", FacebookEventParams> | JobRequestFor<"facebook.events", FacebookEventsParams> | JobRequestFor<"facebook.group", FacebookGroupParams> | JobRequestFor<"facebook.group_posts", FacebookGroupPostsParams> | JobRequestFor<"facebook.listing", FacebookListingParams> | JobRequestFor<"facebook.photos", FacebookPhotosParams> | JobRequestFor<"facebook.place_events", FacebookPlaceEventsParams> | JobRequestFor<"facebook.post", FacebookPostParams> | JobRequestFor<"facebook.posts", FacebookPostsParams> | JobRequestFor<"facebook.profile", FacebookProfileParams> | JobRequestFor<"facebook.reels", FacebookReelsParams> | JobRequestFor<"facebook.replies", FacebookRepliesParams> | JobRequestFor<"facebook.search_ads", FacebookSearchAdsParams> | JobRequestFor<"facebook.search_advertisers", FacebookSearchAdvertisersParams> | JobRequestFor<"facebook.search_events", FacebookSearchEventsParams> | JobRequestFor<"facebook.search_groups", FacebookSearchGroupsParams> | JobRequestFor<"facebook.search_listings", FacebookSearchListingsParams> | JobRequestFor<"facebook.search_places", FacebookSearchPlacesParams> | JobRequestFor<"facebook.search_posts", FacebookSearchPostsParams> | JobRequestFor<"facebook.search_profiles", FacebookSearchProfilesParams> | JobRequestFor<"facebook.transcript", FacebookTranscriptParams> | JobRequestFor<"github.activity", GitHubActivityParams> | JobRequestFor<"github.contributions", GitHubContributionsParams> | JobRequestFor<"github.followers", GitHubFollowersParams> | JobRequestFor<"github.following", GitHubFollowingParams> | JobRequestFor<"github.issue", GitHubIssueParams> | JobRequestFor<"github.issue_comments", GitHubIssueCommentsParams> | JobRequestFor<"github.issues", GitHubIssuesParams> | JobRequestFor<"github.pinned_repositories", GitHubPinnedRepositoriesParams> | JobRequestFor<"github.profile", GitHubProfileParams> | JobRequestFor<"github.profile_pull_requests", GitHubProfilePullRequestsParams> | JobRequestFor<"github.readme", GitHubReadmeParams> | JobRequestFor<"github.releases", GitHubReleasesParams> | JobRequestFor<"github.repositories", GitHubRepositoriesParams> | JobRequestFor<"github.repository", GitHubRepositoryParams> | JobRequestFor<"github.repository_contributors", GitHubRepositoryContributorsParams> | JobRequestFor<"github.search_issues", GitHubSearchIssuesParams> | JobRequestFor<"github.search_profiles", GitHubSearchProfilesParams> | JobRequestFor<"github.search_repositories", GitHubSearchRepositoriesParams> | JobRequestFor<"github.trending_profiles", GitHubTrendingProfilesParams> | JobRequestFor<"github.trending_repositories", GitHubTrendingRepositoriesParams> | JobRequestFor<"google.ad", GoogleAdParams> | JobRequestFor<"google.ads", GoogleAdsParams> | JobRequestFor<"google.advertiser", GoogleAdvertiserParams> | JobRequestFor<"google.search_ads", GoogleSearchAdsParams> | JobRequestFor<"google.search_advertisers", GoogleSearchAdvertisersParams> | JobRequestFor<"google.search_suggestions", GoogleSearchSuggestionsParams> | JobRequestFor<"hackernews.comment", HackerNewsCommentParams> | JobRequestFor<"hackernews.comments", HackerNewsCommentsParams> | JobRequestFor<"hackernews.feed_stories", HackerNewsFeedStoriesParams> | JobRequestFor<"hackernews.search_comments", HackerNewsSearchCommentsParams> | JobRequestFor<"hackernews.search_stories", HackerNewsSearchStoriesParams> | JobRequestFor<"hackernews.story", HackerNewsStoryParams> | JobRequestFor<"hackernews.user", HackerNewsUserParams> | JobRequestFor<"hackernews.user_comments", HackerNewsUserCommentsParams> | JobRequestFor<"hackernews.user_favorites", HackerNewsUserFavoritesParams> | JobRequestFor<"hackernews.user_stories", HackerNewsUserStoriesParams> | JobRequestFor<"hackernews.whoishiring_jobs", HackerNewsWhoishiringJobsParams> | JobRequestFor<"instagram.comment", InstagramCommentParams> | JobRequestFor<"instagram.comments", InstagramCommentsParams> | JobRequestFor<"instagram.embed", InstagramEmbedParams> | JobRequestFor<"instagram.engagement", InstagramEngagementParams> | JobRequestFor<"instagram.hashtag", InstagramHashtagParams> | JobRequestFor<"instagram.hashtag_posts", InstagramHashtagPostsParams> | JobRequestFor<"instagram.highlights", InstagramHighlightsParams> | JobRequestFor<"instagram.place", InstagramPlaceParams> | JobRequestFor<"instagram.place_posts", InstagramPlacePostsParams> | JobRequestFor<"instagram.playlist_stories", InstagramPlaylistStoriesParams> | JobRequestFor<"instagram.post", InstagramPostParams> | JobRequestFor<"instagram.posts", InstagramPostsParams> | JobRequestFor<"instagram.profile", InstagramProfileParams> | JobRequestFor<"instagram.reels", InstagramReelsParams> | JobRequestFor<"instagram.search_hashtags", InstagramSearchHashtagsParams> | JobRequestFor<"instagram.search_places", InstagramSearchPlacesParams> | JobRequestFor<"instagram.search_posts", InstagramSearchPostsParams> | JobRequestFor<"instagram.search_profiles", InstagramSearchProfilesParams> | JobRequestFor<"instagram.search_sounds", InstagramSearchSoundsParams> | JobRequestFor<"instagram.search_suggestions", InstagramSearchSuggestionsParams> | JobRequestFor<"instagram.similar_profiles", InstagramSimilarProfilesParams> | JobRequestFor<"instagram.sound", InstagramSoundParams> | JobRequestFor<"instagram.sound_posts", InstagramSoundPostsParams> | JobRequestFor<"instagram.story", InstagramStoryParams> | JobRequestFor<"instagram.topic", InstagramTopicParams> | JobRequestFor<"instagram.transcript", InstagramTranscriptParams> | JobRequestFor<"instagram.trending_posts", InstagramTrendingPostsParams> | JobRequestFor<"instagram.username", InstagramUsernameParams> | JobRequestFor<"kick.post", KickPostParams> | JobRequestFor<"kick.transcript", KickTranscriptParams> | JobRequestFor<"komi.page", KomiPageParams> | JobRequestFor<"kwai.post", KwaiPostParams> | JobRequestFor<"kwai.posts", KwaiPostsParams> | JobRequestFor<"kwai.profile", KwaiProfileParams> | JobRequestFor<"linkbio.profile", LnkBioProfileParams> | JobRequestFor<"linkedin.ad", LinkedInAdParams> | JobRequestFor<"linkedin.comments", LinkedInCommentsParams> | JobRequestFor<"linkedin.employees", LinkedInEmployeesParams> | JobRequestFor<"linkedin.engagement", LinkedInEngagementParams> | JobRequestFor<"linkedin.following", LinkedInFollowingParams> | JobRequestFor<"linkedin.job", LinkedInJobParams> | JobRequestFor<"linkedin.job_related_jobs", LinkedInJobRelatedJobsParams> | JobRequestFor<"linkedin.jobs", LinkedInJobsParams> | JobRequestFor<"linkedin.liked_posts", LinkedInLikedPostsParams> | JobRequestFor<"linkedin.post", LinkedInPostParams> | JobRequestFor<"linkedin.post_reactions", LinkedInPostReactionsParams> | JobRequestFor<"linkedin.post_reposts", LinkedInPostRepostsParams> | JobRequestFor<"linkedin.posts", LinkedInPostsParams> | JobRequestFor<"linkedin.profile", LinkedInProfileParams> | JobRequestFor<"linkedin.profile_comments", LinkedInProfileCommentsParams> | JobRequestFor<"linkedin.profile_groups", LinkedInProfileGroupsParams> | JobRequestFor<"linkedin.search_ads", LinkedInSearchAdsParams> | JobRequestFor<"linkedin.search_jobs", LinkedInSearchJobsParams> | JobRequestFor<"linkedin.search_posts", LinkedInSearchPostsParams> | JobRequestFor<"linkedin.search_profiles", LinkedInSearchProfilesParams> | JobRequestFor<"linkedin.transcript", LinkedInTranscriptParams> | JobRequestFor<"linkme.profile", LinkmeProfileParams> | JobRequestFor<"linktree.profile", LinktreeProfileParams> | JobRequestFor<"pillar.page", PillarPageParams> | JobRequestFor<"pinterest.board", PinterestBoardParams> | JobRequestFor<"pinterest.board_pins", PinterestBoardPinsParams> | JobRequestFor<"pinterest.boards", PinterestBoardsParams> | JobRequestFor<"pinterest.pin", PinterestPinParams> | JobRequestFor<"pinterest.pins", PinterestPinsParams> | JobRequestFor<"pinterest.profile", PinterestProfileParams> | JobRequestFor<"pinterest.search_pins", PinterestSearchPinsParams> | JobRequestFor<"pinterest.top_trends", PinterestTopTrendsParams> | JobRequestFor<"pinterest.topic", PinterestTopicParams> | JobRequestFor<"pinterest.web_page", PinterestWebPageParams> | JobRequestFor<"reddit.comments", RedditCommentsParams> | JobRequestFor<"reddit.engagement", RedditEngagementParams> | JobRequestFor<"reddit.post", RedditPostParams> | JobRequestFor<"reddit.posts", RedditPostsParams> | JobRequestFor<"reddit.profile", RedditProfileParams> | JobRequestFor<"reddit.profile_comments", RedditProfileCommentsParams> | JobRequestFor<"reddit.search_comments", RedditSearchCommentsParams> | JobRequestFor<"reddit.search_posts", RedditSearchPostsParams> | JobRequestFor<"reddit.search_profiles", RedditSearchProfilesParams> | JobRequestFor<"reddit.search_subreddits", RedditSearchSubredditsParams> | JobRequestFor<"reddit.subreddit", RedditSubredditParams> | JobRequestFor<"reddit.subreddit_posts", RedditSubredditPostsParams> | JobRequestFor<"reddit.transcript", RedditTranscriptParams> | JobRequestFor<"rumble.comments", RumbleCommentsParams> | JobRequestFor<"rumble.engagement", RumbleEngagementParams> | JobRequestFor<"rumble.post", RumblePostParams> | JobRequestFor<"rumble.posts", RumblePostsParams> | JobRequestFor<"rumble.profile", RumbleProfileParams> | JobRequestFor<"rumble.search_posts", RumbleSearchPostsParams> | JobRequestFor<"rumble.transcript", RumbleTranscriptParams> | JobRequestFor<"snapchat.comments", SnapchatCommentsParams> | JobRequestFor<"snapchat.profile", SnapchatProfileParams> | JobRequestFor<"snapchat.spotlight", SnapchatSpotlightParams> | JobRequestFor<"soundcloud.artist", SoundCloudArtistParams> | JobRequestFor<"soundcloud.track", SoundCloudTrackParams> | JobRequestFor<"soundcloud.tracks", SoundCloudTracksParams> | JobRequestFor<"spotify.album", SpotifyAlbumParams> | JobRequestFor<"spotify.artist", SpotifyArtistParams> | JobRequestFor<"spotify.playlist", SpotifyPlaylistParams> | JobRequestFor<"spotify.playlist_tracks", SpotifyPlaylistTracksParams> | JobRequestFor<"spotify.podcast", SpotifyPodcastParams> | JobRequestFor<"spotify.podcast_episodes", SpotifyPodcastEpisodesParams> | JobRequestFor<"spotify.search_albums", SpotifySearchAlbumsParams> | JobRequestFor<"spotify.search_artists", SpotifySearchArtistsParams> | JobRequestFor<"spotify.search_playlists", SpotifySearchPlaylistsParams> | JobRequestFor<"spotify.search_podcasts", SpotifySearchPodcastsParams> | JobRequestFor<"spotify.search_tracks", SpotifySearchTracksParams> | JobRequestFor<"spotify.track", SpotifyTrackParams> | JobRequestFor<"telegram.channel", TelegramChannelParams> | JobRequestFor<"telegram.channel_posts", TelegramChannelPostsParams> | JobRequestFor<"telegram.post", TelegramPostParams> | JobRequestFor<"telegram.search_channels", TelegramSearchChannelsParams> | JobRequestFor<"threads.comments", ThreadsCommentsParams> | JobRequestFor<"threads.post", ThreadsPostParams> | JobRequestFor<"threads.posts", ThreadsPostsParams> | JobRequestFor<"threads.profile", ThreadsProfileParams> | JobRequestFor<"threads.search_posts", ThreadsSearchPostsParams> | JobRequestFor<"threads.search_profiles", ThreadsSearchProfilesParams> | JobRequestFor<"tiktok.ad", TikTokAdParams> | JobRequestFor<"tiktok.comment", TikTokCommentParams> | JobRequestFor<"tiktok.comments", TikTokCommentsParams> | JobRequestFor<"tiktok.download", TikTokDownloadParams> | JobRequestFor<"tiktok.effect", TikTokEffectParams> | JobRequestFor<"tiktok.effect_posts", TikTokEffectPostsParams> | JobRequestFor<"tiktok.engagement", TikTokEngagementParams> | JobRequestFor<"tiktok.followers", TikTokFollowersParams> | JobRequestFor<"tiktok.following", TikTokFollowingParams> | JobRequestFor<"tiktok.hashtag", TikTokHashtagParams> | JobRequestFor<"tiktok.hashtag_posts", TikTokHashtagPostsParams> | JobRequestFor<"tiktok.liked_posts", TikTokLikedPostsParams> | JobRequestFor<"tiktok.live", TikTokLiveParams> | JobRequestFor<"tiktok.place_posts", TikTokPlacePostsParams> | JobRequestFor<"tiktok.playlist_posts", TikTokPlaylistPostsParams> | JobRequestFor<"tiktok.playlists", TikTokPlaylistsParams> | JobRequestFor<"tiktok.post", TikTokPostParams> | JobRequestFor<"tiktok.posts", TikTokPostsParams> | JobRequestFor<"tiktok.profile", TikTokProfileParams> | JobRequestFor<"tiktok.replies", TikTokRepliesParams> | JobRequestFor<"tiktok.search_ads", TikTokSearchAdsParams> | JobRequestFor<"tiktok.search_hashtags", TikTokSearchHashtagsParams> | JobRequestFor<"tiktok.search_posts", TikTokSearchPostsParams> | JobRequestFor<"tiktok.search_profiles", TikTokSearchProfilesParams> | JobRequestFor<"tiktok.search_sounds", TikTokSearchSoundsParams> | JobRequestFor<"tiktok.search_suggestions", TikTokSearchSuggestionsParams> | JobRequestFor<"tiktok.search_top", TikTokSearchTopParams> | JobRequestFor<"tiktok.sound", TikTokSoundParams> | JobRequestFor<"tiktok.sound_posts", TikTokSoundPostsParams> | JobRequestFor<"tiktok.top_ads", TikTokTopAdsParams> | JobRequestFor<"tiktok.top_posts", TikTokTopPostsParams> | JobRequestFor<"tiktok.transcript", TikTokTranscriptParams> | JobRequestFor<"tiktok.trending_hashtags", TikTokTrendingHashtagsParams> | JobRequestFor<"tiktok.trending_posts", TikTokTrendingPostsParams> | JobRequestFor<"tiktokshop.product", TikTokShopProductParams> | JobRequestFor<"tiktokshop.products", TikTokShopProductsParams> | JobRequestFor<"tiktokshop.reviews", TikTokShopReviewsParams> | JobRequestFor<"tiktokshop.search_products", TikTokShopSearchProductsParams> | JobRequestFor<"truthsocial.post", TruthSocialPostParams> | JobRequestFor<"truthsocial.posts", TruthSocialPostsParams> | JobRequestFor<"truthsocial.profile", TruthSocialProfileParams> | JobRequestFor<"twitch.profile", TwitchProfileParams> | JobRequestFor<"twitch.schedule", TwitchScheduleParams> | JobRequestFor<"twitch.transcript", TwitchTranscriptParams> | JobRequestFor<"twitch.video", TwitchVideoParams> | JobRequestFor<"twitch.videos", TwitchVideosParams> | JobRequestFor<"x.comments", XCommentsParams> | JobRequestFor<"x.community", XCommunityParams> | JobRequestFor<"x.community_posts", XCommunityPostsParams> | JobRequestFor<"x.engagement", XEngagementParams> | JobRequestFor<"x.friendship", XFriendshipParams> | JobRequestFor<"x.list", XListParams> | JobRequestFor<"x.list_followers", XListFollowersParams> | JobRequestFor<"x.post", XPostParams> | JobRequestFor<"x.posts", XPostsParams> | JobRequestFor<"x.profile", XProfileParams> | JobRequestFor<"x.profile_mentions", XProfileMentionsParams> | JobRequestFor<"x.search_communities", XSearchCommunitiesParams> | JobRequestFor<"x.search_hashtags", XSearchHashtagsParams> | JobRequestFor<"x.search_posts", XSearchPostsParams> | JobRequestFor<"x.search_profiles", XSearchProfilesParams> | JobRequestFor<"x.space", XSpaceParams> | JobRequestFor<"x.transcript", XTranscriptParams> | JobRequestFor<"youtube.comments", YouTubeCommentsParams> | JobRequestFor<"youtube.engagement", YouTubeEngagementParams> | JobRequestFor<"youtube.post", YouTubePostParams> | JobRequestFor<"youtube.posts", YouTubePostsParams> | JobRequestFor<"youtube.profile", YouTubeProfileParams> | JobRequestFor<"youtube.transcript", YouTubeTranscriptParams>;
10195
+ export type JobRequest = JobRequestFor<"amazon.deal_products", AmazonDealProductsParams> | JobRequestFor<"amazon.offers", AmazonOffersParams> | JobRequestFor<"amazon.product", AmazonProductParams> | JobRequestFor<"amazon.reviews", AmazonReviewsParams> | JobRequestFor<"amazon.search_products", AmazonSearchProductsParams> | JobRequestFor<"amazon.seller", AmazonSellerParams> | JobRequestFor<"amazon.shop", AmazonShopParams> | JobRequestFor<"amazon.shop_lists", AmazonShopListsParams> | JobRequestFor<"amazon.shop_posts", AmazonShopPostsParams> | JobRequestFor<"amazon.top_products", AmazonTopProductsParams> | JobRequestFor<"applemusic.album", AppleMusicAlbumParams> | JobRequestFor<"applemusic.artist", AppleMusicArtistParams> | JobRequestFor<"applemusic.search_albums", AppleMusicSearchAlbumsParams> | JobRequestFor<"applemusic.search_artists", AppleMusicSearchArtistsParams> | JobRequestFor<"applemusic.search_playlists", AppleMusicSearchPlaylistsParams> | JobRequestFor<"applemusic.search_tracks", AppleMusicSearchTracksParams> | JobRequestFor<"applemusic.top_albums", AppleMusicTopAlbumsParams> | JobRequestFor<"applemusic.top_playlists", AppleMusicTopPlaylistsParams> | JobRequestFor<"applemusic.top_tracks", AppleMusicTopTracksParams> | JobRequestFor<"applemusic.track", AppleMusicTrackParams> | JobRequestFor<"bluesky.comments", BlueskyCommentsParams> | JobRequestFor<"bluesky.post", BlueskyPostParams> | JobRequestFor<"bluesky.posts", BlueskyPostsParams> | JobRequestFor<"bluesky.profile", BlueskyProfileParams> | JobRequestFor<"bluesky.search_posts", BlueskySearchPostsParams> | JobRequestFor<"facebook.ad", FacebookAdParams> | JobRequestFor<"facebook.ad_transcript", FacebookAdTranscriptParams> | JobRequestFor<"facebook.ads", FacebookAdsParams> | JobRequestFor<"facebook.advertiser", FacebookAdvertiserParams> | JobRequestFor<"facebook.comments", FacebookCommentsParams> | JobRequestFor<"facebook.engagement", FacebookEngagementParams> | JobRequestFor<"facebook.event", FacebookEventParams> | JobRequestFor<"facebook.events", FacebookEventsParams> | JobRequestFor<"facebook.group", FacebookGroupParams> | JobRequestFor<"facebook.group_posts", FacebookGroupPostsParams> | JobRequestFor<"facebook.listing", FacebookListingParams> | JobRequestFor<"facebook.photos", FacebookPhotosParams> | JobRequestFor<"facebook.place_events", FacebookPlaceEventsParams> | JobRequestFor<"facebook.post", FacebookPostParams> | JobRequestFor<"facebook.posts", FacebookPostsParams> | JobRequestFor<"facebook.profile", FacebookProfileParams> | JobRequestFor<"facebook.reels", FacebookReelsParams> | JobRequestFor<"facebook.replies", FacebookRepliesParams> | JobRequestFor<"facebook.search_ads", FacebookSearchAdsParams> | JobRequestFor<"facebook.search_advertisers", FacebookSearchAdvertisersParams> | JobRequestFor<"facebook.search_events", FacebookSearchEventsParams> | JobRequestFor<"facebook.search_groups", FacebookSearchGroupsParams> | JobRequestFor<"facebook.search_listings", FacebookSearchListingsParams> | JobRequestFor<"facebook.search_places", FacebookSearchPlacesParams> | JobRequestFor<"facebook.search_posts", FacebookSearchPostsParams> | JobRequestFor<"facebook.search_profiles", FacebookSearchProfilesParams> | JobRequestFor<"facebook.transcript", FacebookTranscriptParams> | JobRequestFor<"github.activity", GitHubActivityParams> | JobRequestFor<"github.contributions", GitHubContributionsParams> | JobRequestFor<"github.followers", GitHubFollowersParams> | JobRequestFor<"github.following", GitHubFollowingParams> | JobRequestFor<"github.issue", GitHubIssueParams> | JobRequestFor<"github.issue_comments", GitHubIssueCommentsParams> | JobRequestFor<"github.issues", GitHubIssuesParams> | JobRequestFor<"github.pinned_repositories", GitHubPinnedRepositoriesParams> | JobRequestFor<"github.profile", GitHubProfileParams> | JobRequestFor<"github.profile_pull_requests", GitHubProfilePullRequestsParams> | JobRequestFor<"github.readme", GitHubReadmeParams> | JobRequestFor<"github.releases", GitHubReleasesParams> | JobRequestFor<"github.repositories", GitHubRepositoriesParams> | JobRequestFor<"github.repository", GitHubRepositoryParams> | JobRequestFor<"github.repository_contributors", GitHubRepositoryContributorsParams> | JobRequestFor<"github.search_issues", GitHubSearchIssuesParams> | JobRequestFor<"github.search_profiles", GitHubSearchProfilesParams> | JobRequestFor<"github.search_repositories", GitHubSearchRepositoriesParams> | JobRequestFor<"github.trending_profiles", GitHubTrendingProfilesParams> | JobRequestFor<"github.trending_repositories", GitHubTrendingRepositoriesParams> | JobRequestFor<"google.ad", GoogleAdParams> | JobRequestFor<"google.ads", GoogleAdsParams> | JobRequestFor<"google.advertiser", GoogleAdvertiserParams> | JobRequestFor<"google.search_ads", GoogleSearchAdsParams> | JobRequestFor<"google.search_advertisers", GoogleSearchAdvertisersParams> | JobRequestFor<"google.search_suggestions", GoogleSearchSuggestionsParams> | JobRequestFor<"hackernews.comment", HackerNewsCommentParams> | JobRequestFor<"hackernews.comments", HackerNewsCommentsParams> | JobRequestFor<"hackernews.feed_stories", HackerNewsFeedStoriesParams> | JobRequestFor<"hackernews.search_comments", HackerNewsSearchCommentsParams> | JobRequestFor<"hackernews.search_stories", HackerNewsSearchStoriesParams> | JobRequestFor<"hackernews.story", HackerNewsStoryParams> | JobRequestFor<"hackernews.user", HackerNewsUserParams> | JobRequestFor<"hackernews.user_comments", HackerNewsUserCommentsParams> | JobRequestFor<"hackernews.user_favorites", HackerNewsUserFavoritesParams> | JobRequestFor<"hackernews.user_stories", HackerNewsUserStoriesParams> | JobRequestFor<"hackernews.whoishiring_jobs", HackerNewsWhoishiringJobsParams> | JobRequestFor<"instagram.comment", InstagramCommentParams> | JobRequestFor<"instagram.comments", InstagramCommentsParams> | JobRequestFor<"instagram.embed", InstagramEmbedParams> | JobRequestFor<"instagram.engagement", InstagramEngagementParams> | JobRequestFor<"instagram.hashtag", InstagramHashtagParams> | JobRequestFor<"instagram.hashtag_posts", InstagramHashtagPostsParams> | JobRequestFor<"instagram.highlights", InstagramHighlightsParams> | JobRequestFor<"instagram.place", InstagramPlaceParams> | JobRequestFor<"instagram.place_posts", InstagramPlacePostsParams> | JobRequestFor<"instagram.playlist_stories", InstagramPlaylistStoriesParams> | JobRequestFor<"instagram.popular_trends", InstagramPopularTrendsParams> | JobRequestFor<"instagram.post", InstagramPostParams> | JobRequestFor<"instagram.posts", InstagramPostsParams> | JobRequestFor<"instagram.profile", InstagramProfileParams> | JobRequestFor<"instagram.reels", InstagramReelsParams> | JobRequestFor<"instagram.search_hashtags", InstagramSearchHashtagsParams> | JobRequestFor<"instagram.search_places", InstagramSearchPlacesParams> | JobRequestFor<"instagram.search_posts", InstagramSearchPostsParams> | JobRequestFor<"instagram.search_profiles", InstagramSearchProfilesParams> | JobRequestFor<"instagram.search_sounds", InstagramSearchSoundsParams> | JobRequestFor<"instagram.search_suggestions", InstagramSearchSuggestionsParams> | JobRequestFor<"instagram.similar_profiles", InstagramSimilarProfilesParams> | JobRequestFor<"instagram.sound", InstagramSoundParams> | JobRequestFor<"instagram.sound_posts", InstagramSoundPostsParams> | JobRequestFor<"instagram.story", InstagramStoryParams> | JobRequestFor<"instagram.topic", InstagramTopicParams> | JobRequestFor<"instagram.transcript", InstagramTranscriptParams> | JobRequestFor<"instagram.trending_posts", InstagramTrendingPostsParams> | JobRequestFor<"instagram.username", InstagramUsernameParams> | JobRequestFor<"kick.post", KickPostParams> | JobRequestFor<"kick.transcript", KickTranscriptParams> | JobRequestFor<"komi.page", KomiPageParams> | JobRequestFor<"kwai.post", KwaiPostParams> | JobRequestFor<"kwai.posts", KwaiPostsParams> | JobRequestFor<"kwai.profile", KwaiProfileParams> | JobRequestFor<"linkbio.profile", LnkBioProfileParams> | JobRequestFor<"linkedin.ad", LinkedInAdParams> | JobRequestFor<"linkedin.comments", LinkedInCommentsParams> | JobRequestFor<"linkedin.employees", LinkedInEmployeesParams> | JobRequestFor<"linkedin.engagement", LinkedInEngagementParams> | JobRequestFor<"linkedin.following", LinkedInFollowingParams> | JobRequestFor<"linkedin.job", LinkedInJobParams> | JobRequestFor<"linkedin.job_related_jobs", LinkedInJobRelatedJobsParams> | JobRequestFor<"linkedin.jobs", LinkedInJobsParams> | JobRequestFor<"linkedin.liked_posts", LinkedInLikedPostsParams> | JobRequestFor<"linkedin.post", LinkedInPostParams> | JobRequestFor<"linkedin.post_reactions", LinkedInPostReactionsParams> | JobRequestFor<"linkedin.post_reposts", LinkedInPostRepostsParams> | JobRequestFor<"linkedin.posts", LinkedInPostsParams> | JobRequestFor<"linkedin.profile", LinkedInProfileParams> | JobRequestFor<"linkedin.profile_comments", LinkedInProfileCommentsParams> | JobRequestFor<"linkedin.profile_groups", LinkedInProfileGroupsParams> | JobRequestFor<"linkedin.search_ads", LinkedInSearchAdsParams> | JobRequestFor<"linkedin.search_jobs", LinkedInSearchJobsParams> | JobRequestFor<"linkedin.search_posts", LinkedInSearchPostsParams> | JobRequestFor<"linkedin.search_profiles", LinkedInSearchProfilesParams> | JobRequestFor<"linkedin.transcript", LinkedInTranscriptParams> | JobRequestFor<"linkme.profile", LinkmeProfileParams> | JobRequestFor<"linktree.profile", LinktreeProfileParams> | JobRequestFor<"pillar.page", PillarPageParams> | JobRequestFor<"pinterest.board", PinterestBoardParams> | JobRequestFor<"pinterest.board_pins", PinterestBoardPinsParams> | JobRequestFor<"pinterest.boards", PinterestBoardsParams> | JobRequestFor<"pinterest.pin", PinterestPinParams> | JobRequestFor<"pinterest.pins", PinterestPinsParams> | JobRequestFor<"pinterest.profile", PinterestProfileParams> | JobRequestFor<"pinterest.search_pins", PinterestSearchPinsParams> | JobRequestFor<"pinterest.top_trends", PinterestTopTrendsParams> | JobRequestFor<"pinterest.topic", PinterestTopicParams> | JobRequestFor<"pinterest.web_page", PinterestWebPageParams> | JobRequestFor<"reddit.comments", RedditCommentsParams> | JobRequestFor<"reddit.engagement", RedditEngagementParams> | JobRequestFor<"reddit.post", RedditPostParams> | JobRequestFor<"reddit.posts", RedditPostsParams> | JobRequestFor<"reddit.profile", RedditProfileParams> | JobRequestFor<"reddit.profile_comments", RedditProfileCommentsParams> | JobRequestFor<"reddit.search_comments", RedditSearchCommentsParams> | JobRequestFor<"reddit.search_posts", RedditSearchPostsParams> | JobRequestFor<"reddit.search_profiles", RedditSearchProfilesParams> | JobRequestFor<"reddit.search_subreddits", RedditSearchSubredditsParams> | JobRequestFor<"reddit.subreddit", RedditSubredditParams> | JobRequestFor<"reddit.subreddit_posts", RedditSubredditPostsParams> | JobRequestFor<"reddit.transcript", RedditTranscriptParams> | JobRequestFor<"rumble.comments", RumbleCommentsParams> | JobRequestFor<"rumble.engagement", RumbleEngagementParams> | JobRequestFor<"rumble.post", RumblePostParams> | JobRequestFor<"rumble.posts", RumblePostsParams> | JobRequestFor<"rumble.profile", RumbleProfileParams> | JobRequestFor<"rumble.search_posts", RumbleSearchPostsParams> | JobRequestFor<"rumble.transcript", RumbleTranscriptParams> | JobRequestFor<"snapchat.comments", SnapchatCommentsParams> | JobRequestFor<"snapchat.profile", SnapchatProfileParams> | JobRequestFor<"snapchat.spotlight", SnapchatSpotlightParams> | JobRequestFor<"soundcloud.artist", SoundCloudArtistParams> | JobRequestFor<"soundcloud.track", SoundCloudTrackParams> | JobRequestFor<"soundcloud.tracks", SoundCloudTracksParams> | JobRequestFor<"spotify.album", SpotifyAlbumParams> | JobRequestFor<"spotify.artist", SpotifyArtistParams> | JobRequestFor<"spotify.playlist", SpotifyPlaylistParams> | JobRequestFor<"spotify.playlist_tracks", SpotifyPlaylistTracksParams> | JobRequestFor<"spotify.podcast", SpotifyPodcastParams> | JobRequestFor<"spotify.podcast_episodes", SpotifyPodcastEpisodesParams> | JobRequestFor<"spotify.search_albums", SpotifySearchAlbumsParams> | JobRequestFor<"spotify.search_artists", SpotifySearchArtistsParams> | JobRequestFor<"spotify.search_playlists", SpotifySearchPlaylistsParams> | JobRequestFor<"spotify.search_podcasts", SpotifySearchPodcastsParams> | JobRequestFor<"spotify.search_tracks", SpotifySearchTracksParams> | JobRequestFor<"spotify.track", SpotifyTrackParams> | JobRequestFor<"telegram.channel", TelegramChannelParams> | JobRequestFor<"telegram.channel_posts", TelegramChannelPostsParams> | JobRequestFor<"telegram.post", TelegramPostParams> | JobRequestFor<"telegram.search_channels", TelegramSearchChannelsParams> | JobRequestFor<"threads.comments", ThreadsCommentsParams> | JobRequestFor<"threads.post", ThreadsPostParams> | JobRequestFor<"threads.posts", ThreadsPostsParams> | JobRequestFor<"threads.profile", ThreadsProfileParams> | JobRequestFor<"threads.search_posts", ThreadsSearchPostsParams> | JobRequestFor<"threads.search_profiles", ThreadsSearchProfilesParams> | JobRequestFor<"tiktok.ad", TikTokAdParams> | JobRequestFor<"tiktok.comment", TikTokCommentParams> | JobRequestFor<"tiktok.comments", TikTokCommentsParams> | JobRequestFor<"tiktok.download", TikTokDownloadParams> | JobRequestFor<"tiktok.effect", TikTokEffectParams> | JobRequestFor<"tiktok.effect_posts", TikTokEffectPostsParams> | JobRequestFor<"tiktok.engagement", TikTokEngagementParams> | JobRequestFor<"tiktok.followers", TikTokFollowersParams> | JobRequestFor<"tiktok.following", TikTokFollowingParams> | JobRequestFor<"tiktok.hashtag", TikTokHashtagParams> | JobRequestFor<"tiktok.hashtag_posts", TikTokHashtagPostsParams> | JobRequestFor<"tiktok.liked_posts", TikTokLikedPostsParams> | JobRequestFor<"tiktok.live", TikTokLiveParams> | JobRequestFor<"tiktok.place_posts", TikTokPlacePostsParams> | JobRequestFor<"tiktok.playlist_posts", TikTokPlaylistPostsParams> | JobRequestFor<"tiktok.playlists", TikTokPlaylistsParams> | JobRequestFor<"tiktok.post", TikTokPostParams> | JobRequestFor<"tiktok.posts", TikTokPostsParams> | JobRequestFor<"tiktok.profile", TikTokProfileParams> | JobRequestFor<"tiktok.replies", TikTokRepliesParams> | JobRequestFor<"tiktok.search_ads", TikTokSearchAdsParams> | JobRequestFor<"tiktok.search_hashtags", TikTokSearchHashtagsParams> | JobRequestFor<"tiktok.search_posts", TikTokSearchPostsParams> | JobRequestFor<"tiktok.search_profiles", TikTokSearchProfilesParams> | JobRequestFor<"tiktok.search_sounds", TikTokSearchSoundsParams> | JobRequestFor<"tiktok.search_suggestions", TikTokSearchSuggestionsParams> | JobRequestFor<"tiktok.search_top", TikTokSearchTopParams> | JobRequestFor<"tiktok.sound", TikTokSoundParams> | JobRequestFor<"tiktok.sound_posts", TikTokSoundPostsParams> | JobRequestFor<"tiktok.top_ads", TikTokTopAdsParams> | JobRequestFor<"tiktok.top_posts", TikTokTopPostsParams> | JobRequestFor<"tiktok.transcript", TikTokTranscriptParams> | JobRequestFor<"tiktok.trending_hashtags", TikTokTrendingHashtagsParams> | JobRequestFor<"tiktok.trending_posts", TikTokTrendingPostsParams> | JobRequestFor<"tiktokshop.product", TikTokShopProductParams> | JobRequestFor<"tiktokshop.products", TikTokShopProductsParams> | JobRequestFor<"tiktokshop.reviews", TikTokShopReviewsParams> | JobRequestFor<"tiktokshop.search_products", TikTokShopSearchProductsParams> | JobRequestFor<"truthsocial.post", TruthSocialPostParams> | JobRequestFor<"truthsocial.posts", TruthSocialPostsParams> | JobRequestFor<"truthsocial.profile", TruthSocialProfileParams> | JobRequestFor<"twitch.profile", TwitchProfileParams> | JobRequestFor<"twitch.schedule", TwitchScheduleParams> | JobRequestFor<"twitch.transcript", TwitchTranscriptParams> | JobRequestFor<"twitch.video", TwitchVideoParams> | JobRequestFor<"twitch.videos", TwitchVideosParams> | JobRequestFor<"x.comments", XCommentsParams> | JobRequestFor<"x.community", XCommunityParams> | JobRequestFor<"x.community_posts", XCommunityPostsParams> | JobRequestFor<"x.engagement", XEngagementParams> | JobRequestFor<"x.friendship", XFriendshipParams> | JobRequestFor<"x.list", XListParams> | JobRequestFor<"x.list_followers", XListFollowersParams> | JobRequestFor<"x.post", XPostParams> | JobRequestFor<"x.posts", XPostsParams> | JobRequestFor<"x.profile", XProfileParams> | JobRequestFor<"x.profile_mentions", XProfileMentionsParams> | JobRequestFor<"x.search_communities", XSearchCommunitiesParams> | JobRequestFor<"x.search_hashtags", XSearchHashtagsParams> | JobRequestFor<"x.search_posts", XSearchPostsParams> | JobRequestFor<"x.search_profiles", XSearchProfilesParams> | JobRequestFor<"x.space", XSpaceParams> | JobRequestFor<"x.transcript", XTranscriptParams> | JobRequestFor<"youtube.comments", YouTubeCommentsParams> | JobRequestFor<"youtube.engagement", YouTubeEngagementParams> | JobRequestFor<"youtube.post", YouTubePostParams> | JobRequestFor<"youtube.posts", YouTubePostsParams> | JobRequestFor<"youtube.profile", YouTubeProfileParams> | JobRequestFor<"youtube.transcript", YouTubeTranscriptParams>;
10170
10196
  /** A request's params or body (gateway routes). */
10171
10197
  export interface CreateJobRequest {
10172
10198
  /** The requests to run, 1 to 1000; custom_id must be unique within the job. */
@@ -2116,6 +2116,49 @@ export declare class FacebookAds {
2116
2116
  }, options?: IterateOptions): Paginator<Ad>;
2117
2117
  iterate(params: FacebookAdsParams, options?: IterateOptions): Paginator<PartialModel<Ad>>;
2118
2118
  }
2119
+ /** Params of `facebook.advertiser` (GET /v1/facebook/advertiser). */
2120
+ export interface FacebookAdvertiserParams {
2121
+ /**
2122
+ * The advertiser: its Ad Library link (facebook.com/ads/library/?view_all_page_id=…), its Facebook Page's link
2123
+ * or name, or its Page ID. At most 2048 characters. Example:
2124
+ * https://www.facebook.com/ads/library/?view_all_page_id=54971236771&search_type=page
2125
+ */
2126
+ handle: string;
2127
+ /**
2128
+ * Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.
2129
+ * The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0.
2130
+ */
2131
+ max_age?: number;
2132
+ /**
2133
+ * Return only these fields of each item: comma-separated paths in the schema's notation
2134
+ * (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are
2135
+ * rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always
2136
+ * returned whole.
2137
+ */
2138
+ fields?: string;
2139
+ }
2140
+ /** `facebook.advertiser`: Advertiser profile and linked Instagram. */
2141
+ export declare class FacebookAdvertiser {
2142
+ #private;
2143
+ constructor(core: Core);
2144
+ /**
2145
+ * Advertiser profile and linked Instagram.
2146
+ *
2147
+ * Returns one advertiser's profile from Meta's public Ad Library, from its Ad Library link, its Facebook Page's
2148
+ * link or name, or its Page ID. You get its Page ID, name, username, picture, verified badge, category, exact
2149
+ * follower count, bio and creation date, the organization Meta confirms runs it with its address, where its
2150
+ * admins are, and the Instagram account it advertises with, with that account's exact followers and badge.
2151
+ *
2152
+ * Cost: 1 credit. Failed requests and cache hits are free.
2153
+ *
2154
+ * With `fields`, the items are `PartialModel<Profile>`: only the selected paths are sent, so any member may be
2155
+ * absent.
2156
+ */
2157
+ get(params: FacebookAdvertiserParams & {
2158
+ fields?: undefined;
2159
+ }, options?: RequestOptions): Promise<Result<Profile>>;
2160
+ get(params: FacebookAdvertiserParams, options?: RequestOptions): Promise<Result<PartialModel<Profile>>>;
2161
+ }
2119
2162
  /** Params of `facebook.comments` (GET /v1/facebook/comments). */
2120
2163
  export interface FacebookCommentsParams {
2121
2164
  /**
@@ -3838,11 +3881,12 @@ export declare class FacebookTranscript {
3838
3881
  * Messenger, Threads and the Audience Network, with creatives, run dates and advertiser. Search ads by keyword,
3839
3882
  * list an advertiser's ads, or get one ad with its EU and UK audience, the payer, reach and spend of political
3840
3883
  * and social-issue ads, and the transcript of its video. Find advertisers by name, with their Page ID and
3841
- * followers. Facebook Marketplace: Public Facebook Marketplace listings with price, condition, description,
3842
- * photos, seller and delivery options. Search listings by keyword around a location with Marketplace's own
3843
- * filters, and find the places (cities, neighborhoods, postal codes) to search around. Facebook Events: Public
3844
- * Facebook events with their dates, venue, hosts, categories, ticket link and going and interested counts. Get
3845
- * one by its link, list a Page's events or a city's, or search events by keyword.
3884
+ * followers, or get one advertiser's profile with the Instagram account it advertises with. Facebook
3885
+ * Marketplace: Public Facebook Marketplace listings with price, condition, description, photos, seller and
3886
+ * delivery options. Search listings by keyword around a location with Marketplace's own filters, and find the
3887
+ * places (cities, neighborhoods, postal codes) to search around. Facebook Events: Public Facebook events with
3888
+ * their dates, venue, hosts, categories, ticket link and going and interested counts. Get one by its link, list
3889
+ * a Page's events or a city's, or search events by keyword.
3846
3890
  */
3847
3891
  export declare class Facebook {
3848
3892
  /** `facebook.ad`: Creatives, run dates, placements and EU reach. */
@@ -3851,6 +3895,8 @@ export declare class Facebook {
3851
3895
  readonly adTranscript: FacebookAdTranscript;
3852
3896
  /** `facebook.ads`: Active and past ads of one Page. */
3853
3897
  readonly ads: FacebookAds;
3898
+ /** `facebook.advertiser`: Advertiser profile and linked Instagram. */
3899
+ readonly advertiser: FacebookAdvertiser;
3854
3900
  /** `facebook.comments`: Top-level, with exact reactions and reply counts. */
3855
3901
  readonly comments: FacebookComments;
3856
3902
  /** `facebook.engagement`: Engagement rate, cadence and top posts. */
@@ -7363,6 +7409,78 @@ export declare class InstagramPlaylistStories {
7363
7409
  }, options?: IterateOptions): Paginator<Post>;
7364
7410
  iterate(params: InstagramPlaylistStoriesParams, options?: IterateOptions): Paginator<PartialModel<Post>>;
7365
7411
  }
7412
+ /** Params of `instagram.popular_trends` (GET /v1/instagram/popular_trends). */
7413
+ export interface InstagramPopularTrendsParams {
7414
+ /**
7415
+ * Only the terms of one section of Instagram's popular page: trending_now (Trending now), entertainment (Pop
7416
+ * culture moments), get_inspired (Get inspired), learn_something_new (Learn something new), shop_the_trends
7417
+ * (Shop the trends), trending_month (What's happening now) or browse_categories (Find what you're into). Every
7418
+ * section, in the page's order, when omitted. One of: trending_now, entertainment, get_inspired,
7419
+ * learn_something_new, shop_the_trends, trending_month, browse_categories. Example: trending_now
7420
+ */
7421
+ section?: "trending_now" | "entertainment" | "get_inspired" | "learn_something_new" | "shop_the_trends" | "trending_month" | "browse_categories";
7422
+ /**
7423
+ * Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.
7424
+ * The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0.
7425
+ */
7426
+ max_age?: number;
7427
+ /**
7428
+ * Return only these fields of each item: comma-separated paths in the schema's notation
7429
+ * (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are
7430
+ * rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always
7431
+ * returned whole.
7432
+ */
7433
+ fields?: string;
7434
+ /**
7435
+ * Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit
7436
+ * it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 100. Default: 100.
7437
+ */
7438
+ limit?: number;
7439
+ /**
7440
+ * page.next_cursor from the previous response. Send the same other parameters; omit to start from the first
7441
+ * page.
7442
+ */
7443
+ cursor?: string;
7444
+ }
7445
+ /** `instagram.popular_trends`: Promoted searches with exact post counts. */
7446
+ export declare class InstagramPopularTrends {
7447
+ #private;
7448
+ constructor(core: Core);
7449
+ /**
7450
+ * Promoted searches with exact post counts.
7451
+ *
7452
+ * Returns the search terms Instagram promotes on its popular page, by section, with exact post counts. Sections
7453
+ * include Trending now, Pop culture moments, What's happening now, Get inspired, Learn something new and Shop
7454
+ * the trends. Each term comes with its rank in the section, a picture, the reel Instagram features for it and a
7455
+ * link to its topic page. Ask for one section, or get them all in the page's order.
7456
+ *
7457
+ * Cost per page: 1 credit. Failed requests and cache hits are free.
7458
+ *
7459
+ * Lists up to 100 items per page (Instagram's popular page order: section by section, each by its rank);
7460
+ * `page.next_cursor` continues the list. An empty page with has_more is not the end.
7461
+ *
7462
+ * With `fields`, the items are `PartialModel<Trend>`: only the selected paths are sent, so any member may be
7463
+ * absent.
7464
+ */
7465
+ list(params: InstagramPopularTrendsParams & {
7466
+ fields?: undefined;
7467
+ }, options?: RequestOptions): Promise<ListResult<Trend>>;
7468
+ list(params: InstagramPopularTrendsParams, options?: RequestOptions): Promise<ListResult<PartialModel<Trend>>>;
7469
+ /**
7470
+ * Every item of the list, page by page: `for await (const item of
7471
+ * client.instagram.popularTrends.iterate({...}))`. Starts at params.cursor when given. Guards: maxPages,
7472
+ * maxCredits (each page costs at most 1 credits).
7473
+ *
7474
+ * Cost per page: 1 credit. Failed requests and cache hits are free.
7475
+ *
7476
+ * With `fields`, the items are `PartialModel<Trend>`: only the selected paths are sent, so any member may be
7477
+ * absent.
7478
+ */
7479
+ iterate(params: InstagramPopularTrendsParams & {
7480
+ fields?: undefined;
7481
+ }, options?: IterateOptions): Paginator<Trend>;
7482
+ iterate(params: InstagramPopularTrendsParams, options?: IterateOptions): Paginator<PartialModel<Trend>>;
7483
+ }
7366
7484
  /** Params of `instagram.post` (GET /v1/instagram/post). */
7367
7485
  export interface InstagramPostParams {
7368
7486
  /**
@@ -8514,8 +8632,9 @@ export declare class InstagramUsername {
8514
8632
  * Public Instagram profiles with exact follower counts, posts and reels with their likes and views, comments,
8515
8633
  * and transcripts of reels. You also get engagement rates, stories and highlight playlists, similar accounts,
8516
8634
  * hashtags and places with exact post counts, songs and original sounds with the reels that use them, topics and
8517
- * embed code. Search reels and hashtags by keyword, get Instagram's search-box suggestions, find accounts,
8518
- * places and audio in a search engine's web results, and check whether a username is free.
8635
+ * embed code, and trends: the searches Instagram promotes on its popular page. Search reels and hashtags by
8636
+ * keyword, get Instagram's search-box suggestions, find accounts, places and audio in a search engine's web
8637
+ * results, and check whether a username is free.
8519
8638
  */
8520
8639
  export declare class Instagram {
8521
8640
  /** `instagram.comment`: Text, exact likes and author, from its link. */
@@ -8538,6 +8657,8 @@ export declare class Instagram {
8538
8657
  readonly placePosts: InstagramPlacePosts;
8539
8658
  /** `instagram.playlist_stories`: Stories saved to a highlight, with media links. */
8540
8659
  readonly playlistStories: InstagramPlaylistStories;
8660
+ /** `instagram.popular_trends`: Promoted searches with exact post counts. */
8661
+ readonly popularTrends: InstagramPopularTrends;
8541
8662
  /** `instagram.post`: Post, reel or carousel with media, likes and views. */
8542
8663
  readonly post: InstagramPost;
8543
8664
  /** `instagram.posts`: Posts, reels and carousels from a profile. */
package/dist/resources.js CHANGED
@@ -446,6 +446,16 @@ export class FacebookAds {
446
446
  return this.#core._iterate("/v1/facebook/ads", { ...params }, 1, options);
447
447
  }
448
448
  }
449
+ /** `facebook.advertiser`: Advertiser profile and linked Instagram. */
450
+ export class FacebookAdvertiser {
451
+ #core;
452
+ constructor(core) {
453
+ this.#core = core;
454
+ }
455
+ get(params, options) {
456
+ return this.#core._get("/v1/facebook/advertiser", { ...params }, options);
457
+ }
458
+ }
449
459
  /** `facebook.comments`: Top-level, with exact reactions and reply counts. */
450
460
  export class FacebookComments {
451
461
  #core;
@@ -735,11 +745,12 @@ export class FacebookTranscript {
735
745
  * Messenger, Threads and the Audience Network, with creatives, run dates and advertiser. Search ads by keyword,
736
746
  * list an advertiser's ads, or get one ad with its EU and UK audience, the payer, reach and spend of political
737
747
  * and social-issue ads, and the transcript of its video. Find advertisers by name, with their Page ID and
738
- * followers. Facebook Marketplace: Public Facebook Marketplace listings with price, condition, description,
739
- * photos, seller and delivery options. Search listings by keyword around a location with Marketplace's own
740
- * filters, and find the places (cities, neighborhoods, postal codes) to search around. Facebook Events: Public
741
- * Facebook events with their dates, venue, hosts, categories, ticket link and going and interested counts. Get
742
- * one by its link, list a Page's events or a city's, or search events by keyword.
748
+ * followers, or get one advertiser's profile with the Instagram account it advertises with. Facebook
749
+ * Marketplace: Public Facebook Marketplace listings with price, condition, description, photos, seller and
750
+ * delivery options. Search listings by keyword around a location with Marketplace's own filters, and find the
751
+ * places (cities, neighborhoods, postal codes) to search around. Facebook Events: Public Facebook events with
752
+ * their dates, venue, hosts, categories, ticket link and going and interested counts. Get one by its link, list
753
+ * a Page's events or a city's, or search events by keyword.
743
754
  */
744
755
  export class Facebook {
745
756
  /** `facebook.ad`: Creatives, run dates, placements and EU reach. */
@@ -748,6 +759,8 @@ export class Facebook {
748
759
  adTranscript;
749
760
  /** `facebook.ads`: Active and past ads of one Page. */
750
761
  ads;
762
+ /** `facebook.advertiser`: Advertiser profile and linked Instagram. */
763
+ advertiser;
751
764
  /** `facebook.comments`: Top-level, with exact reactions and reply counts. */
752
765
  comments;
753
766
  /** `facebook.engagement`: Engagement rate, cadence and top posts. */
@@ -798,6 +811,7 @@ export class Facebook {
798
811
  this.ad = new FacebookAd(core);
799
812
  this.adTranscript = new FacebookAdTranscript(core);
800
813
  this.ads = new FacebookAds(core);
814
+ this.advertiser = new FacebookAdvertiser(core);
801
815
  this.comments = new FacebookComments(core);
802
816
  this.engagement = new FacebookEngagement(core);
803
817
  this.event = new FacebookEvent(core);
@@ -1541,6 +1555,19 @@ export class InstagramPlaylistStories {
1541
1555
  return this.#core._iterate("/v1/instagram/playlist_stories", { ...params }, 1, options);
1542
1556
  }
1543
1557
  }
1558
+ /** `instagram.popular_trends`: Promoted searches with exact post counts. */
1559
+ export class InstagramPopularTrends {
1560
+ #core;
1561
+ constructor(core) {
1562
+ this.#core = core;
1563
+ }
1564
+ list(params, options) {
1565
+ return this.#core._list("/v1/instagram/popular_trends", { ...params }, options);
1566
+ }
1567
+ iterate(params, options) {
1568
+ return this.#core._iterate("/v1/instagram/popular_trends", { ...params }, 1, options);
1569
+ }
1570
+ }
1544
1571
  /** `instagram.post`: Post, reel or carousel with media, likes and views. */
1545
1572
  export class InstagramPost {
1546
1573
  #core;
@@ -1760,8 +1787,9 @@ export class InstagramUsername {
1760
1787
  * Public Instagram profiles with exact follower counts, posts and reels with their likes and views, comments,
1761
1788
  * and transcripts of reels. You also get engagement rates, stories and highlight playlists, similar accounts,
1762
1789
  * hashtags and places with exact post counts, songs and original sounds with the reels that use them, topics and
1763
- * embed code. Search reels and hashtags by keyword, get Instagram's search-box suggestions, find accounts,
1764
- * places and audio in a search engine's web results, and check whether a username is free.
1790
+ * embed code, and trends: the searches Instagram promotes on its popular page. Search reels and hashtags by
1791
+ * keyword, get Instagram's search-box suggestions, find accounts, places and audio in a search engine's web
1792
+ * results, and check whether a username is free.
1765
1793
  */
1766
1794
  export class Instagram {
1767
1795
  /** `instagram.comment`: Text, exact likes and author, from its link. */
@@ -1784,6 +1812,8 @@ export class Instagram {
1784
1812
  placePosts;
1785
1813
  /** `instagram.playlist_stories`: Stories saved to a highlight, with media links. */
1786
1814
  playlistStories;
1815
+ /** `instagram.popular_trends`: Promoted searches with exact post counts. */
1816
+ popularTrends;
1787
1817
  /** `instagram.post`: Post, reel or carousel with media, likes and views. */
1788
1818
  post;
1789
1819
  /** `instagram.posts`: Posts, reels and carousels from a profile. */
@@ -1831,6 +1861,7 @@ export class Instagram {
1831
1861
  this.place = new InstagramPlace(core);
1832
1862
  this.placePosts = new InstagramPlacePosts(core);
1833
1863
  this.playlistStories = new InstagramPlaylistStories(core);
1864
+ this.popularTrends = new InstagramPopularTrends(core);
1834
1865
  this.post = new InstagramPost(core);
1835
1866
  this.posts = new InstagramPosts(core);
1836
1867
  this.profile = new InstagramProfile(core);
@@ -6,7 +6,7 @@ export declare const MCP_PROTOCOL_VERSION = "2026-07-28";
6
6
  /** Every tool, in the server's order: name, description and input JSON Schema as a model sees them. */
7
7
  export declare const TOOLS: readonly ToolDefinition[];
8
8
  /** A tool name. */
9
- export type ToolName = "find_endpoint" | "get_post" | "list_posts" | "get_profile" | "list_comments" | "get_transcript" | "get_engagement" | "search" | "call_endpoint" | "search_docs" | "read_doc" | "get_account" | "get_story" | "list_community_posts" | "list_hashtag_posts" | "list_liked_posts" | "list_place_posts" | "list_playlist_posts" | "list_reels" | "list_sound_posts" | "list_top_posts" | "list_trending_posts" | "list_channel_posts" | "list_effect_posts" | "list_feed_posts" | "list_photos" | "list_pins" | "list_playlist_stories" | "list_playlist_tracks" | "list_podcast_episodes" | "list_post_reposts" | "list_profile_mentions" | "list_shop_posts" | "list_tracks" | "list_user_favorites" | "list_user_stories" | "list_videos" | "get_seller" | "get_shop" | "list_following" | "list_followers" | "list_employees" | "list_playlist_followers" | "list_post_reactions" | "list_repository_contributors" | "list_similar_profiles" | "list_trending_profiles" | "get_comment" | "list_profile_comments" | "list_replies" | "list_issue_comments" | "get_ad_transcript" | "get_ad" | "list_ads" | "list_top_ads" | "get_hashtag" | "list_trending_hashtags" | "get_community" | "get_playlist" | "get_product" | "get_album" | "get_sound" | "get_topic" | "get_contributions" | "get_download" | "get_effect" | "get_embed" | "get_event" | "get_issue" | "get_job_posting" | "get_live" | "get_place" | "get_podcast" | "get_readme" | "get_relationship" | "get_repository" | "get_space" | "get_username" | "get_web_page" | "list_reviews" | "list_activity" | "list_boards" | "list_deal_products" | "list_events" | "list_highlights" | "list_issues" | "list_job_related_jobs" | "list_jobs" | "list_offers" | "list_pinned_repositories" | "list_place_events" | "list_playlists" | "list_products" | "list_profile_groups" | "list_profile_pull_requests" | "list_releases" | "list_repositories" | "list_schedule" | "list_shop_lists" | "list_top_albums" | "list_top_playlists" | "list_top_products" | "list_top_trends" | "list_trending_repositories" | "list_whoishiring_jobs" | "create_job" | "get_job" | "list_job_results";
9
+ export type ToolName = "find_endpoint" | "get_post" | "list_posts" | "get_profile" | "list_comments" | "get_transcript" | "get_engagement" | "search" | "call_endpoint" | "search_docs" | "read_doc" | "get_account" | "get_story" | "list_community_posts" | "list_hashtag_posts" | "list_liked_posts" | "list_place_posts" | "list_playlist_posts" | "list_reels" | "list_sound_posts" | "list_top_posts" | "list_trending_posts" | "list_channel_posts" | "list_effect_posts" | "list_feed_posts" | "list_photos" | "list_pins" | "list_playlist_stories" | "list_playlist_tracks" | "list_podcast_episodes" | "list_post_reposts" | "list_profile_mentions" | "list_shop_posts" | "list_tracks" | "list_user_favorites" | "list_user_stories" | "list_videos" | "get_advertiser" | "get_seller" | "get_shop" | "list_following" | "list_followers" | "list_employees" | "list_playlist_followers" | "list_post_reactions" | "list_repository_contributors" | "list_similar_profiles" | "list_trending_profiles" | "get_comment" | "list_profile_comments" | "list_replies" | "list_issue_comments" | "get_ad_transcript" | "get_ad" | "list_ads" | "list_top_ads" | "get_hashtag" | "list_trending_hashtags" | "get_community" | "get_playlist" | "get_product" | "get_album" | "get_sound" | "get_topic" | "get_contributions" | "get_download" | "get_effect" | "get_embed" | "get_event" | "get_issue" | "get_job_posting" | "get_live" | "get_place" | "get_podcast" | "get_readme" | "get_relationship" | "get_repository" | "get_space" | "get_username" | "get_web_page" | "list_reviews" | "list_activity" | "list_boards" | "list_deal_products" | "list_events" | "list_highlights" | "list_issues" | "list_job_related_jobs" | "list_jobs" | "list_offers" | "list_pinned_repositories" | "list_place_events" | "list_playlists" | "list_popular_trends" | "list_products" | "list_profile_groups" | "list_profile_pull_requests" | "list_releases" | "list_repositories" | "list_schedule" | "list_shop_lists" | "list_top_albums" | "list_top_playlists" | "list_top_products" | "list_top_trends" | "list_trending_repositories" | "list_whoishiring_jobs" | "create_job" | "get_job" | "list_job_results";
10
10
  /**
11
11
  * The tools a model gets by default (the server's default toolset, catalog mcp.toolsets): finding an endpoint, the
12
12
  * kinds of data most platforms have, call_endpoint for every other endpoint, the docs and the account.
package/dist/tooldefs.js CHANGED
@@ -2684,6 +2684,51 @@ export const TOOLS = [
2684
2684
  },
2685
2685
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
2686
2686
  },
2687
+ {
2688
+ name: "get_advertiser",
2689
+ title: "Advertiser by handle",
2690
+ description: "Get an advertiser. Public accounts (creators, channels, pages, companies, communities) with their bio, links, and follower and post counts. Pass handle: a profile link, @handle, username or ID. Price per successful call: 1 credit.",
2691
+ inputSchema: {
2692
+ "type": "object",
2693
+ "properties": {
2694
+ "platform": {
2695
+ "description": "Optional with a profile link, which names it; needed with a bare username or ID.",
2696
+ "enum": [
2697
+ "facebook"
2698
+ ],
2699
+ "type": "string"
2700
+ },
2701
+ "handle": {
2702
+ "description": "The advertiser: its Ad Library link (facebook.com/ads/library/?view_all_page_id=…), its Facebook Page's link or name, or its Page ID.",
2703
+ "maxLength": 2048,
2704
+ "type": "string"
2705
+ },
2706
+ "detail": {
2707
+ "default": "concise",
2708
+ "description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
2709
+ "enum": [
2710
+ "concise",
2711
+ "full"
2712
+ ],
2713
+ "type": "string"
2714
+ },
2715
+ "max_age": {
2716
+ "description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
2717
+ "minimum": 0,
2718
+ "type": "integer"
2719
+ },
2720
+ "cursor": {
2721
+ "description": "next_cursor from this tool's previous result: the rest of a cut result. Send the same other arguments.",
2722
+ "type": "string"
2723
+ }
2724
+ },
2725
+ "required": [
2726
+ "handle"
2727
+ ],
2728
+ "additionalProperties": false
2729
+ },
2730
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
2731
+ },
2687
2732
  {
2688
2733
  name: "get_seller",
2689
2734
  title: "Seller by handle",
@@ -5820,6 +5865,66 @@ export const TOOLS = [
5820
5865
  },
5821
5866
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
5822
5867
  },
5868
+ {
5869
+ name: "list_popular_trends",
5870
+ title: "Popular trends",
5871
+ description: "The popular trends, a page per call: what is trending on a platform: the searches or topics rising there, in the platform's rank order, with how they move. Pass platform; the other arguments choose the list. Price per successful page: 1 credit. Follow next_cursor while it is set; a short page is not the end.",
5872
+ inputSchema: {
5873
+ "type": "object",
5874
+ "properties": {
5875
+ "platform": {
5876
+ "description": "The platform.",
5877
+ "enum": [
5878
+ "instagram"
5879
+ ],
5880
+ "type": "string"
5881
+ },
5882
+ "section": {
5883
+ "description": "Differs by platform: find_endpoint gives each endpoint's.",
5884
+ "enum": [
5885
+ "trending_now",
5886
+ "entertainment",
5887
+ "get_inspired",
5888
+ "learn_something_new",
5889
+ "shop_the_trends",
5890
+ "trending_month",
5891
+ "browse_categories"
5892
+ ],
5893
+ "type": "string"
5894
+ },
5895
+ "limit": {
5896
+ "default": 100,
5897
+ "description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it).",
5898
+ "maximum": 100,
5899
+ "minimum": 1,
5900
+ "type": "integer"
5901
+ },
5902
+ "detail": {
5903
+ "default": "concise",
5904
+ "description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
5905
+ "enum": [
5906
+ "concise",
5907
+ "full"
5908
+ ],
5909
+ "type": "string"
5910
+ },
5911
+ "max_age": {
5912
+ "description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
5913
+ "minimum": 0,
5914
+ "type": "integer"
5915
+ },
5916
+ "cursor": {
5917
+ "description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments.",
5918
+ "type": "string"
5919
+ }
5920
+ },
5921
+ "required": [
5922
+ "platform"
5923
+ ],
5924
+ "additionalProperties": false
5925
+ },
5926
+ annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
5927
+ },
5823
5928
  {
5824
5929
  name: "list_products",
5825
5930
  title: "Products of a profile",
@@ -6764,6 +6869,7 @@ export const TOOLS = [
6764
6869
  "facebook.ad",
6765
6870
  "facebook.ad_transcript",
6766
6871
  "facebook.ads",
6872
+ "facebook.advertiser",
6767
6873
  "facebook.comments",
6768
6874
  "facebook.engagement",
6769
6875
  "facebook.event",
@@ -6834,6 +6940,7 @@ export const TOOLS = [
6834
6940
  "instagram.place",
6835
6941
  "instagram.place_posts",
6836
6942
  "instagram.playlist_stories",
6943
+ "instagram.popular_trends",
6837
6944
  "instagram.post",
6838
6945
  "instagram.posts",
6839
6946
  "instagram.profile",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "socialtap",
3
- "version": "1.575.31",
3
+ "version": "1.576.31",
4
4
  "description": "SocialTap API client: Social media scraper API. Live data from any public link.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://socialtap.dev/docs",