socialtap 1.509.29 → 1.529.29
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -1
- package/dist/client.d.ts +19 -16
- package/dist/client.js +20 -16
- package/dist/commands.js +260 -1
- package/dist/constants.d.ts +6 -1
- package/dist/constants.js +2 -1
- package/dist/errors.d.ts +9 -0
- package/dist/errors.js +9 -0
- package/dist/models.d.ts +688 -2
- package/dist/resources.d.ts +1073 -4
- package/dist/resources.js +241 -0
- package/dist/tooldefs.d.ts +1 -1
- package/dist/tooldefs.js +611 -18
- package/package.json +1 -1
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.
|
|
8
|
+
Generated from the SocialTap catalog (version 1.529.29). Docs: https://socialtap.dev/docs.
|
|
9
9
|
|
|
10
10
|
## Install
|
|
11
11
|
|
|
@@ -148,6 +148,21 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
|
|
|
148
148
|
| `facebook.search_posts` | `client.facebook.searchPosts.list()` | 1 credit + 1 per result filled in |
|
|
149
149
|
| `facebook.search_profiles` | `client.facebook.searchProfiles.list()` | 1 credit + 1 per result filled in |
|
|
150
150
|
| `facebook.transcript` | `client.facebook.transcript.get()` | 1 credit (captions) or 2 credits + 2 per started minute of media (speech-to-text) |
|
|
151
|
+
| `github.activity` | `client.github.activity.list()` | 1 credit |
|
|
152
|
+
| `github.contributions` | `client.github.contributions.get()` | 1 credit |
|
|
153
|
+
| `github.followers` | `client.github.followers.list()` | 1 credit |
|
|
154
|
+
| `github.following` | `client.github.following.list()` | 1 credit |
|
|
155
|
+
| `github.pinned_repositories` | `client.github.pinnedRepositories.list()` | 1 credit |
|
|
156
|
+
| `github.profile` | `client.github.profile.get()` | 1 credit |
|
|
157
|
+
| `github.readme` | `client.github.readme.get()` | 1 credit |
|
|
158
|
+
| `github.releases` | `client.github.releases.list()` | 1 credit |
|
|
159
|
+
| `github.repositories` | `client.github.repositories.list()` | 1 credit |
|
|
160
|
+
| `github.repository` | `client.github.repository.get()` | 1 credit |
|
|
161
|
+
| `github.repository_contributors` | `client.github.repositoryContributors.list()` | 1 credit |
|
|
162
|
+
| `github.search_profiles` | `client.github.searchProfiles.list()` | 1 credit |
|
|
163
|
+
| `github.search_repositories` | `client.github.searchRepositories.list()` | 1 credit |
|
|
164
|
+
| `github.trending_profiles` | `client.github.trendingProfiles.list()` | 1 credit |
|
|
165
|
+
| `github.trending_repositories` | `client.github.trendingRepositories.list()` | 1 credit |
|
|
151
166
|
| `google.ad` | `client.google.ad.get()` | 1 credit |
|
|
152
167
|
| `google.ads` | `client.google.ads.list()` | 1 credit |
|
|
153
168
|
| `google.advertiser` | `client.google.advertiser.get()` | 1 credit |
|
|
@@ -369,6 +384,7 @@ try {
|
|
|
369
384
|
| `no_transcript` | `NoTranscriptError` | 404 | no |
|
|
370
385
|
| `no_live` | `NoLiveError` | 404 | no |
|
|
371
386
|
| `no_media` | `NoMediaError` | 404 | no |
|
|
387
|
+
| `no_readme` | `NoReadmeError` | 404 | no |
|
|
372
388
|
| `upstream_blocked` | `UpstreamBlockedError` | 503 | yes |
|
|
373
389
|
| `upstream_error` | `UpstreamError` | 502 | yes |
|
|
374
390
|
| `overloaded` | `OverloadedError` | 503 | yes |
|
|
@@ -530,7 +546,9 @@ console.log(r.isError, r.output);
|
|
|
530
546
|
| `get_shop` | Shop by handle |
|
|
531
547
|
| `list_followers` | Followers of a profile |
|
|
532
548
|
| `list_following` | Following of a profile |
|
|
549
|
+
| `list_repository_contributors` | Repository contributors |
|
|
533
550
|
| `list_similar_profiles` | Similar profiles of a profile |
|
|
551
|
+
| `list_trending_profiles` | Trending profiles |
|
|
534
552
|
| `get_comment` | Comment by link |
|
|
535
553
|
| `list_replies` | Replies of a post |
|
|
536
554
|
| `list_profile_comments` | Profile comments |
|
|
@@ -546,6 +564,7 @@ console.log(r.isError, r.output);
|
|
|
546
564
|
| `get_playlist` | Playlist by link |
|
|
547
565
|
| `get_sound` | Sound by link |
|
|
548
566
|
| `get_topic` | Topic by link |
|
|
567
|
+
| `get_contributions` | Contributions by handle |
|
|
549
568
|
| `get_download` | Download by link |
|
|
550
569
|
| `get_effect` | Effect by link |
|
|
551
570
|
| `get_embed` | Embed by link |
|
|
@@ -553,23 +572,30 @@ console.log(r.isError, r.output);
|
|
|
553
572
|
| `get_live` | Live by handle |
|
|
554
573
|
| `get_place` | Place by link |
|
|
555
574
|
| `get_podcast` | Podcast by link |
|
|
575
|
+
| `get_readme` | Readme by link |
|
|
576
|
+
| `get_repository` | Repository by link |
|
|
556
577
|
| `get_username` | Username by handle |
|
|
557
578
|
| `get_web_page` | Web page by link |
|
|
558
579
|
| `list_reviews` | Reviews of a product |
|
|
580
|
+
| `list_activity` | Activity of a profile |
|
|
559
581
|
| `list_boards` | Boards of a profile |
|
|
560
582
|
| `list_deal_products` | Deal products |
|
|
561
583
|
| `list_events` | Events of a profile |
|
|
562
584
|
| `list_highlights` | Highlights of a profile |
|
|
563
585
|
| `list_offers` | Offers of a product |
|
|
586
|
+
| `list_pinned_repositories` | Pinned repositories of a profile |
|
|
564
587
|
| `list_place_events` | Place events |
|
|
565
588
|
| `list_playlists` | Playlists of a profile |
|
|
566
589
|
| `list_products` | Products of a profile |
|
|
590
|
+
| `list_releases` | Releases of a repository |
|
|
591
|
+
| `list_repositories` | Repositories of a profile |
|
|
567
592
|
| `list_schedule` | Schedule of a profile |
|
|
568
593
|
| `list_shop_lists` | Shop lists of a profile |
|
|
569
594
|
| `list_top_albums` | Top albums |
|
|
570
595
|
| `list_top_playlists` | Top playlists |
|
|
571
596
|
| `list_top_products` | Top products |
|
|
572
597
|
| `list_top_trends` | Top trends |
|
|
598
|
+
| `list_trending_repositories` | Trending repositories |
|
|
573
599
|
| `create_job` | Create a background job |
|
|
574
600
|
| `get_job` | Get a background job |
|
|
575
601
|
| `list_job_results` | List a job's results |
|
package/dist/client.d.ts
CHANGED
|
@@ -1,25 +1,26 @@
|
|
|
1
1
|
import { type ClientOptions, Core } from "./core.ts";
|
|
2
|
-
import { Amazon, AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.ts";
|
|
2
|
+
import { Amazon, AppleMusic, Bluesky, Facebook, GitHub, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.ts";
|
|
3
3
|
import { Webhooks } from "./webhooks.ts";
|
|
4
4
|
/**
|
|
5
5
|
* The SocialTap API client: `new SocialTap({ apiKey })` (default: the SOCIALTAP_API_KEY environment variable).
|
|
6
6
|
*
|
|
7
7
|
* SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a
|
|
8
|
-
* search and get live data back in one schema. Failed requests are free. Available now:
|
|
9
|
-
* LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
|
|
10
|
-
* Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X;
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
* TikTok; podcasts on Spotify; posts on Amazon, Apple
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
8
|
+
* search and get live data back in one schema. Failed requests are free. Available now: activity on GitHub; ads
|
|
9
|
+
* on Facebook, Google, LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
|
|
10
|
+
* Instagram, Reddit, Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X;
|
|
11
|
+
* contribution calendars on GitHub; downloads on TikTok; effects on TikTok; embeds on Instagram; engagement
|
|
12
|
+
* stats on Facebook, Instagram, Reddit, Rumble, TikTok and YouTube; events on Facebook; hashtags on Instagram
|
|
13
|
+
* and TikTok; livestreams on TikTok and Twitch; offers on Amazon; places on Facebook and Instagram; playlists on
|
|
14
|
+
* Amazon, Apple Music, Instagram, Pinterest, Spotify and TikTok; podcasts on Spotify; posts on Amazon, Apple
|
|
15
|
+
* Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud,
|
|
16
|
+
* Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and
|
|
17
|
+
* TikTok Shop; profiles on Amazon, Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai,
|
|
18
|
+
* LinkedIn, Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify,
|
|
19
|
+
* Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; readmes on GitHub; releases on GitHub;
|
|
20
|
+
* repositories on GitHub; reviews on Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on
|
|
21
|
+
* Google, Instagram and TikTok; topics on Instagram and Pinterest; transcripts on Facebook, Instagram, Kick,
|
|
22
|
+
* Reddit, Rumble, TikTok, Twitch and YouTube; trends on Pinterest; usernames on Instagram; web pages on
|
|
23
|
+
* Pinterest; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
|
|
23
24
|
*/
|
|
24
25
|
export declare class SocialTap extends Core {
|
|
25
26
|
/** Amazon endpoints. */
|
|
@@ -30,6 +31,8 @@ export declare class SocialTap extends Core {
|
|
|
30
31
|
readonly bluesky: Bluesky;
|
|
31
32
|
/** Facebook endpoints. */
|
|
32
33
|
readonly facebook: Facebook;
|
|
34
|
+
/** GitHub endpoints. */
|
|
35
|
+
readonly github: GitHub;
|
|
33
36
|
/** Google endpoints. */
|
|
34
37
|
readonly google: Google;
|
|
35
38
|
/** Instagram endpoints. */
|
package/dist/client.js
CHANGED
|
@@ -1,26 +1,27 @@
|
|
|
1
1
|
// Code generated by engine/cmd/gensdk (make gen) from catalog/catalog.gen.json; DO NOT EDIT.
|
|
2
2
|
import { Core } from "./core.js";
|
|
3
|
-
import { Amazon, AppleMusic, Bluesky, Facebook, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.js";
|
|
3
|
+
import { Amazon, AppleMusic, Bluesky, Facebook, GitHub, Google, Instagram, Kick, Komi, Kwai, LnkBio, LinkedIn, Linkme, Linktree, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, TikTokShop, TruthSocial, Twitch, X, YouTube, AccountResource, UsageResource, CreditTransactionsResource, BillingResource, RequestsResource, ApiKeysResource, JobsResource, WebhookEndpointsResource, EventsResource, NotificationPreferencesResource } from "./resources.js";
|
|
4
4
|
import { Webhooks } from "./webhooks.js";
|
|
5
5
|
/**
|
|
6
6
|
* The SocialTap API client: `new SocialTap({ apiKey })` (default: the SOCIALTAP_API_KEY environment variable).
|
|
7
7
|
*
|
|
8
8
|
* SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a
|
|
9
|
-
* search and get live data back in one schema. Failed requests are free. Available now:
|
|
10
|
-
* LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
|
|
11
|
-
* Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X;
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
* TikTok; podcasts on Spotify; posts on Amazon, Apple
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
9
|
+
* search and get live data back in one schema. Failed requests are free. Available now: activity on GitHub; ads
|
|
10
|
+
* on Facebook, Google, LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
|
|
11
|
+
* Instagram, Reddit, Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook, Reddit and X;
|
|
12
|
+
* contribution calendars on GitHub; downloads on TikTok; effects on TikTok; embeds on Instagram; engagement
|
|
13
|
+
* stats on Facebook, Instagram, Reddit, Rumble, TikTok and YouTube; events on Facebook; hashtags on Instagram
|
|
14
|
+
* and TikTok; livestreams on TikTok and Twitch; offers on Amazon; places on Facebook and Instagram; playlists on
|
|
15
|
+
* Amazon, Apple Music, Instagram, Pinterest, Spotify and TikTok; podcasts on Spotify; posts on Amazon, Apple
|
|
16
|
+
* Music, Bluesky, Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud,
|
|
17
|
+
* Spotify, Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and
|
|
18
|
+
* TikTok Shop; profiles on Amazon, Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai,
|
|
19
|
+
* LinkedIn, Linkme, Linktree, Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify,
|
|
20
|
+
* Telegram, Threads, TikTok, Truth Social, Twitch, X and YouTube; readmes on GitHub; releases on GitHub;
|
|
21
|
+
* repositories on GitHub; reviews on Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on
|
|
22
|
+
* Google, Instagram and TikTok; topics on Instagram and Pinterest; transcripts on Facebook, Instagram, Kick,
|
|
23
|
+
* Reddit, Rumble, TikTok, Twitch and YouTube; trends on Pinterest; usernames on Instagram; web pages on
|
|
24
|
+
* Pinterest; web results on Facebook, Instagram, LinkedIn, Telegram, TikTok and X.
|
|
24
25
|
*/
|
|
25
26
|
export class SocialTap extends Core {
|
|
26
27
|
/** Amazon endpoints. */
|
|
@@ -31,6 +32,8 @@ export class SocialTap extends Core {
|
|
|
31
32
|
bluesky;
|
|
32
33
|
/** Facebook endpoints. */
|
|
33
34
|
facebook;
|
|
35
|
+
/** GitHub endpoints. */
|
|
36
|
+
github;
|
|
34
37
|
/** Google endpoints. */
|
|
35
38
|
google;
|
|
36
39
|
/** Instagram endpoints. */
|
|
@@ -113,6 +116,7 @@ export class SocialTap extends Core {
|
|
|
113
116
|
this.applemusic = new AppleMusic(this);
|
|
114
117
|
this.bluesky = new Bluesky(this);
|
|
115
118
|
this.facebook = new Facebook(this);
|
|
119
|
+
this.github = new GitHub(this);
|
|
116
120
|
this.google = new Google(this);
|
|
117
121
|
this.instagram = new Instagram(this);
|
|
118
122
|
this.kick = new Kick(this);
|
package/dist/commands.js
CHANGED
|
@@ -942,6 +942,265 @@ export const COMMANDS = [
|
|
|
942
942
|
],
|
|
943
943
|
get: (c, p, o) => c.facebook.transcript.get(p, o),
|
|
944
944
|
},
|
|
945
|
+
{
|
|
946
|
+
kind: "list",
|
|
947
|
+
platform: "github",
|
|
948
|
+
name: "activity",
|
|
949
|
+
endpoint: "github.activity",
|
|
950
|
+
summary: "Pushes, pull requests, issues, reviews, releases and stars",
|
|
951
|
+
price: "1 credit",
|
|
952
|
+
params: [
|
|
953
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub account: its username (login), with or without the @; its numeric account ID; or its link (github.com/torvalds, with any tab, github.com/orgs/github, a bot's github.com/apps/dependabot, api.github.com/users/<username>). At most 2048 characters. Example: torvalds" },
|
|
954
|
+
{ name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Only activity at or after this time. A date more than 90 days back reads the monthly contribution timeline instead of the event feed: the walk then goes back month by month and stops once it passes this date. Example: 2026-10-01" },
|
|
955
|
+
{ name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Only activity before this time. A date more than 90 days back reads the monthly contribution timeline from that month backwards (send the first day of a year to read that year and older). Example: 2026-10-08" },
|
|
956
|
+
{ 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." },
|
|
957
|
+
{ 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." },
|
|
958
|
+
{ 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." },
|
|
959
|
+
{ 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." },
|
|
960
|
+
],
|
|
961
|
+
list: (c, p, o) => c.github.activity.list(p, o),
|
|
962
|
+
iterate: (c, p, o) => c.github.activity.iterate(p, o),
|
|
963
|
+
},
|
|
964
|
+
{
|
|
965
|
+
kind: "get",
|
|
966
|
+
platform: "github",
|
|
967
|
+
name: "contributions",
|
|
968
|
+
endpoint: "github.contributions",
|
|
969
|
+
summary: "A user's daily contribution counts for a year",
|
|
970
|
+
price: "1 credit",
|
|
971
|
+
params: [
|
|
972
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub user: its username, with or without the @; its numeric account ID, which survives a rename; or its profile link (github.com/torvalds, with any tab). At most 2048 characters. Example: torvalds" },
|
|
973
|
+
{ name: "year", type: "integer", required: false, description: "A calendar year, January 1 to December 31 (the current one up to today). Leave it out for the last twelve months, the calendar GitHub shows on the profile. Minimum: 2008. Example: 2025" },
|
|
974
|
+
{ 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." },
|
|
975
|
+
{ 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." },
|
|
976
|
+
],
|
|
977
|
+
get: (c, p, o) => c.github.contributions.get(p, o),
|
|
978
|
+
},
|
|
979
|
+
{
|
|
980
|
+
kind: "list",
|
|
981
|
+
platform: "github",
|
|
982
|
+
name: "followers",
|
|
983
|
+
endpoint: "github.followers",
|
|
984
|
+
summary: "Followers of any user or organization, with IDs",
|
|
985
|
+
price: "1 credit",
|
|
986
|
+
params: [
|
|
987
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub account whose followers to list: its username (login), with or without the @; its numeric account ID, which survives a rename; or its link (github.com/torvalds, with any tab, github.com/orgs/github/followers, gist.github.com/<username>, api.github.com/users/<username>). At most 2048 characters. Example: torvalds" },
|
|
988
|
+
{ 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." },
|
|
989
|
+
{ 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." },
|
|
990
|
+
{ 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." },
|
|
991
|
+
{ 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." },
|
|
992
|
+
],
|
|
993
|
+
list: (c, p, o) => c.github.followers.list(p, o),
|
|
994
|
+
iterate: (c, p, o) => c.github.followers.iterate(p, o),
|
|
995
|
+
},
|
|
996
|
+
{
|
|
997
|
+
kind: "list",
|
|
998
|
+
platform: "github",
|
|
999
|
+
name: "following",
|
|
1000
|
+
endpoint: "github.following",
|
|
1001
|
+
summary: "Accounts a user follows, with permanent IDs",
|
|
1002
|
+
price: "1 credit",
|
|
1003
|
+
params: [
|
|
1004
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub account: its username (login), with or without the @; its numeric account ID, which survives a rename; or its link (github.com/sindresorhus, with any tab such as ?tab=following, api.github.com/users/<username>, gist.github.com/<username>). At most 2048 characters. Example: sindresorhus" },
|
|
1005
|
+
{ 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." },
|
|
1006
|
+
{ 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." },
|
|
1007
|
+
{ 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." },
|
|
1008
|
+
{ 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." },
|
|
1009
|
+
],
|
|
1010
|
+
list: (c, p, o) => c.github.following.list(p, o),
|
|
1011
|
+
iterate: (c, p, o) => c.github.following.iterate(p, o),
|
|
1012
|
+
},
|
|
1013
|
+
{
|
|
1014
|
+
kind: "list",
|
|
1015
|
+
platform: "github",
|
|
1016
|
+
name: "pinned_repositories",
|
|
1017
|
+
endpoint: "github.pinned_repositories",
|
|
1018
|
+
summary: "Repositories a user or organization pinned, in order",
|
|
1019
|
+
price: "1 credit",
|
|
1020
|
+
params: [
|
|
1021
|
+
{ 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" },
|
|
1022
|
+
{ 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." },
|
|
1023
|
+
{ 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." },
|
|
1024
|
+
{ 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 6. Default: 6." },
|
|
1025
|
+
{ 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." },
|
|
1026
|
+
],
|
|
1027
|
+
list: (c, p, o) => c.github.pinnedRepositories.list(p, o),
|
|
1028
|
+
iterate: (c, p, o) => c.github.pinnedRepositories.iterate(p, o),
|
|
1029
|
+
},
|
|
1030
|
+
{
|
|
1031
|
+
kind: "get",
|
|
1032
|
+
platform: "github",
|
|
1033
|
+
name: "profile",
|
|
1034
|
+
endpoint: "github.profile",
|
|
1035
|
+
summary: "Bio, company, links and exact follower counts",
|
|
1036
|
+
price: "1 credit",
|
|
1037
|
+
params: [
|
|
1038
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub account: its username (login), with or without the @; its numeric account ID, which every answer gives as id and which survives a rename; or its link (github.com/torvalds, with any tab, github.com/orgs/github, a bot's github.com/apps/dependabot, gist.github.com/<username>, api.github.com/users/<username>). At most 2048 characters. Example: torvalds" },
|
|
1039
|
+
{ 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." },
|
|
1040
|
+
{ 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." },
|
|
1041
|
+
],
|
|
1042
|
+
get: (c, p, o) => c.github.profile.get(p, o),
|
|
1043
|
+
},
|
|
1044
|
+
{
|
|
1045
|
+
kind: "get",
|
|
1046
|
+
platform: "github",
|
|
1047
|
+
name: "readme",
|
|
1048
|
+
endpoint: "github.readme",
|
|
1049
|
+
summary: "A repository's README text, format and branch",
|
|
1050
|
+
price: "1 credit",
|
|
1051
|
+
params: [
|
|
1052
|
+
{ name: "url", type: "string", required: true, description: "The repository: its link (github.com/torvalds/linux, or any page under it: its README's page, a file, a folder), owner/name alone (torvalds/linux), a clone link (https://github.com/torvalds/linux.git, git@github.com:torvalds/linux.git), a file on raw.githubusercontent.com, or the API's link (api.github.com/repos/torvalds/linux, api.github.com/repositories/2325298, by the repository's ID). At most 2048 characters. Example: https://github.com/cli/cli" },
|
|
1053
|
+
{ 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." },
|
|
1054
|
+
{ 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." },
|
|
1055
|
+
],
|
|
1056
|
+
get: (c, p, o) => c.github.readme.get(p, o),
|
|
1057
|
+
},
|
|
1058
|
+
{
|
|
1059
|
+
kind: "list",
|
|
1060
|
+
platform: "github",
|
|
1061
|
+
name: "releases",
|
|
1062
|
+
endpoint: "github.releases",
|
|
1063
|
+
summary: "Release notes, files and exact download counts",
|
|
1064
|
+
price: "1 credit",
|
|
1065
|
+
params: [
|
|
1066
|
+
{ name: "url", type: "string", required: true, description: "The repository: its link (https://github.com/cli/cli, or any page under it such as /releases or a release's own page), owner/name (cli/cli), a clone link ending in .git, or the API's link (api.github.com/repos/cli/cli, or api.github.com/repositories/212613049 by the repository's ID). 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/cli/cli" },
|
|
1067
|
+
{ name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Example: 2026-10-01" },
|
|
1068
|
+
{ name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
|
|
1069
|
+
{ 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." },
|
|
1070
|
+
{ 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." },
|
|
1071
|
+
{ 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 10. Default: 10." },
|
|
1072
|
+
{ 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." },
|
|
1073
|
+
],
|
|
1074
|
+
list: (c, p, o) => c.github.releases.list(p, o),
|
|
1075
|
+
iterate: (c, p, o) => c.github.releases.iterate(p, o),
|
|
1076
|
+
},
|
|
1077
|
+
{
|
|
1078
|
+
kind: "list",
|
|
1079
|
+
platform: "github",
|
|
1080
|
+
name: "repositories",
|
|
1081
|
+
endpoint: "github.repositories",
|
|
1082
|
+
summary: "Every public repo of a user or org, with stars",
|
|
1083
|
+
price: "1 credit",
|
|
1084
|
+
params: [
|
|
1085
|
+
{ name: "handle", type: "string", required: true, description: "The GitHub user or organization whose repositories to list: its username (login), with or without the @; its numeric account ID, which survives a rename; or its link (github.com/torvalds, with any tab, github.com/orgs/cli/repositories, gist.github.com/<username>, api.github.com/users/<username>). At most 2048 characters. Example: torvalds" },
|
|
1086
|
+
{ name: "sort", type: "string", required: false, description: "Order of the results. newest (default): the most recently created repositories first. oldest: the oldest first. recent_activity: the repositories most recently pushed to first. One of: newest, oldest, recent_activity. Default: newest.", enum: ["newest", "oldest", "recent_activity"] },
|
|
1087
|
+
{ name: "type", type: "string", required: false, description: "owner (default): the repositories the account owns, the forks it made included. member: the public repositories of others it is a collaborator on. all: both. One of: owner, member, all. Default: owner.", enum: ["owner", "member", "all"] },
|
|
1088
|
+
{ name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Example: 2026-10-01" },
|
|
1089
|
+
{ name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
|
|
1090
|
+
{ 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." },
|
|
1091
|
+
{ 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." },
|
|
1092
|
+
{ 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." },
|
|
1093
|
+
{ 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." },
|
|
1094
|
+
],
|
|
1095
|
+
list: (c, p, o) => c.github.repositories.list(p, o),
|
|
1096
|
+
iterate: (c, p, o) => c.github.repositories.iterate(p, o),
|
|
1097
|
+
},
|
|
1098
|
+
{
|
|
1099
|
+
kind: "get",
|
|
1100
|
+
platform: "github",
|
|
1101
|
+
name: "repository",
|
|
1102
|
+
endpoint: "github.repository",
|
|
1103
|
+
summary: "Stars, forks, watchers, open issues and license",
|
|
1104
|
+
price: "1 credit",
|
|
1105
|
+
params: [
|
|
1106
|
+
{ name: "url", type: "string", required: true, description: "The repository: its link (github.com/torvalds/linux, or any page under it: a file, a folder, its issues or releases), owner/name alone (torvalds/linux), a clone link (https://github.com/torvalds/linux.git, git@github.com:torvalds/linux.git), a file on raw.githubusercontent.com, or the API's link (api.github.com/repos/torvalds/linux, api.github.com/repositories/2325298, by the repository's ID). At most 2048 characters. Example: https://github.com/torvalds/linux" },
|
|
1107
|
+
{ 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." },
|
|
1108
|
+
{ 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." },
|
|
1109
|
+
],
|
|
1110
|
+
get: (c, p, o) => c.github.repository.get(p, o),
|
|
1111
|
+
},
|
|
1112
|
+
{
|
|
1113
|
+
kind: "list",
|
|
1114
|
+
platform: "github",
|
|
1115
|
+
name: "repository_contributors",
|
|
1116
|
+
endpoint: "github.repository_contributors",
|
|
1117
|
+
summary: "Repository contributors with commit counts",
|
|
1118
|
+
price: "1 credit",
|
|
1119
|
+
params: [
|
|
1120
|
+
{ name: "url", type: "string", required: true, description: "The repository whose contributors to list: its link (github.com/cli/cli, or any page under it: a file, a folder, its issues or releases), owner/name alone (cli/cli), a clone link (https://github.com/cli/cli.git, git@github.com:cli/cli.git), a file on raw.githubusercontent.com, or the API's link (api.github.com/repos/cli/cli, api.github.com/repositories/212613049, by the repository's ID). At most 2048 characters. Example: https://github.com/cli/cli" },
|
|
1121
|
+
{ 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." },
|
|
1122
|
+
{ 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." },
|
|
1123
|
+
{ 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." },
|
|
1124
|
+
{ 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." },
|
|
1125
|
+
],
|
|
1126
|
+
list: (c, p, o) => c.github.repositoryContributors.list(p, o),
|
|
1127
|
+
iterate: (c, p, o) => c.github.repositoryContributors.iterate(p, o),
|
|
1128
|
+
},
|
|
1129
|
+
{
|
|
1130
|
+
kind: "list",
|
|
1131
|
+
platform: "github",
|
|
1132
|
+
name: "search_profiles",
|
|
1133
|
+
endpoint: "github.search_profiles",
|
|
1134
|
+
summary: "Developers and organizations by keyword or location",
|
|
1135
|
+
price: "1 credit",
|
|
1136
|
+
params: [
|
|
1137
|
+
{ name: "query", type: "string", required: true, description: "What to find, as GitHub's account search reads it: words matched in the username, name and public email, and GitHub's qualifiers (type:user or type:org, location:berlin, language:go, followers:>1000, repos:>10, created:>2020-01-01, in:login, in:name, fullname:\"Linus Torvalds\"). A leading - leaves a word or qualifier out. A link to GitHub's own account search (github.com/search?q=…&type=users) is read as that search, its sort included. At most 1024 characters. Example: location:berlin language:go" },
|
|
1138
|
+
{ name: "sort", type: "string", required: false, description: "Order of the results. relevance (default): GitHub's best match. popular: most followers first. newest: most recently joined first. oldest: earliest joined first. One of: relevance, popular, newest, oldest. Default: relevance.", enum: ["relevance", "popular", "newest", "oldest"] },
|
|
1139
|
+
{ 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." },
|
|
1140
|
+
{ 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." },
|
|
1141
|
+
{ 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." },
|
|
1142
|
+
{ 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." },
|
|
1143
|
+
],
|
|
1144
|
+
list: (c, p, o) => c.github.searchProfiles.list(p, o),
|
|
1145
|
+
iterate: (c, p, o) => c.github.searchProfiles.iterate(p, o),
|
|
1146
|
+
},
|
|
1147
|
+
{
|
|
1148
|
+
kind: "list",
|
|
1149
|
+
platform: "github",
|
|
1150
|
+
name: "search_repositories",
|
|
1151
|
+
endpoint: "github.search_repositories",
|
|
1152
|
+
summary: "Repositories by keyword, with exact star and fork counts",
|
|
1153
|
+
price: "1 credit",
|
|
1154
|
+
params: [
|
|
1155
|
+
{ 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. At most 1024 characters. Example: web framework language:go" },
|
|
1156
|
+
{ name: "sort", type: "string", required: false, description: "Order of the results. relevance (default): GitHub's best match. popular: most stars first. recent_activity: most recently pushed to first (pushed_at). One of: relevance, popular, recent_activity. Default: relevance.", enum: ["relevance", "popular", "recent_activity"] },
|
|
1157
|
+
{ name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. By when the repository was created (created_at), to the second; sent to GitHub as a created: qualifier, unless the query has one. Example: 2026-10-01" },
|
|
1158
|
+
{ name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). By when the repository was created (created_at), to the second. Example: 2026-10-08" },
|
|
1159
|
+
{ 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." },
|
|
1160
|
+
{ 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." },
|
|
1161
|
+
{ name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 50. Default: 50." },
|
|
1162
|
+
{ 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." },
|
|
1163
|
+
],
|
|
1164
|
+
list: (c, p, o) => c.github.searchRepositories.list(p, o),
|
|
1165
|
+
iterate: (c, p, o) => c.github.searchRepositories.iterate(p, o),
|
|
1166
|
+
},
|
|
1167
|
+
{
|
|
1168
|
+
kind: "list",
|
|
1169
|
+
platform: "github",
|
|
1170
|
+
name: "trending_profiles",
|
|
1171
|
+
endpoint: "github.trending_profiles",
|
|
1172
|
+
summary: "Trending developers by language, day, week or month",
|
|
1173
|
+
price: "1 credit",
|
|
1174
|
+
params: [
|
|
1175
|
+
{ 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"] },
|
|
1176
|
+
{ name: "programming_language", type: "string", required: false, description: "Only developers trending for one programming language, named as GitHub names it, in any case (rust, python, c++, c#, Jupyter Notebook): a repository's programming_language. Every language when omitted. At most 100 characters. Example: rust" },
|
|
1177
|
+
{ 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." },
|
|
1178
|
+
{ 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." },
|
|
1179
|
+
{ name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 25. Default: 25." },
|
|
1180
|
+
{ 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." },
|
|
1181
|
+
],
|
|
1182
|
+
list: (c, p, o) => c.github.trendingProfiles.list(p, o),
|
|
1183
|
+
iterate: (c, p, o) => c.github.trendingProfiles.iterate(p, o),
|
|
1184
|
+
},
|
|
1185
|
+
{
|
|
1186
|
+
kind: "list",
|
|
1187
|
+
platform: "github",
|
|
1188
|
+
name: "trending_repositories",
|
|
1189
|
+
endpoint: "github.trending_repositories",
|
|
1190
|
+
summary: "Trending repositories by stars gained, by language",
|
|
1191
|
+
price: "1 credit",
|
|
1192
|
+
params: [
|
|
1193
|
+
{ 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"] },
|
|
1194
|
+
{ name: "programming_language", type: "string", required: false, description: "Only repositories in this programming language, as GitHub names it, in any case (python, C++, c#, Jupyter Notebook): a repository's programming_language. Every language when omitted. At most 100 characters. Example: python" },
|
|
1195
|
+
{ name: "spoken_language", type: "string", required: false, description: "Only repositories whose description and README are written in this spoken language: an ISO 639-1 code (en, zh, ja). Any language when omitted. At most 10 characters. Example: zh" },
|
|
1196
|
+
{ 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." },
|
|
1197
|
+
{ 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." },
|
|
1198
|
+
{ name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 25. Default: 25." },
|
|
1199
|
+
{ 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." },
|
|
1200
|
+
],
|
|
1201
|
+
list: (c, p, o) => c.github.trendingRepositories.list(p, o),
|
|
1202
|
+
iterate: (c, p, o) => c.github.trendingRepositories.iterate(p, o),
|
|
1203
|
+
},
|
|
945
1204
|
{
|
|
946
1205
|
kind: "get",
|
|
947
1206
|
platform: "google",
|
|
@@ -2078,7 +2337,7 @@ export const COMMANDS = [
|
|
|
2078
2337
|
{ name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Reddit's own time filter (past hour, day, week, month or year) is applied when it covers since, so fewer pages are fetched; every page is then filtered by published_at, which is exact. On newest the walk stops at the first older post. Example: 2026-10-01" },
|
|
2079
2338
|
{ name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
|
|
2080
2339
|
{ name: "media", type: "string", required: false, description: "Only posts that carry media uploaded to Reddit: image (one image or GIF), video (a Reddit video), carousel (a gallery, several images in one post) or any (all three). Reddit's search applies the filter itself, so pages stay full and it works with subreddit, sort, since and until. query can't use site:, url: or self:yes with it. All posts when omitted. One of: image, video, carousel, any.", enum: ["image", "video", "carousel", "any"] },
|
|
2081
|
-
{ name: "include_body", type: "boolean", required: false, description: "Also return each post's body (text, mentions) and its exact type, read from Reddit's
|
|
2340
|
+
{ name: "include_body", type: "boolean", required: false, description: "Also return each post's body (text, mentions) and its exact type, read from Reddit's feed of the page's posts: a second upstream request per page, at the same price. Works with every sort." },
|
|
2082
2341
|
{ 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." },
|
|
2083
2342
|
{ 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." },
|
|
2084
2343
|
{ 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 7. Default: 7." },
|
package/dist/constants.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
|
|
2
|
-
export declare const VERSION = "1.
|
|
2
|
+
export declare const VERSION = "1.529.29";
|
|
3
3
|
/** The production API origin. */
|
|
4
4
|
export declare const DEFAULT_BASE_URL = "https://socialtap.dev";
|
|
5
5
|
/** Environment variable the API key is read from. */
|
|
@@ -119,6 +119,11 @@ export declare const ERROR_CODES: {
|
|
|
119
119
|
readonly retryable: false;
|
|
120
120
|
readonly remediation: "Do not retry. Fetch the post itself for its text and links.";
|
|
121
121
|
};
|
|
122
|
+
readonly no_readme: {
|
|
123
|
+
readonly status: 404;
|
|
124
|
+
readonly retryable: false;
|
|
125
|
+
readonly remediation: "Do not retry. Fetch the repository itself for its description.";
|
|
126
|
+
};
|
|
122
127
|
readonly upstream_blocked: {
|
|
123
128
|
readonly status: 503;
|
|
124
129
|
readonly retryable: true;
|
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.
|
|
3
|
+
export const VERSION = "1.529.29";
|
|
4
4
|
/** The production API origin. */
|
|
5
5
|
export const DEFAULT_BASE_URL = "https://socialtap.dev";
|
|
6
6
|
/** Environment variable the API key is read from. */
|
|
@@ -44,6 +44,7 @@ export const ERROR_CODES = {
|
|
|
44
44
|
no_transcript: { status: 404, retryable: false, remediation: "Do not retry. If the platform offers other languages, try one with lang." },
|
|
45
45
|
no_live: { status: 404, retryable: false, remediation: "Do not retry now. Ask again later, when the account may be live." },
|
|
46
46
|
no_media: { status: 404, retryable: false, remediation: "Do not retry. Fetch the post itself for its text and links." },
|
|
47
|
+
no_readme: { status: 404, retryable: false, remediation: "Do not retry. Fetch the repository itself for its description." },
|
|
47
48
|
upstream_blocked: { status: 503, retryable: true, remediation: "Retry later with backoff. Failed requests are free." },
|
|
48
49
|
upstream_error: { status: 502, retryable: true, remediation: "Retry with backoff. Failed requests are free." },
|
|
49
50
|
overloaded: { status: 503, retryable: true, remediation: "Retry after the seconds in the retry-after header. Failed requests are free." },
|
package/dist/errors.d.ts
CHANGED
|
@@ -183,6 +183,14 @@ export declare class NoLiveError extends APIError {
|
|
|
183
183
|
export declare class NoMediaError extends APIError {
|
|
184
184
|
name: string;
|
|
185
185
|
}
|
|
186
|
+
/**
|
|
187
|
+
* `no_readme` (HTTP 404): The repository exists but has no README: no file the platform shows as its README.
|
|
188
|
+
*
|
|
189
|
+
* Remediation: Do not retry. Fetch the repository itself for its description.
|
|
190
|
+
*/
|
|
191
|
+
export declare class NoReadmeError extends APIError {
|
|
192
|
+
name: string;
|
|
193
|
+
}
|
|
186
194
|
/**
|
|
187
195
|
* `upstream_blocked` (HTTP 503): The platform refused every attempt, our own retries included.
|
|
188
196
|
*
|
|
@@ -237,6 +245,7 @@ export declare const ERROR_CLASSES: {
|
|
|
237
245
|
readonly no_transcript: typeof NoTranscriptError;
|
|
238
246
|
readonly no_live: typeof NoLiveError;
|
|
239
247
|
readonly no_media: typeof NoMediaError;
|
|
248
|
+
readonly no_readme: typeof NoReadmeError;
|
|
240
249
|
readonly upstream_blocked: typeof UpstreamBlockedError;
|
|
241
250
|
readonly upstream_error: typeof UpstreamError;
|
|
242
251
|
readonly overloaded: typeof OverloadedError;
|
package/dist/errors.js
CHANGED
|
@@ -185,6 +185,14 @@ export class NoLiveError extends APIError {
|
|
|
185
185
|
export class NoMediaError extends APIError {
|
|
186
186
|
name = "NoMediaError";
|
|
187
187
|
}
|
|
188
|
+
/**
|
|
189
|
+
* `no_readme` (HTTP 404): The repository exists but has no README: no file the platform shows as its README.
|
|
190
|
+
*
|
|
191
|
+
* Remediation: Do not retry. Fetch the repository itself for its description.
|
|
192
|
+
*/
|
|
193
|
+
export class NoReadmeError extends APIError {
|
|
194
|
+
name = "NoReadmeError";
|
|
195
|
+
}
|
|
188
196
|
/**
|
|
189
197
|
* `upstream_blocked` (HTTP 503): The platform refused every attempt, our own retries included.
|
|
190
198
|
*
|
|
@@ -239,6 +247,7 @@ export const ERROR_CLASSES = {
|
|
|
239
247
|
no_transcript: NoTranscriptError,
|
|
240
248
|
no_live: NoLiveError,
|
|
241
249
|
no_media: NoMediaError,
|
|
250
|
+
no_readme: NoReadmeError,
|
|
242
251
|
upstream_blocked: UpstreamBlockedError,
|
|
243
252
|
upstream_error: UpstreamError,
|
|
244
253
|
overloaded: OverloadedError,
|