socialtap 1.572.31 → 1.574.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.572.31). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.574.31). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
@@ -223,7 +223,7 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
223
223
  | `linkedin.ad` | `client.linkedin.ad.get()` | 1 credit |
224
224
  | `linkedin.comments` | `client.linkedin.comments.list()` | 1 credit (public page) or 5 credits (data partner) |
225
225
  | `linkedin.employees` | `client.linkedin.employees.list()` | 5 credits |
226
- | `linkedin.engagement` | `client.linkedin.engagement.get()` | 1 credit (public page) or 10 credits (data partner) |
226
+ | `linkedin.engagement` | `client.linkedin.engagement.get()` | 1 credit (public page) or 15 credits (data partner) |
227
227
  | `linkedin.following` | `client.linkedin.following.list()` | 5 credits |
228
228
  | `linkedin.job` | `client.linkedin.job.get()` | 1 credit |
229
229
  | `linkedin.job_related_jobs` | `client.linkedin.jobRelatedJobs.list()` | 1 credit |
@@ -426,6 +426,7 @@ try {
426
426
  | `no_live` | `NoLiveError` | 404 | no |
427
427
  | `no_media` | `NoMediaError` | 404 | no |
428
428
  | `no_readme` | `NoReadmeError` | 404 | no |
429
+ | `unavailable_for_legal_reasons` | `UnavailableForLegalReasonsError` | 451 | no |
429
430
  | `upstream_blocked` | `UpstreamBlockedError` | 503 | yes |
430
431
  | `upstream_error` | `UpstreamError` | 502 | yes |
431
432
  | `overloaded` | `OverloadedError` | 503 | yes |
package/dist/commands.js CHANGED
@@ -2246,7 +2246,7 @@ export const COMMANDS = [
2246
2246
  name: "engagement",
2247
2247
  endpoint: "linkedin.engagement",
2248
2248
  summary: "Engagement rate, cadence and top posts",
2249
- price: "1 credit (public page) or 10 credits (data partner)",
2249
+ price: "1 credit (public page) or 15 credits (data partner)",
2250
2250
  params: [
2251
2251
  { name: "handle", type: "string", required: true, description: "The LinkedIn account: a Page's or a member's link (linkedin.com/company/<name>, /school/<name>, /showcase/<name> or /in/<name>, any tab of it), or its name with that prefix (company/microsoft, in/satyanadella). A bare name is a company's. At most 2048 characters. Example: https://www.linkedin.com/company/microsoft/" },
2252
2252
  { 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." },
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.572.31";
2
+ export declare const VERSION = "1.574.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. */
@@ -124,6 +124,11 @@ export declare const ERROR_CODES: {
124
124
  readonly retryable: false;
125
125
  readonly remediation: "Do not retry. Fetch the repository itself for its description.";
126
126
  };
127
+ readonly unavailable_for_legal_reasons: {
128
+ readonly status: 451;
129
+ readonly retryable: false;
130
+ readonly remediation: "Do not retry. The item stays unavailable unless the notice is withdrawn.";
131
+ };
127
132
  readonly upstream_blocked: {
128
133
  readonly status: 503;
129
134
  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.572.31";
3
+ export const VERSION = "1.574.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. */
@@ -45,6 +45,7 @@ export const ERROR_CODES = {
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
47
  no_readme: { status: 404, retryable: false, remediation: "Do not retry. Fetch the repository itself for its description." },
48
+ unavailable_for_legal_reasons: { status: 451, retryable: false, remediation: "Do not retry. The item stays unavailable unless the notice is withdrawn." },
48
49
  upstream_blocked: { status: 503, retryable: true, remediation: "Retry later with backoff. Failed requests are free." },
49
50
  upstream_error: { status: 502, retryable: true, remediation: "Retry with backoff. Failed requests are free." },
50
51
  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
@@ -190,6 +190,16 @@ export declare class NoMediaError extends APIError {
190
190
  export declare class NoReadmeError extends APIError {
191
191
  name: string;
192
192
  }
193
+ /**
194
+ * `unavailable_for_legal_reasons` (HTTP 451): We removed this item after a copyright notice or another legal
195
+ * request, so we don't return it. The request was free. A list leaves such items out instead, with an
196
+ * items_omitted warning.
197
+ *
198
+ * Remediation: Do not retry. The item stays unavailable unless the notice is withdrawn.
199
+ */
200
+ export declare class UnavailableForLegalReasonsError extends APIError {
201
+ name: string;
202
+ }
193
203
  /**
194
204
  * `upstream_blocked` (HTTP 503): The platform refused every attempt, our own retries included.
195
205
  *
@@ -245,6 +255,7 @@ export declare const ERROR_CLASSES: {
245
255
  readonly no_live: typeof NoLiveError;
246
256
  readonly no_media: typeof NoMediaError;
247
257
  readonly no_readme: typeof NoReadmeError;
258
+ readonly unavailable_for_legal_reasons: typeof UnavailableForLegalReasonsError;
248
259
  readonly upstream_blocked: typeof UpstreamBlockedError;
249
260
  readonly upstream_error: typeof UpstreamError;
250
261
  readonly overloaded: typeof OverloadedError;
package/dist/errors.js CHANGED
@@ -192,6 +192,16 @@ export class NoMediaError extends APIError {
192
192
  export class NoReadmeError extends APIError {
193
193
  name = "NoReadmeError";
194
194
  }
195
+ /**
196
+ * `unavailable_for_legal_reasons` (HTTP 451): We removed this item after a copyright notice or another legal
197
+ * request, so we don't return it. The request was free. A list leaves such items out instead, with an
198
+ * items_omitted warning.
199
+ *
200
+ * Remediation: Do not retry. The item stays unavailable unless the notice is withdrawn.
201
+ */
202
+ export class UnavailableForLegalReasonsError extends APIError {
203
+ name = "UnavailableForLegalReasonsError";
204
+ }
195
205
  /**
196
206
  * `upstream_blocked` (HTTP 503): The platform refused every attempt, our own retries included.
197
207
  *
@@ -247,6 +257,7 @@ export const ERROR_CLASSES = {
247
257
  no_live: NoLiveError,
248
258
  no_media: NoMediaError,
249
259
  no_readme: NoReadmeError,
260
+ unavailable_for_legal_reasons: UnavailableForLegalReasonsError,
250
261
  upstream_blocked: UpstreamBlockedError,
251
262
  upstream_error: UpstreamError,
252
263
  overloaded: OverloadedError,
@@ -9198,7 +9198,7 @@ export declare class LinkedInEngagement {
9198
9198
  * post, comment-to-like ratio, posting cadence, when they last posted, the mix of image, video, text and link
9199
9199
  * posts, and the top and bottom post, with the profile and each post. Send a link or a name.
9200
9200
  *
9201
- * Cost: 1 credit (public page) or 10 credits (data partner). Failed requests and cache hits are free.
9201
+ * Cost: 1 credit (public page) or 15 credits (data partner). Failed requests and cache hits are free.
9202
9202
  *
9203
9203
  * With `fields`, the items are `PartialModel<Engagement>`: only the selected paths are sent, so any member may
9204
9204
  * be absent.
@@ -19618,7 +19618,8 @@ export declare class RequestsResource {
19618
19618
  *
19619
19619
  * The body and status a request returned, without running it again: kept only while keep_response_bodies is on,
19620
19620
  * for `response_body_retention_s`, at most `response_body_max_bytes` each; otherwise not_found (details.reason).
19621
- * Free.
19621
+ * A body about an item since removed after a legal request answers unavailable_for_legal_reasons, and a list's
19622
+ * removed items are left out. Free.
19622
19623
  *
19623
19624
  * Free; needs an API key with the `account:read` scope (GET /v1/requests/{id}/response).
19624
19625
  */
package/dist/resources.js CHANGED
@@ -4720,7 +4720,8 @@ export class RequestsResource {
4720
4720
  *
4721
4721
  * The body and status a request returned, without running it again: kept only while keep_response_bodies is on,
4722
4722
  * for `response_body_retention_s`, at most `response_body_max_bytes` each; otherwise not_found (details.reason).
4723
- * Free.
4723
+ * A body about an item since removed after a legal request answers unavailable_for_legal_reasons, and a list's
4724
+ * removed items are left out. Free.
4724
4725
  *
4725
4726
  * Free; needs an API key with the `account:read` scope (GET /v1/requests/{id}/response).
4726
4727
  */
package/dist/tooldefs.js CHANGED
@@ -490,7 +490,7 @@ export const TOOLS = [
490
490
  {
491
491
  name: "get_engagement",
492
492
  title: "Engagement by handle",
493
- description: "Engagement rate, average views, likes and comments, posting cadence and top post for an account, computed from its recent posts the same way on every platform. Pass handle: a profile link, @handle, username or ID. Price per successful call: Facebook, Instagram, Reddit, Rumble, TikTok, X, YouTube: 1 credit. LinkedIn: 1 credit (public page) or 10 credits (data partner).",
493
+ description: "Engagement rate, average views, likes and comments, posting cadence and top post for an account, computed from its recent posts the same way on every platform. Pass handle: a profile link, @handle, username or ID. Price per successful call: Facebook, Instagram, Reddit, Rumble, TikTok, X, YouTube: 1 credit. LinkedIn: 1 credit (public page) or 15 credits (data partner).",
494
494
  inputSchema: {
495
495
  "type": "object",
496
496
  "properties": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "socialtap",
3
- "version": "1.572.31",
3
+ "version": "1.574.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",