@socialrouter/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SocialRouter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# SocialRouter SDK
+
+A unified API to extract data from social media platforms. SocialRouter acts as an abstraction layer over multiple data providers (Lobstr, Apify, PhantomBuster, etc.), offering a single interface, normalized data format, and automatic failover.
+
+## Installation
+
+```bash
+npm install @socialrouter/sdk
+```
+
+## Quick Start
+
+```typescript
+import { SocialRouter } from "@socialrouter/sdk";
+
+const client = new SocialRouter({
+  apiKey: "sr_live_xxxxxxxxxxxxx",
+});
+
+const result = await client.extractAndWait({
+  url: "https://www.linkedin.com/posts/johndoe_ai-sales-1234567890",
+  model: "lobstr/post.likes",
+  limit: 100,
+});
+
+for (const person of result.data) {
+  console.log(`${person.name} - ${person.title} @ ${person.company}`);
+}
+```
+
+## Model Slugs
+
+SocialRouter uses model slugs to specify which provider and extraction type to use, following the same pattern as OpenRouter. A model slug combines the provider and extraction type in a single string:
+
+```
+provider/extraction_type
+```
+
+### Available Models
+
+| Model | Description |
+|-------|-------------|
+| `lobstr/post.likes` | Post likes via Lobstr |
+| `lobstr/post.comments` | Post comments via Lobstr |
+| `lobstr/profile.info` | Profile info via Lobstr |
+| `lobstr/profile.posts` | Profile posts via Lobstr |
+| `apify/post.likes` | Post likes via Apify |
+| `apify/post.comments` | Post comments via Apify |
+| `apify/profile.info` | Profile info via Apify |
+| `apify/profile.posts` | Profile posts via Apify |
+| `apify/profile.followers` | Followers via Apify |
+
+Browse all models and pricing at [socialrouter.io/providers](https://socialrouter.io/providers).
+
+## Supported Platforms
+
+- **LinkedIn** - profiles, posts, likes, comments, followers
+- **Instagram** - profiles, posts, likes, comments, followers
+- **X (Twitter)** - profiles, posts, likes, comments, followers
+- **Reddit** - profiles, posts, likes, comments, followers
+
+## Extraction Types
+
+| Type | Description |
+|------|-------------|
+| `post.likes` | People who liked/reacted to a post |
+| `post.comments` | People who commented on a post |
+| `profile.info` | Profile metadata (name, bio, company, location) |
+| `profile.posts` | Recent posts from a profile or page |
+| `profile.followers` | Followers of a profile or page |
+
+## Configuration
+
+```typescript
+const client = new SocialRouter({
+  apiKey: "sr_live_xxxxxxxxxxxxx",              // Required
+  baseUrl: "https://api.socialrouter.io",       // Optional (default value)
+});
+```
+
+## Extracting Data
+
+### Extract and wait (recommended)
+
+The simplest approach. Launches the extraction and polls automatically until the result is ready:
+
+```typescript
+const result = await client.extractAndWait({
+  url: "https://www.linkedin.com/posts/johndoe_ai-sales-1234567890",
+  model: "lobstr/post.likes",
+  limit: 100,
+});
+
+console.log(result.status);            // "completed" or "failed"
+console.log(result.data);              // ExtractionRecord[]
+console.log(result.pagination.total);  // Total available records
+```
+
+You can customize the polling behavior:
+
+```typescript
+const result = await client.extractAndWait(
+  { url: "...", model: "lobstr/post.likes" },
+  5000,    // Poll every 5 seconds (default: 3000)
+  60000,   // Timeout after 60 seconds (default: 120000)
+);
+```
+
+### Extract options
+
+```typescript
+await client.extract({
+  url: "https://linkedin.com/in/johndoe",  // Social media URL
+  model: "apify/profile.info",             // Model slug (provider/type)
+  limit: 50,                                // Max results (default: 100)
+  cache: true,                              // Enable caching (optional)
+  webhook_url: "https://myapp.com/hook",    // Async callback URL (optional)
+});
+```
+
+### Manual polling
+
+If you prefer to manage polling yourself:
+
+```typescript
+const extraction = await client.extract({
+  url: "https://linkedin.com/posts/...",
+  model: "lobstr/post.likes",
+});
+
+console.log(extraction.id); // "ext_abc123"
+
+// Check the result later
+const result = await client.getExtraction(extraction.id);
+
+if (result.status === "completed") {
+  console.log(result.data);
+} else if (result.status === "failed") {
+  console.error(result.error);
+}
+```
+
+## Providers
+
+```typescript
+// List all available providers
+const providers = await client.listProviders();
+
+for (const p of providers) {
+  console.log(`${p.name} [${p.status}] - ${p.supported_platforms.join(", ")}`);
+}
+
+// Get provider details including pricing
+const detail = await client.getProvider("lobstr");
+console.log(detail.pricing);
+```
+
+## Account
+
+```typescript
+// Check credit balance
+const balance = await client.getBalance();
+console.log(`Balance: $${balance.balance} ${balance.currency}`);
+
+// Get usage summary
+const usage = await client.getUsage(30); // Last 30 days
+console.log(`Requests: ${usage.total_requests}`);
+console.log(`Records: ${usage.total_records}`);
+console.log(`Credits used: $${usage.total_credits}`);
+```
+
+## Error Handling
+
+The SDK exposes specific error classes for each failure case:
+
+```typescript
+import {
+  SocialRouter,
+  AuthenticationError,
+  InsufficientCreditsError,
+  RateLimitError,
+  SocialRouterError,
+} from "@socialrouter/sdk";
+
+try {
+  await client.extractAndWait({ url: "...", model: "lobstr/post.likes" });
+} catch (err) {
+  if (err instanceof AuthenticationError) {
+    // 401 - Invalid or missing API key
+  } else if (err instanceof InsufficientCreditsError) {
+    // 402 - Not enough credits
+  } else if (err instanceof RateLimitError) {
+    // 429 - Too many requests
+    console.log(`Retry after ${err.retryAfter} seconds`);
+  } else if (err instanceof SocialRouterError) {
+    // Other API error
+    console.error(err.code, err.message, err.status);
+  }
+}
+```
+
+## TypeScript Types
+
+All types are exported for direct use:
+
+```typescript
+import type {
+  SocialRouterConfig,
+  ExtractOptions,
+  Extraction,
+  ExtractionRecord,
+  ExtractionType,
+  ExtractionStatus,
+  Platform,
+  ProviderInfo,
+  ProviderDetail,
+  AccountBalance,
+  UsageSummary,
+  ApiErrorDetail,
+} from "@socialrouter/sdk";
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+import type { SocialRouterConfig, ExtractOptions, Extraction, ProviderInfo, ProviderDetail, AccountBalance, UsageSummary } from "./types.js";
+export declare class SocialRouter {
+    private apiKey;
+    private baseUrl;
+    constructor(config: SocialRouterConfig);
+    /** Run a data extraction */
+    extract(options: ExtractOptions): Promise<Extraction>;
+    /** Get extraction by ID (for polling async results) */
+    getExtraction(id: string): Promise<Extraction>;
+    /** Extract and poll until completed (convenience method) */
+    extractAndWait(options: ExtractOptions, pollIntervalMs?: number, timeoutMs?: number): Promise<Extraction>;
+    /** List all providers */
+    listProviders(): Promise<ProviderInfo[]>;
+    /** Get provider detail */
+    getProvider(id: string): Promise<ProviderDetail>;
+    /** Get credit balance */
+    getBalance(): Promise<AccountBalance>;
+    /** Get usage summary */
+    getUsage(days?: number): Promise<UsageSummary>;
+    private get;
+    private post;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAUpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,kBAAkB;IAOtC,4BAA4B;IACtB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IAU3D,uDAAuD;IACjD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,4DAA4D;IACtD,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,cAAc,GAAE,MAAa,EAC7B,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,UAAU,CAAC;IAoBtB,yBAAyB;IACnB,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAK9C,0BAA0B;IACpB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMtD,yBAAyB;IACnB,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAI3C,wBAAwB;IAClB,QAAQ,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,CAAC;YAM1C,GAAG;YAIH,IAAI;YAIJ,OAAO;CAoCtB"}

package/dist/client.js

@@ -0,0 +1,99 @@
+import { SocialRouterError, AuthenticationError, InsufficientCreditsError, RateLimitError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.socialrouter.io";
+export class SocialRouter {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+    }
+    // ─── Extract ─────────────────────────────────────────
+    /** Run a data extraction */
+    async extract(options) {
+        return this.post("/v1/extract", {
+            url: options.url,
+            type: options.type,
+            limit: options.limit ?? 100,
+            provider: options.provider,
+            webhook_url: options.webhook_url,
+        });
+    }
+    /** Get extraction by ID (for polling async results) */
+    async getExtraction(id) {
+        return this.get(`/v1/extract/${id}`);
+    }
+    /** Extract and poll until completed (convenience method) */
+    async extractAndWait(options, pollIntervalMs = 3000, timeoutMs = 120000) {
+        const extraction = await this.extract(options);
+        if (extraction.status === "completed" || extraction.status === "failed") {
+            return extraction;
+        }
+        // Poll
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+            await new Promise((r) => setTimeout(r, pollIntervalMs));
+            const result = await this.getExtraction(extraction.id);
+            if (result.status !== "pending")
+                return result;
+        }
+        throw new Error(`Extraction ${extraction.id} timed out after ${timeoutMs}ms`);
+    }
+    // ─── Providers ───────────────────────────────────────
+    /** List all providers */
+    async listProviders() {
+        const res = await this.get("/v1/providers");
+        return res.data;
+    }
+    /** Get provider detail */
+    async getProvider(id) {
+        return this.get(`/v1/providers/${id}`);
+    }
+    // ─── Account ─────────────────────────────────────────
+    /** Get credit balance */
+    async getBalance() {
+        return this.get("/v1/account/balance");
+    }
+    /** Get usage summary */
+    async getUsage(days = 30) {
+        return this.get(`/v1/account/usage?days=${days}`);
+    }
+    // ─── HTTP ────────────────────────────────────────────
+    async get(path) {
+        return this.request("GET", path);
+    }
+    async post(path, body) {
+        return this.request("POST", path, body);
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+                "User-Agent": "socialrouter-sdk/0.1.0",
+            },
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!res.ok) {
+            const json = await res.json().catch(() => ({
+                error: { code: "unknown", message: res.statusText, type: "unknown" },
+            }));
+            const detail = json.error ?? { code: "unknown", message: res.statusText, type: "unknown" };
+            switch (res.status) {
+                case 401:
+                    throw new AuthenticationError(detail);
+                case 402:
+                    throw new InsufficientCreditsError(detail);
+                case 429: {
+                    const retryAfter = res.headers.get("X-RateLimit-Reset");
+                    throw new RateLimitError(detail, retryAfter ? Number(retryAfter) : undefined);
+                }
+                default:
+                    throw new SocialRouterError(detail, res.status);
+            }
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+import type { ApiErrorDetail } from "./types.js";
+export declare class SocialRouterError extends Error {
+    code: string;
+    type: string;
+    status: number;
+    constructor(detail: ApiErrorDetail, status: number);
+}
+export declare class AuthenticationError extends SocialRouterError {
+    constructor(detail: ApiErrorDetail);
+}
+export declare class InsufficientCreditsError extends SocialRouterError {
+    constructor(detail: ApiErrorDetail);
+}
+export declare class RateLimitError extends SocialRouterError {
+    retryAfter?: number;
+    constructor(detail: ApiErrorDetail, retryAfter?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,iBAAkB,SAAQ,KAAK;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;CAOnD;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;gBAC5C,MAAM,EAAE,cAAc;CAInC;AAED,qBAAa,wBAAyB,SAAQ,iBAAiB;gBACjD,MAAM,EAAE,cAAc;CAInC;AAED,qBAAa,cAAe,SAAQ,iBAAiB;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEf,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM;CAKxD"}

package/dist/errors.js

@@ -0,0 +1,33 @@
+export class SocialRouterError extends Error {
+    code;
+    type;
+    status;
+    constructor(detail, status) {
+        super(detail.message);
+        this.name = "SocialRouterError";
+        this.code = detail.code;
+        this.type = detail.type;
+        this.status = status;
+    }
+}
+export class AuthenticationError extends SocialRouterError {
+    constructor(detail) {
+        super(detail, 401);
+        this.name = "AuthenticationError";
+    }
+}
+export class InsufficientCreditsError extends SocialRouterError {
+    constructor(detail) {
+        super(detail, 402);
+        this.name = "InsufficientCreditsError";
+    }
+}
+export class RateLimitError extends SocialRouterError {
+    retryAfter;
+    constructor(detail, retryAfter) {
+        super(detail, 429);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACnC,IAAI,CAAS;IACb,IAAI,CAAS;IACb,MAAM,CAAS;IAEtB,YAAY,MAAsB,EAAE,MAAc;QAChD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,iBAAiB;IAC7D,YAAY,MAAsB;QAChC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,iBAAiB;IAC5C,UAAU,CAAU;IAE3B,YAAY,MAAsB,EAAE,UAAmB;QACrD,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { SocialRouter } from "./client.js";
+export { SocialRouterError, AuthenticationError, InsufficientCreditsError, RateLimitError, } from "./errors.js";
+export type { SocialRouterConfig, ExtractOptions, Extraction, ExtractionRecord, ExtractionType, ExtractionStatus, Platform, ProviderInfo, ProviderDetail, AccountBalance, UsageSummary, ApiErrorDetail, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { SocialRouter } from "./client.js";
+export { SocialRouterError, AuthenticationError, InsufficientCreditsError, RateLimitError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export type ExtractionType = "post.likes" | "post.comments" | "profile.info" | "profile.posts" | "profile.followers";
+export type Platform = "linkedin" | "instagram" | "x" | "reddit";
+export type ExtractionStatus = "pending" | "completed" | "failed";
+export interface ExtractOptions {
+    url: string;
+    type: ExtractionType;
+    limit?: number;
+    provider?: string;
+    webhook_url?: string;
+}
+export interface ExtractionRecord {
+    name: string;
+    title?: string;
+    company?: string;
+    location?: string;
+    profile_url: string;
+    source: Platform;
+    extracted_at: string;
+    [key: string]: unknown;
+}
+export interface Extraction {
+    id: string;
+    status: ExtractionStatus;
+    source: Platform;
+    type: ExtractionType;
+    url: string;
+    provider: string;
+    credits_used: number;
+    data: ExtractionRecord[];
+    pagination: {
+        total: number;
+        returned: number;
+        next_cursor: string | null;
+    };
+    error?: ApiErrorDetail;
+    created_at: string;
+    completed_at: string | null;
+}
+export interface ProviderInfo {
+    id: string;
+    name: string;
+    description: string;
+    status: string;
+    supported_platforms: Platform[];
+    supported_types: ExtractionType[];
+}
+export interface ProviderDetail extends ProviderInfo {
+    pricing: {
+        type: ExtractionType;
+        platforms: Platform[];
+        price_per_record: number;
+    }[];
+}
+export interface AccountBalance {
+    balance: number;
+    currency: string;
+}
+export interface UsageSummary {
+    period: string;
+    total_requests: number;
+    total_records: number;
+    total_credits: number;
+    by_provider: Record<string, {
+        requests: number;
+        records: number;
+        credits: number;
+    }>;
+    by_platform: Record<string, {
+        requests: number;
+        records: number;
+        credits: number;
+    }>;
+}
+export interface ApiErrorDetail {
+    code: string;
+    message: string;
+    type: string;
+}
+export interface SocialRouterConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@socialrouter/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the SocialRouter API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["socialrouter", "social-media", "scraping", "api", "sdk", "linkedin", "instagram", "twitter", "x", "reddit"],
+  "author": "SocialRouter",
+  "license": "MIT",
+  "homepage": "https://www.socialrouter.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/socialrouter/sdk-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/socialrouter/sdk-ts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "typescript": "^6.0.2"
+  }
+}