socialtap 1.574.31 → 1.575.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.574.31). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.575.31). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
package/dist/commands.js CHANGED
@@ -153,7 +153,7 @@ export const COMMANDS = [
153
153
  platform: "amazon",
154
154
  name: "shop_posts",
155
155
  endpoint: "amazon.shop_posts",
156
- summary: "Influencer storefront videos and photos with tagged products",
156
+ summary: "Storefront videos and photos with tagged products",
157
157
  price: "1 credit",
158
158
  params: [
159
159
  { name: "handle", type: "string", required: true, description: "The influencer's storefront: its handle (sydneydelrey, the name after /shop/ in its link, any case, with or without the @) or its link on any Amazon marketplace (amazon.com/shop/sydneydelrey, or a link to one of its photos, videos or lists), or its account ID (amzn1.account.…, the id the Amazon Shop API returns) or amazon.com/gp/profile/ link. At most 2048 characters. Example: sydneydelrey" },
@@ -499,7 +499,7 @@ export const COMMANDS = [
499
499
  platform: "facebook",
500
500
  name: "ads",
501
501
  endpoint: "facebook.ads",
502
- summary: "Active and past ads of one Page, with creatives",
502
+ summary: "Active and past ads of one Page",
503
503
  price: "1 credit",
504
504
  params: [
505
505
  { 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=20531316728&search_type=page" },
@@ -1029,7 +1029,7 @@ export const COMMANDS = [
1029
1029
  platform: "github",
1030
1030
  name: "issue_comments",
1031
1031
  endpoint: "github.issue_comments",
1032
- summary: "Issue and pull request comments with reactions and roles",
1032
+ summary: "Issue and PR comments with reactions and roles",
1033
1033
  price: "1 credit",
1034
1034
  params: [
1035
1035
  { name: "url", type: "string", required: true, description: "The issue or pull request: its link (https://github.com/golang/go/issues/70000, https://github.com/react/react/pull/27522 or any of its tabs, or api.github.com/repos/golang/go/issues/70000), or owner/name#number (golang/go#70000). Owner and name are case-insensitive; a renamed or moved repository is followed to its new name. At most 2048 characters. Example: https://github.com/golang/go/issues/70000" },
@@ -1071,7 +1071,7 @@ export const COMMANDS = [
1071
1071
  platform: "github",
1072
1072
  name: "pinned_repositories",
1073
1073
  endpoint: "github.pinned_repositories",
1074
- summary: "Repositories a user or organization pinned, in order",
1074
+ summary: "Repos a user or organization pinned, in order",
1075
1075
  price: "1 credit",
1076
1076
  params: [
1077
1077
  { name: "handle", type: "string", required: true, description: "The GitHub user or organization: its username, with or without the @; its numeric account ID, which survives a rename; or its profile link (github.com/torvalds, with any tab, github.com/orgs/vercel/repositories). At most 2048 characters. Example: torvalds" },
@@ -1248,7 +1248,7 @@ export const COMMANDS = [
1248
1248
  platform: "github",
1249
1249
  name: "search_repositories",
1250
1250
  endpoint: "github.search_repositories",
1251
- summary: "Repositories by keyword, with exact star and fork counts",
1251
+ summary: "Repos by keyword, with exact star and fork counts",
1252
1252
  price: "1 credit",
1253
1253
  params: [
1254
1254
  { name: "query", type: "string", required: true, description: "What to find, as GitHub's repository search reads it: words matched in the name, description, topics and README, a phrase in quotes, and GitHub's qualifiers (language:go, stars:>1000, topic:cli, user:torvalds, org:github, license:mit, archived:false, fork:true, pushed:>2026-01-01). A leading - leaves a word or qualifier out. Qualifiers naming @me are refused: they need a signed-in viewer. At most 1024 characters. Example: web framework language:go" },
@@ -1268,7 +1268,7 @@ export const COMMANDS = [
1268
1268
  platform: "github",
1269
1269
  name: "trending_profiles",
1270
1270
  endpoint: "github.trending_profiles",
1271
- summary: "Trending developers by language, day, week or month",
1271
+ summary: "Top developers by language, day, week or month",
1272
1272
  price: "1 credit",
1273
1273
  params: [
1274
1274
  { name: "period", type: "string", required: false, description: "The window the ranking counts over, in days back from the platform's latest update (each endpoint lists its own). The window GitHub ranks developers over: 1 (today, the default), 7 (this week) or 30 (this month), GitHub's daily, weekly and monthly boards. One of: 1, 7, 30. Default: 1. Example: 7", enum: ["1", "7", "30"] },
@@ -1286,7 +1286,7 @@ export const COMMANDS = [
1286
1286
  platform: "github",
1287
1287
  name: "trending_repositories",
1288
1288
  endpoint: "github.trending_repositories",
1289
- summary: "Trending repositories by stars gained, by language",
1289
+ summary: "Repos ranked by stars gained, by language",
1290
1290
  price: "1 credit",
1291
1291
  params: [
1292
1292
  { name: "period", type: "string", required: false, description: "The window the ranking counts over, in days back from the platform's latest update (each endpoint lists its own). The window GitHub ranks by stars gained in: 1 (today, the default), 7 (this week) or 30 (this month), GitHub's daily, weekly and monthly. One of: 1, 7, 30. Default: 1. Example: 7", enum: ["1", "7", "30"] },
@@ -1305,7 +1305,7 @@ export const COMMANDS = [
1305
1305
  platform: "google",
1306
1306
  name: "ad",
1307
1307
  endpoint: "google.ad",
1308
- summary: "Advertiser, creative and where and when it ran",
1308
+ summary: "Creative, advertiser, regions and dates",
1309
1309
  price: "1 credit",
1310
1310
  params: [
1311
1311
  { name: "url", type: "string", required: true, description: "The ad's Google Ads Transparency Center link (adstransparency.google.com/advertiser/AR…/creative/CR…), its old political ads report link, or its creative ID (CR…). At most 2048 characters. Example: https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR07443539616616939521?region=US" },
@@ -1319,7 +1319,7 @@ export const COMMANDS = [
1319
1319
  platform: "google",
1320
1320
  name: "ads",
1321
1321
  endpoint: "google.ads",
1322
- summary: "Advertiser's ads by format, service and date",
1322
+ summary: "Ads by format and date range",
1323
1323
  price: "1 credit",
1324
1324
  params: [
1325
1325
  { name: "handle", type: "string", required: true, description: "The advertiser: its Ads Transparency Center ID (AR…) or its page link (adstransparency.google.com/advertiser/AR…), in any case. At most 2048 characters. Example: AR01614014350098432001" },
@@ -1343,7 +1343,7 @@ export const COMMANDS = [
1343
1343
  platform: "google",
1344
1344
  name: "advertiser",
1345
1345
  endpoint: "google.advertiser",
1346
- summary: "Identity, verification and ad count",
1346
+ summary: "Name, verification and ad count",
1347
1347
  price: "1 credit",
1348
1348
  params: [
1349
1349
  { name: "handle", type: "string", required: true, description: "The advertiser: its Ads Transparency Center ID (AR…) or its page link (adstransparency.google.com/advertiser/AR…), in any case. At most 2048 characters. Example: AR01614014350098432001" },
@@ -1358,7 +1358,7 @@ export const COMMANDS = [
1358
1358
  platform: "google",
1359
1359
  name: "search_ads",
1360
1360
  endpoint: "google.search_ads",
1361
- summary: "Ads that lead to a website, from any advertiser",
1361
+ summary: "Ads that link to a website",
1362
1362
  price: "1 credit",
1363
1363
  params: [
1364
1364
  { name: "query", type: "string", required: true, description: "The website: its domain (lululemon.com), any link to it (https://www.lululemon.com/en-us/…), or an Ads Transparency Center domain search link (adstransparency.google.com/?domain=…). Google files ads under the registrable domain, so www. and subdomains search it (shop.lululemon.com is lululemon.com). At most 500 characters. Example: lululemon.com" },
@@ -1382,7 +1382,7 @@ export const COMMANDS = [
1382
1382
  platform: "google",
1383
1383
  name: "search_advertisers",
1384
1384
  endpoint: "google.search_advertisers",
1385
- summary: "Advertisers by name, with IDs and ad counts",
1385
+ summary: "Advertisers by name",
1386
1386
  price: "1 credit",
1387
1387
  params: [
1388
1388
  { name: "query", type: "string", required: true, description: "An advertiser's name, or a part of it, as typed into the Ads Transparency Center's search box, in any language (nike, lululemon athletica, トヨタ). Case and punctuation do not matter. At most 200 characters. Example: lululemon" },
@@ -1401,7 +1401,7 @@ export const COMMANDS = [
1401
1401
  platform: "google",
1402
1402
  name: "search_suggestions",
1403
1403
  endpoint: "google.search_suggestions",
1404
- summary: "Advertisers and websites suggested for a query",
1404
+ summary: "Advertiser autocomplete",
1405
1405
  price: "1 credit",
1406
1406
  params: [
1407
1407
  { name: "query", type: "string", required: true, description: "What to search for, as typed into the Ads Transparency Center's search box: an advertiser's name or a website's domain, or a part of either, in any language (lululemon, nike.com, トヨタ). Case does not matter. At most 200 characters. Example: lululemon" },
@@ -1568,7 +1568,7 @@ export const COMMANDS = [
1568
1568
  platform: "hackernews",
1569
1569
  name: "user_favorites",
1570
1570
  endpoint: "hackernews.user_favorites",
1571
- summary: "Stories a user saved, with exact points and comments",
1571
+ summary: "Stories a user saved, with points and comments",
1572
1572
  price: "1 credit",
1573
1573
  params: [
1574
1574
  { name: "handle", type: "string", required: true, description: "The Hacker News user: a username (case-sensitive: pg, not PG) or a link to the user's page or one of its lists (news.ycombinator.com/user?id=pg, favorites?id=pg). At most 2048 characters. Example: simonw" },
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.574.31";
2
+ export declare const VERSION = "1.575.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.574.31";
3
+ export const VERSION = "1.575.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. */
@@ -594,12 +594,12 @@ export interface AmazonShopPostsParams {
594
594
  */
595
595
  cursor?: string;
596
596
  }
597
- /** `amazon.shop_posts`: Influencer storefront videos and photos with tagged products. */
597
+ /** `amazon.shop_posts`: Storefront videos and photos with tagged products. */
598
598
  export declare class AmazonShopPosts {
599
599
  #private;
600
600
  constructor(core: Core);
601
601
  /**
602
- * Influencer storefront videos and photos with tagged products.
602
+ * Storefront videos and photos with tagged products.
603
603
  *
604
604
  * Returns an Amazon influencer's storefront videos and shoppable photos from its handle or amazon.com/shop link,
605
605
  * on any Amazon marketplace. Each post has its link, image, exact heart count, whether it is pinned, and the
@@ -745,7 +745,7 @@ export declare class Amazon {
745
745
  readonly shop: AmazonShop;
746
746
  /** `amazon.shop_lists`: Influencer idea lists with product counts and products. */
747
747
  readonly shopLists: AmazonShopLists;
748
- /** `amazon.shop_posts`: Influencer storefront videos and photos with tagged products. */
748
+ /** `amazon.shop_posts`: Storefront videos and photos with tagged products. */
749
749
  readonly shopPosts: AmazonShopPosts;
750
750
  /** `amazon.top_products`: Top 100 products of any category, ranked. */
751
751
  readonly topProducts: AmazonTopProducts;
@@ -2077,12 +2077,12 @@ export interface FacebookAdsParams {
2077
2077
  */
2078
2078
  cursor?: string;
2079
2079
  }
2080
- /** `facebook.ads`: Active and past ads of one Page, with creatives. */
2080
+ /** `facebook.ads`: Active and past ads of one Page. */
2081
2081
  export declare class FacebookAds {
2082
2082
  #private;
2083
2083
  constructor(core: Core);
2084
2084
  /**
2085
- * Active and past ads of one Page, with creatives.
2085
+ * Active and past ads of one Page.
2086
2086
  *
2087
2087
  * Returns the ads a Facebook Page ran on Facebook, Instagram, Messenger, Threads and the Audience Network, from
2088
2088
  * its link, name or Page ID. Each ad from Meta's public Ad Library has the days it first and last ran, whether
@@ -3849,7 +3849,7 @@ export declare class Facebook {
3849
3849
  readonly ad: FacebookAd;
3850
3850
  /** `facebook.ad_transcript`: Timed transcript of what a video ad says. */
3851
3851
  readonly adTranscript: FacebookAdTranscript;
3852
- /** `facebook.ads`: Active and past ads of one Page, with creatives. */
3852
+ /** `facebook.ads`: Active and past ads of one Page. */
3853
3853
  readonly ads: FacebookAds;
3854
3854
  /** `facebook.comments`: Top-level, with exact reactions and reply counts. */
3855
3855
  readonly comments: FacebookComments;
@@ -4250,12 +4250,12 @@ export interface GitHubIssueCommentsParams {
4250
4250
  */
4251
4251
  cursor?: string;
4252
4252
  }
4253
- /** `github.issue_comments`: Issue and pull request comments with reactions and roles. */
4253
+ /** `github.issue_comments`: Issue and PR comments with reactions and roles. */
4254
4254
  export declare class GitHubIssueComments {
4255
4255
  #private;
4256
4256
  constructor(core: Core);
4257
4257
  /**
4258
- * Issue and pull request comments with reactions and roles.
4258
+ * Issue and PR comments with reactions and roles.
4259
4259
  *
4260
4260
  * Returns the public comments on a GitHub issue or pull request, oldest first, from its link or
4261
4261
  * owner/name#number. Each comment has its text in Markdown, author and their role in the repository, post and
@@ -4418,12 +4418,12 @@ export interface GitHubPinnedRepositoriesParams {
4418
4418
  */
4419
4419
  cursor?: string;
4420
4420
  }
4421
- /** `github.pinned_repositories`: Repositories a user or organization pinned, in order. */
4421
+ /** `github.pinned_repositories`: Repos a user or organization pinned, in order. */
4422
4422
  export declare class GitHubPinnedRepositories {
4423
4423
  #private;
4424
4424
  constructor(core: Core);
4425
4425
  /**
4426
- * Repositories a user or organization pinned, in order.
4426
+ * Repos a user or organization pinned, in order.
4427
4427
  *
4428
4428
  * Returns the repositories a GitHub user or organization pinned to its profile, from its username, account ID or
4429
4429
  * link, in the order it chose. Each comes with its permanent ID, owner, description, main language, stars,
@@ -5157,12 +5157,12 @@ export interface GitHubSearchRepositoriesParams {
5157
5157
  */
5158
5158
  cursor?: string;
5159
5159
  }
5160
- /** `github.search_repositories`: Repositories by keyword, with exact star and fork counts. */
5160
+ /** `github.search_repositories`: Repos by keyword, with exact star and fork counts. */
5161
5161
  export declare class GitHubSearchRepositories {
5162
5162
  #private;
5163
5163
  constructor(core: Core);
5164
5164
  /**
5165
- * Repositories by keyword, with exact star and fork counts.
5165
+ * Repos by keyword, with exact star and fork counts.
5166
5166
  *
5167
5167
  * Returns the public GitHub repositories a search finds, from keywords and GitHub's own qualifiers such as
5168
5168
  * language, stars, topic and owner, by best match, most stars or latest push. Each comes with its owner,
@@ -5233,12 +5233,12 @@ export interface GitHubTrendingProfilesParams {
5233
5233
  */
5234
5234
  cursor?: string;
5235
5235
  }
5236
- /** `github.trending_profiles`: Trending developers by language, day, week or month. */
5236
+ /** `github.trending_profiles`: Top developers by language, day, week or month. */
5237
5237
  export declare class GitHubTrendingProfiles {
5238
5238
  #private;
5239
5239
  constructor(core: Core);
5240
5240
  /**
5241
- * Trending developers by language, day, week or month.
5241
+ * Top developers by language, day, week or month.
5242
5242
  *
5243
5243
  * Returns GitHub's trending developers in rank order, for today, this week or this month, across every language
5244
5244
  * or one programming language. Each developer has their username, numeric ID, name, avatar and profile link, and
@@ -5313,12 +5313,12 @@ export interface GitHubTrendingRepositoriesParams {
5313
5313
  */
5314
5314
  cursor?: string;
5315
5315
  }
5316
- /** `github.trending_repositories`: Trending repositories by stars gained, by language. */
5316
+ /** `github.trending_repositories`: Repos ranked by stars gained, by language. */
5317
5317
  export declare class GitHubTrendingRepositories {
5318
5318
  #private;
5319
5319
  constructor(core: Core);
5320
5320
  /**
5321
- * Trending repositories by stars gained, by language.
5321
+ * Repos ranked by stars gained, by language.
5322
5322
  *
5323
5323
  * Returns GitHub's trending repositories in GitHub's order, for today, this week or this month, optionally for
5324
5324
  * one programming language and one spoken language. Each repository has its ID, name, owner, description,
@@ -5372,11 +5372,11 @@ export declare class GitHub {
5372
5372
  readonly following: GitHubFollowing;
5373
5373
  /** `github.issue`: Issue or pull request with state, branches and changes. */
5374
5374
  readonly issue: GitHubIssue;
5375
- /** `github.issue_comments`: Issue and pull request comments with reactions and roles. */
5375
+ /** `github.issue_comments`: Issue and PR comments with reactions and roles. */
5376
5376
  readonly issueComments: GitHubIssueComments;
5377
5377
  /** `github.issues`: A repository's issues and pull requests. */
5378
5378
  readonly issues: GitHubIssues;
5379
- /** `github.pinned_repositories`: Repositories a user or organization pinned, in order. */
5379
+ /** `github.pinned_repositories`: Repos a user or organization pinned, in order. */
5380
5380
  readonly pinnedRepositories: GitHubPinnedRepositories;
5381
5381
  /** `github.profile`: Bio, company, links and exact follower counts. */
5382
5382
  readonly profile: GitHubProfile;
@@ -5396,11 +5396,11 @@ export declare class GitHub {
5396
5396
  readonly searchIssues: GitHubSearchIssues;
5397
5397
  /** `github.search_profiles`: Developers and organizations by keyword or location. */
5398
5398
  readonly searchProfiles: GitHubSearchProfiles;
5399
- /** `github.search_repositories`: Repositories by keyword, with exact star and fork counts. */
5399
+ /** `github.search_repositories`: Repos by keyword, with exact star and fork counts. */
5400
5400
  readonly searchRepositories: GitHubSearchRepositories;
5401
- /** `github.trending_profiles`: Trending developers by language, day, week or month. */
5401
+ /** `github.trending_profiles`: Top developers by language, day, week or month. */
5402
5402
  readonly trendingProfiles: GitHubTrendingProfiles;
5403
- /** `github.trending_repositories`: Trending repositories by stars gained, by language. */
5403
+ /** `github.trending_repositories`: Repos ranked by stars gained, by language. */
5404
5404
  readonly trendingRepositories: GitHubTrendingRepositories;
5405
5405
  constructor(core: Core);
5406
5406
  }
@@ -5425,12 +5425,12 @@ export interface GoogleAdParams {
5425
5425
  */
5426
5426
  fields?: string;
5427
5427
  }
5428
- /** `google.ad`: Advertiser, creative and where and when it ran. */
5428
+ /** `google.ad`: Creative, advertiser, regions and dates. */
5429
5429
  export declare class GoogleAd {
5430
5430
  #private;
5431
5431
  constructor(core: Core);
5432
5432
  /**
5433
- * Advertiser, creative and where and when it ran.
5433
+ * Creative, advertiser, regions and dates.
5434
5434
  *
5435
5435
  * Returns one ad from Google's public Ads Transparency Center by its link or creative ID, with its advertiser,
5436
5436
  * creative and where and when it ran. You also get whether the advertiser verified its identity, who paid, the
@@ -5515,12 +5515,12 @@ export interface GoogleAdsParams {
5515
5515
  */
5516
5516
  cursor?: string;
5517
5517
  }
5518
- /** `google.ads`: Advertiser's ads by format, service and date. */
5518
+ /** `google.ads`: Ads by format and date range. */
5519
5519
  export declare class GoogleAds {
5520
5520
  #private;
5521
5521
  constructor(core: Core);
5522
5522
  /**
5523
- * Advertiser's ads by format, service and date.
5523
+ * Ads by format and date range.
5524
5524
  *
5525
5525
  * Returns the ads one advertiser ran on Google Search, YouTube, Maps, Play and Shopping, from the Ads
5526
5526
  * Transparency Center, by advertiser ID or link. Each ad has its format, image, first and last day shown and
@@ -5580,12 +5580,12 @@ export interface GoogleAdvertiserParams {
5580
5580
  */
5581
5581
  fields?: string;
5582
5582
  }
5583
- /** `google.advertiser`: Identity, verification and ad count. */
5583
+ /** `google.advertiser`: Name, verification and ad count. */
5584
5584
  export declare class GoogleAdvertiser {
5585
5585
  #private;
5586
5586
  constructor(core: Core);
5587
5587
  /**
5588
- * Identity, verification and ad count.
5588
+ * Name, verification and ad count.
5589
5589
  *
5590
5590
  * Returns one Google Ads Transparency Center advertiser by its ID or page link: name, legal name, country,
5591
5591
  * verification and how many ads it has shown. The ad count is Google's range, overall or in one country, with
@@ -5669,12 +5669,12 @@ export interface GoogleSearchAdsParams {
5669
5669
  */
5670
5670
  cursor?: string;
5671
5671
  }
5672
- /** `google.search_ads`: Ads that lead to a website, from any advertiser. */
5672
+ /** `google.search_ads`: Ads that link to a website. */
5673
5673
  export declare class GoogleSearchAds {
5674
5674
  #private;
5675
5675
  constructor(core: Core);
5676
5676
  /**
5677
- * Ads that lead to a website, from any advertiser.
5677
+ * Ads that link to a website.
5678
5678
  *
5679
5679
  * Returns the ads that lead to a website, from every advertiser that runs them, in Google's Ads Transparency
5680
5680
  * Center, by domain or any link to it. Each ad has its advertiser (ID, name and verification), format, image and
@@ -5749,12 +5749,12 @@ export interface GoogleSearchAdvertisersParams {
5749
5749
  */
5750
5750
  cursor?: string;
5751
5751
  }
5752
- /** `google.search_advertisers`: Advertisers by name, with IDs and ad counts. */
5752
+ /** `google.search_advertisers`: Advertisers by name. */
5753
5753
  export declare class GoogleSearchAdvertisers {
5754
5754
  #private;
5755
5755
  constructor(core: Core);
5756
5756
  /**
5757
- * Advertisers by name, with IDs and ad counts.
5757
+ * Advertisers by name.
5758
5758
  *
5759
5759
  * Returns the Google Ads Transparency Center advertisers whose name matches a query, every match rather than the
5760
5760
  * search box's first ten. Each advertiser has its AR ID (the one its ads and page use), name, country,
@@ -5825,12 +5825,12 @@ export interface GoogleSearchSuggestionsParams {
5825
5825
  */
5826
5826
  cursor?: string;
5827
5827
  }
5828
- /** `google.search_suggestions`: Advertisers and websites suggested for a query. */
5828
+ /** `google.search_suggestions`: Advertiser autocomplete. */
5829
5829
  export declare class GoogleSearchSuggestions {
5830
5830
  #private;
5831
5831
  constructor(core: Core);
5832
5832
  /**
5833
- * Advertisers and websites suggested for a query.
5833
+ * Advertiser autocomplete.
5834
5834
  *
5835
5835
  * Returns what the Google Ads Transparency Center search box suggests for a query, in its order: matching
5836
5836
  * advertisers, then websites with ads. Each advertiser has its AR ID, name, country, verification badge and ad
@@ -5877,17 +5877,17 @@ export declare class GoogleSearchSuggestions {
5877
5877
  * advertisers and websites.
5878
5878
  */
5879
5879
  export declare class Google {
5880
- /** `google.ad`: Advertiser, creative and where and when it ran. */
5880
+ /** `google.ad`: Creative, advertiser, regions and dates. */
5881
5881
  readonly ad: GoogleAd;
5882
- /** `google.ads`: Advertiser's ads by format, service and date. */
5882
+ /** `google.ads`: Ads by format and date range. */
5883
5883
  readonly ads: GoogleAds;
5884
- /** `google.advertiser`: Identity, verification and ad count. */
5884
+ /** `google.advertiser`: Name, verification and ad count. */
5885
5885
  readonly advertiser: GoogleAdvertiser;
5886
- /** `google.search_ads`: Ads that lead to a website, from any advertiser. */
5886
+ /** `google.search_ads`: Ads that link to a website. */
5887
5887
  readonly searchAds: GoogleSearchAds;
5888
- /** `google.search_advertisers`: Advertisers by name, with IDs and ad counts. */
5888
+ /** `google.search_advertisers`: Advertisers by name. */
5889
5889
  readonly searchAdvertisers: GoogleSearchAdvertisers;
5890
- /** `google.search_suggestions`: Advertisers and websites suggested for a query. */
5890
+ /** `google.search_suggestions`: Advertiser autocomplete. */
5891
5891
  readonly searchSuggestions: GoogleSearchSuggestions;
5892
5892
  constructor(core: Core);
5893
5893
  }
@@ -6508,12 +6508,12 @@ export interface HackerNewsUserFavoritesParams {
6508
6508
  */
6509
6509
  cursor?: string;
6510
6510
  }
6511
- /** `hackernews.user_favorites`: Stories a user saved, with exact points and comments. */
6511
+ /** `hackernews.user_favorites`: Stories a user saved, with points and comments. */
6512
6512
  export declare class HackerNewsUserFavorites {
6513
6513
  #private;
6514
6514
  constructor(core: Core);
6515
6515
  /**
6516
- * Stories a user saved, with exact points and comments.
6516
+ * Stories a user saved, with points and comments.
6517
6517
  *
6518
6518
  * Returns the stories a Hacker News user marked as favorites, from a username or a link to the user. Each story
6519
6519
  * comes with its title, the page it links to, its text as plain text, exact points and comment count, the author
@@ -6736,7 +6736,7 @@ export declare class HackerNews {
6736
6736
  readonly user: HackerNewsUser;
6737
6737
  /** `hackernews.user_comments`: Every comment a user wrote, newest first. */
6738
6738
  readonly userComments: HackerNewsUserComments;
6739
- /** `hackernews.user_favorites`: Stories a user saved, with exact points and comments. */
6739
+ /** `hackernews.user_favorites`: Stories a user saved, with points and comments. */
6740
6740
  readonly userFavorites: HackerNewsUserFavorites;
6741
6741
  /** `hackernews.user_stories`: Every story a user posted, newest first. */
6742
6742
  readonly userStories: HackerNewsUserStories;
package/dist/resources.js CHANGED
@@ -96,7 +96,7 @@ export class AmazonShopLists {
96
96
  return this.#core._iterate("/v1/amazon/shop_lists", { ...params }, 1, options);
97
97
  }
98
98
  }
99
- /** `amazon.shop_posts`: Influencer storefront videos and photos with tagged products. */
99
+ /** `amazon.shop_posts`: Storefront videos and photos with tagged products. */
100
100
  export class AmazonShopPosts {
101
101
  #core;
102
102
  constructor(core) {
@@ -149,7 +149,7 @@ export class Amazon {
149
149
  shop;
150
150
  /** `amazon.shop_lists`: Influencer idea lists with product counts and products. */
151
151
  shopLists;
152
- /** `amazon.shop_posts`: Influencer storefront videos and photos with tagged products. */
152
+ /** `amazon.shop_posts`: Storefront videos and photos with tagged products. */
153
153
  shopPosts;
154
154
  /** `amazon.top_products`: Top 100 products of any category, ranked. */
155
155
  topProducts;
@@ -433,7 +433,7 @@ export class FacebookAdTranscript {
433
433
  return this.#core._get("/v1/facebook/ad_transcript", { ...params }, this.#core._long(options));
434
434
  }
435
435
  }
436
- /** `facebook.ads`: Active and past ads of one Page, with creatives. */
436
+ /** `facebook.ads`: Active and past ads of one Page. */
437
437
  export class FacebookAds {
438
438
  #core;
439
439
  constructor(core) {
@@ -746,7 +746,7 @@ export class Facebook {
746
746
  ad;
747
747
  /** `facebook.ad_transcript`: Timed transcript of what a video ad says. */
748
748
  adTranscript;
749
- /** `facebook.ads`: Active and past ads of one Page, with creatives. */
749
+ /** `facebook.ads`: Active and past ads of one Page. */
750
750
  ads;
751
751
  /** `facebook.comments`: Top-level, with exact reactions and reply counts. */
752
752
  comments;
@@ -882,7 +882,7 @@ export class GitHubIssue {
882
882
  return this.#core._get("/v1/github/issue", { ...params }, options);
883
883
  }
884
884
  }
885
- /** `github.issue_comments`: Issue and pull request comments with reactions and roles. */
885
+ /** `github.issue_comments`: Issue and PR comments with reactions and roles. */
886
886
  export class GitHubIssueComments {
887
887
  #core;
888
888
  constructor(core) {
@@ -908,7 +908,7 @@ export class GitHubIssues {
908
908
  return this.#core._iterate("/v1/github/issues", { ...params }, 1, options);
909
909
  }
910
910
  }
911
- /** `github.pinned_repositories`: Repositories a user or organization pinned, in order. */
911
+ /** `github.pinned_repositories`: Repos a user or organization pinned, in order. */
912
912
  export class GitHubPinnedRepositories {
913
913
  #core;
914
914
  constructor(core) {
@@ -1029,7 +1029,7 @@ export class GitHubSearchProfiles {
1029
1029
  return this.#core._iterate("/v1/github/search_profiles", { ...params }, 1, options);
1030
1030
  }
1031
1031
  }
1032
- /** `github.search_repositories`: Repositories by keyword, with exact star and fork counts. */
1032
+ /** `github.search_repositories`: Repos by keyword, with exact star and fork counts. */
1033
1033
  export class GitHubSearchRepositories {
1034
1034
  #core;
1035
1035
  constructor(core) {
@@ -1042,7 +1042,7 @@ export class GitHubSearchRepositories {
1042
1042
  return this.#core._iterate("/v1/github/search_repositories", { ...params }, 1, options);
1043
1043
  }
1044
1044
  }
1045
- /** `github.trending_profiles`: Trending developers by language, day, week or month. */
1045
+ /** `github.trending_profiles`: Top developers by language, day, week or month. */
1046
1046
  export class GitHubTrendingProfiles {
1047
1047
  #core;
1048
1048
  constructor(core) {
@@ -1055,7 +1055,7 @@ export class GitHubTrendingProfiles {
1055
1055
  return this.#core._iterate("/v1/github/trending_profiles", { ...params }, 1, options);
1056
1056
  }
1057
1057
  }
1058
- /** `github.trending_repositories`: Trending repositories by stars gained, by language. */
1058
+ /** `github.trending_repositories`: Repos ranked by stars gained, by language. */
1059
1059
  export class GitHubTrendingRepositories {
1060
1060
  #core;
1061
1061
  constructor(core) {
@@ -1088,11 +1088,11 @@ export class GitHub {
1088
1088
  following;
1089
1089
  /** `github.issue`: Issue or pull request with state, branches and changes. */
1090
1090
  issue;
1091
- /** `github.issue_comments`: Issue and pull request comments with reactions and roles. */
1091
+ /** `github.issue_comments`: Issue and PR comments with reactions and roles. */
1092
1092
  issueComments;
1093
1093
  /** `github.issues`: A repository's issues and pull requests. */
1094
1094
  issues;
1095
- /** `github.pinned_repositories`: Repositories a user or organization pinned, in order. */
1095
+ /** `github.pinned_repositories`: Repos a user or organization pinned, in order. */
1096
1096
  pinnedRepositories;
1097
1097
  /** `github.profile`: Bio, company, links and exact follower counts. */
1098
1098
  profile;
@@ -1112,11 +1112,11 @@ export class GitHub {
1112
1112
  searchIssues;
1113
1113
  /** `github.search_profiles`: Developers and organizations by keyword or location. */
1114
1114
  searchProfiles;
1115
- /** `github.search_repositories`: Repositories by keyword, with exact star and fork counts. */
1115
+ /** `github.search_repositories`: Repos by keyword, with exact star and fork counts. */
1116
1116
  searchRepositories;
1117
- /** `github.trending_profiles`: Trending developers by language, day, week or month. */
1117
+ /** `github.trending_profiles`: Top developers by language, day, week or month. */
1118
1118
  trendingProfiles;
1119
- /** `github.trending_repositories`: Trending repositories by stars gained, by language. */
1119
+ /** `github.trending_repositories`: Repos ranked by stars gained, by language. */
1120
1120
  trendingRepositories;
1121
1121
  constructor(core) {
1122
1122
  this.activity = new GitHubActivity(core);
@@ -1141,7 +1141,7 @@ export class GitHub {
1141
1141
  this.trendingRepositories = new GitHubTrendingRepositories(core);
1142
1142
  }
1143
1143
  }
1144
- /** `google.ad`: Advertiser, creative and where and when it ran. */
1144
+ /** `google.ad`: Creative, advertiser, regions and dates. */
1145
1145
  export class GoogleAd {
1146
1146
  #core;
1147
1147
  constructor(core) {
@@ -1151,7 +1151,7 @@ export class GoogleAd {
1151
1151
  return this.#core._get("/v1/google/ad", { ...params }, options);
1152
1152
  }
1153
1153
  }
1154
- /** `google.ads`: Advertiser's ads by format, service and date. */
1154
+ /** `google.ads`: Ads by format and date range. */
1155
1155
  export class GoogleAds {
1156
1156
  #core;
1157
1157
  constructor(core) {
@@ -1164,7 +1164,7 @@ export class GoogleAds {
1164
1164
  return this.#core._iterate("/v1/google/ads", { ...params }, 1, options);
1165
1165
  }
1166
1166
  }
1167
- /** `google.advertiser`: Identity, verification and ad count. */
1167
+ /** `google.advertiser`: Name, verification and ad count. */
1168
1168
  export class GoogleAdvertiser {
1169
1169
  #core;
1170
1170
  constructor(core) {
@@ -1174,7 +1174,7 @@ export class GoogleAdvertiser {
1174
1174
  return this.#core._get("/v1/google/advertiser", { ...params }, options);
1175
1175
  }
1176
1176
  }
1177
- /** `google.search_ads`: Ads that lead to a website, from any advertiser. */
1177
+ /** `google.search_ads`: Ads that link to a website. */
1178
1178
  export class GoogleSearchAds {
1179
1179
  #core;
1180
1180
  constructor(core) {
@@ -1187,7 +1187,7 @@ export class GoogleSearchAds {
1187
1187
  return this.#core._iterate("/v1/google/search_ads", { ...params }, 1, options);
1188
1188
  }
1189
1189
  }
1190
- /** `google.search_advertisers`: Advertisers by name, with IDs and ad counts. */
1190
+ /** `google.search_advertisers`: Advertisers by name. */
1191
1191
  export class GoogleSearchAdvertisers {
1192
1192
  #core;
1193
1193
  constructor(core) {
@@ -1200,7 +1200,7 @@ export class GoogleSearchAdvertisers {
1200
1200
  return this.#core._iterate("/v1/google/search_advertisers", { ...params }, 1, options);
1201
1201
  }
1202
1202
  }
1203
- /** `google.search_suggestions`: Advertisers and websites suggested for a query. */
1203
+ /** `google.search_suggestions`: Advertiser autocomplete. */
1204
1204
  export class GoogleSearchSuggestions {
1205
1205
  #core;
1206
1206
  constructor(core) {
@@ -1226,17 +1226,17 @@ export class GoogleSearchSuggestions {
1226
1226
  * advertisers and websites.
1227
1227
  */
1228
1228
  export class Google {
1229
- /** `google.ad`: Advertiser, creative and where and when it ran. */
1229
+ /** `google.ad`: Creative, advertiser, regions and dates. */
1230
1230
  ad;
1231
- /** `google.ads`: Advertiser's ads by format, service and date. */
1231
+ /** `google.ads`: Ads by format and date range. */
1232
1232
  ads;
1233
- /** `google.advertiser`: Identity, verification and ad count. */
1233
+ /** `google.advertiser`: Name, verification and ad count. */
1234
1234
  advertiser;
1235
- /** `google.search_ads`: Ads that lead to a website, from any advertiser. */
1235
+ /** `google.search_ads`: Ads that link to a website. */
1236
1236
  searchAds;
1237
- /** `google.search_advertisers`: Advertisers by name, with IDs and ad counts. */
1237
+ /** `google.search_advertisers`: Advertisers by name. */
1238
1238
  searchAdvertisers;
1239
- /** `google.search_suggestions`: Advertisers and websites suggested for a query. */
1239
+ /** `google.search_suggestions`: Advertiser autocomplete. */
1240
1240
  searchSuggestions;
1241
1241
  constructor(core) {
1242
1242
  this.ad = new GoogleAd(core);
@@ -1342,7 +1342,7 @@ export class HackerNewsUserComments {
1342
1342
  return this.#core._iterate("/v1/hackernews/user_comments", { ...params }, 1, options);
1343
1343
  }
1344
1344
  }
1345
- /** `hackernews.user_favorites`: Stories a user saved, with exact points and comments. */
1345
+ /** `hackernews.user_favorites`: Stories a user saved, with points and comments. */
1346
1346
  export class HackerNewsUserFavorites {
1347
1347
  #core;
1348
1348
  constructor(core) {
@@ -1406,7 +1406,7 @@ export class HackerNews {
1406
1406
  user;
1407
1407
  /** `hackernews.user_comments`: Every comment a user wrote, newest first. */
1408
1408
  userComments;
1409
- /** `hackernews.user_favorites`: Stories a user saved, with exact points and comments. */
1409
+ /** `hackernews.user_favorites`: Stories a user saved, with points and comments. */
1410
1410
  userFavorites;
1411
1411
  /** `hackernews.user_stories`: Every story a user posted, newest first. */
1412
1412
  userStories;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "socialtap",
3
- "version": "1.574.31",
3
+ "version": "1.575.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",