@bycrawl/nodejs-sdk 0.1.1 → 0.2.0

package/dist/index.d.cts

@@ -488,25 +488,30 @@ declare class Dcard extends APIResource {
 
 declare class Facebook extends APIResource {
     getUser(username: string): Promise<APIResponse<FacebookUser>>;
-    getUserPosts(username: string): Promise<APIResponse<FacebookPost[]>>;
+    getUserPosts(username: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<FacebookPost[]>>;
+    getPagePosts(pageId: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<FacebookPost[]>>;
     getPost(options: {
         url: string;
     }): Promise<APIResponse<FacebookPost>>;
     getPostComments(options: {
         url: string;
-        cursor?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
     searchPosts(q: string, options?: {
         count?: number;
-        cursor?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceBrowse(location: string, options?: {
+    browseMarketplace(options?: {
+        location?: string;
         category?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceSearch(q: string, options?: {
+    searchMarketplace(q: string, options?: {
         location?: string;
+        category?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceItem(listingId: string): Promise<APIResponse<Record<string, unknown>>>;
+    getMarketplaceItem(listingId: string): Promise<APIResponse<Record<string, unknown>>>;
     iterPostComments(options: {
         url: string;
     }): AsyncGenerator<Record<string, unknown>>;
@@ -562,14 +567,14 @@ declare class LinkedIn extends APIResource {
         count?: number;
         offset?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    searchJobs(query: string, options?: {
+    searchJobs(q: string, options?: {
         location?: string;
         count?: number;
         offset?: number;
     }): Promise<APIResponse<LinkedInJob[]>>;
     getJob(jobId: string): Promise<APIResponse<LinkedInJob>>;
     getPost(postId: string): Promise<APIResponse<LinkedInPost>>;
-    searchUsers(query: string, options?: {
+    searchUsers(q: string, options?: {
         count?: number;
         offset?: number;
     }): Promise<APIResponse<LinkedInUser[]>>;
@@ -577,23 +582,38 @@ declare class LinkedIn extends APIResource {
     iterCompanyJobs(companyId: string, options?: {
         count?: number;
     }): AsyncGenerator<LinkedInJob>;
-    iterSearchJobs(query: string, options?: {
+    iterSearchJobs(q: string, options?: {
         location?: string;
         count?: number;
     }): AsyncGenerator<LinkedInJob>;
 }
 
+declare class PTT extends APIResource {
+    getBoard(boardName: string): Promise<APIResponse<Record<string, unknown>>>;
+    getBoardPosts(boardName: string, options?: {
+        page?: number;
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    getPost(url: string): Promise<APIResponse<Record<string, unknown>>>;
+    searchPosts(boardName: string, q: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class Reddit extends APIResource {
     getSubreddit(name: string): Promise<APIResponse<Subreddit>>;
     getSubredditPosts(name: string, options?: {
         sort?: string;
         t?: string;
         count?: number;
+        after?: string;
     }): Promise<APIResponse<RedditPost[]>>;
     getPost(postId: string): Promise<APIResponse<RedditPost>>;
     searchPosts(q: string, options?: {
         sort?: string;
+        t?: string;
         count?: number;
+        after?: string;
     }): Promise<APIResponse<RedditPost[]>>;
     getUser(username: string): Promise<APIResponse<RedditUser>>;
     getUserPosts(username: string, options?: {
@@ -604,13 +624,21 @@ declare class Reddit extends APIResource {
     }): Promise<APIResponse<Record<string, unknown>>>;
 }
 
+declare class Rent591 extends APIResource {
+    getListings(options?: {
+        region?: number;
+        first_row?: number;
+        kind?: number;
+        section?: number;
+        price?: string;
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    getListing(listingId: number): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class Threads extends APIResource {
-    getPost(postId: string, options?: {
-        mode?: string;
-    }): Promise<APIResponse<ThreadsPost>>;
-    getPosts(ids: string[], options?: {
-        mode?: string;
-    }): Promise<APIResponse<ThreadsPost[]>>;
+    getPost(postId: string): Promise<APIResponse<ThreadsPost>>;
+    getPosts(ids: string[]): Promise<APIResponse<ThreadsPost[]>>;
     searchPosts(q: string, options?: {
         count?: number;
     }): Promise<APIResponse<ThreadsPost[]>>;
@@ -660,13 +688,30 @@ declare class TikTok extends APIResource {
         category?: string;
         count?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    search(keyword: string, options?: {
+    search(q: string, options?: {
         count?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    getVideoSubtitles(videoId: string): Promise<APIResponse<Record<string, unknown>>>;
+    getVideoSubtitles(videoId: string, options?: {
+        language?: string;
+    }): Promise<APIResponse<Record<string, unknown>>>;
     iterVideoComments(videoId: string): AsyncGenerator<TikTokComment>;
 }
 
+declare class Trustpilot extends APIResource {
+    getBusiness(domain: string): Promise<APIResponse<Record<string, unknown>>>;
+    getBusinessReviews(domain: string, options?: {
+        page?: number;
+        sort?: string;
+        stars?: number;
+        languages?: string;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    searchBusinesses(q: string, options?: {
+        page?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    searchCategories(q: string): Promise<APIResponse<Record<string, unknown>>>;
+    getSuggestions(q: string): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class WebFetch extends APIResource {
     fetch(url: string, options?: {
         format?: string;
@@ -749,6 +794,9 @@ declare class ByCrawl {
     readonly dcard: Dcard;
     readonly gmaps: GMaps;
     readonly job104: Job104;
+    readonly trustpilot: Trustpilot;
+    readonly ptt: PTT;
+    readonly rent591: Rent591;
     readonly web: WebFetch;
     private readonly _transport;
     constructor(options?: ByCrawlOptions);

package/dist/index.d.ts

@@ -488,25 +488,30 @@ declare class Dcard extends APIResource {
 
 declare class Facebook extends APIResource {
     getUser(username: string): Promise<APIResponse<FacebookUser>>;
-    getUserPosts(username: string): Promise<APIResponse<FacebookPost[]>>;
+    getUserPosts(username: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<FacebookPost[]>>;
+    getPagePosts(pageId: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<FacebookPost[]>>;
     getPost(options: {
         url: string;
     }): Promise<APIResponse<FacebookPost>>;
     getPostComments(options: {
         url: string;
-        cursor?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
     searchPosts(q: string, options?: {
         count?: number;
-        cursor?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceBrowse(location: string, options?: {
+    browseMarketplace(options?: {
+        location?: string;
         category?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceSearch(q: string, options?: {
+    searchMarketplace(q: string, options?: {
         location?: string;
+        category?: string;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    marketplaceItem(listingId: string): Promise<APIResponse<Record<string, unknown>>>;
+    getMarketplaceItem(listingId: string): Promise<APIResponse<Record<string, unknown>>>;
     iterPostComments(options: {
         url: string;
     }): AsyncGenerator<Record<string, unknown>>;
@@ -562,14 +567,14 @@ declare class LinkedIn extends APIResource {
         count?: number;
         offset?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    searchJobs(query: string, options?: {
+    searchJobs(q: string, options?: {
         location?: string;
         count?: number;
         offset?: number;
     }): Promise<APIResponse<LinkedInJob[]>>;
     getJob(jobId: string): Promise<APIResponse<LinkedInJob>>;
     getPost(postId: string): Promise<APIResponse<LinkedInPost>>;
-    searchUsers(query: string, options?: {
+    searchUsers(q: string, options?: {
         count?: number;
         offset?: number;
     }): Promise<APIResponse<LinkedInUser[]>>;
@@ -577,23 +582,38 @@ declare class LinkedIn extends APIResource {
     iterCompanyJobs(companyId: string, options?: {
         count?: number;
     }): AsyncGenerator<LinkedInJob>;
-    iterSearchJobs(query: string, options?: {
+    iterSearchJobs(q: string, options?: {
         location?: string;
         count?: number;
     }): AsyncGenerator<LinkedInJob>;
 }
 
+declare class PTT extends APIResource {
+    getBoard(boardName: string): Promise<APIResponse<Record<string, unknown>>>;
+    getBoardPosts(boardName: string, options?: {
+        page?: number;
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    getPost(url: string): Promise<APIResponse<Record<string, unknown>>>;
+    searchPosts(boardName: string, q: string, options?: {
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class Reddit extends APIResource {
     getSubreddit(name: string): Promise<APIResponse<Subreddit>>;
     getSubredditPosts(name: string, options?: {
         sort?: string;
         t?: string;
         count?: number;
+        after?: string;
     }): Promise<APIResponse<RedditPost[]>>;
     getPost(postId: string): Promise<APIResponse<RedditPost>>;
     searchPosts(q: string, options?: {
         sort?: string;
+        t?: string;
         count?: number;
+        after?: string;
     }): Promise<APIResponse<RedditPost[]>>;
     getUser(username: string): Promise<APIResponse<RedditUser>>;
     getUserPosts(username: string, options?: {
@@ -604,13 +624,21 @@ declare class Reddit extends APIResource {
     }): Promise<APIResponse<Record<string, unknown>>>;
 }
 
+declare class Rent591 extends APIResource {
+    getListings(options?: {
+        region?: number;
+        first_row?: number;
+        kind?: number;
+        section?: number;
+        price?: string;
+        count?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    getListing(listingId: number): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class Threads extends APIResource {
-    getPost(postId: string, options?: {
-        mode?: string;
-    }): Promise<APIResponse<ThreadsPost>>;
-    getPosts(ids: string[], options?: {
-        mode?: string;
-    }): Promise<APIResponse<ThreadsPost[]>>;
+    getPost(postId: string): Promise<APIResponse<ThreadsPost>>;
+    getPosts(ids: string[]): Promise<APIResponse<ThreadsPost[]>>;
     searchPosts(q: string, options?: {
         count?: number;
     }): Promise<APIResponse<ThreadsPost[]>>;
@@ -660,13 +688,30 @@ declare class TikTok extends APIResource {
         category?: string;
         count?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    search(keyword: string, options?: {
+    search(q: string, options?: {
         count?: number;
     }): Promise<APIResponse<Record<string, unknown>>>;
-    getVideoSubtitles(videoId: string): Promise<APIResponse<Record<string, unknown>>>;
+    getVideoSubtitles(videoId: string, options?: {
+        language?: string;
+    }): Promise<APIResponse<Record<string, unknown>>>;
     iterVideoComments(videoId: string): AsyncGenerator<TikTokComment>;
 }
 
+declare class Trustpilot extends APIResource {
+    getBusiness(domain: string): Promise<APIResponse<Record<string, unknown>>>;
+    getBusinessReviews(domain: string, options?: {
+        page?: number;
+        sort?: string;
+        stars?: number;
+        languages?: string;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    searchBusinesses(q: string, options?: {
+        page?: number;
+    }): Promise<APIResponse<Record<string, unknown>>>;
+    searchCategories(q: string): Promise<APIResponse<Record<string, unknown>>>;
+    getSuggestions(q: string): Promise<APIResponse<Record<string, unknown>>>;
+}
+
 declare class WebFetch extends APIResource {
     fetch(url: string, options?: {
         format?: string;
@@ -749,6 +794,9 @@ declare class ByCrawl {
     readonly dcard: Dcard;
     readonly gmaps: GMaps;
     readonly job104: Job104;
+    readonly trustpilot: Trustpilot;
+    readonly ptt: PTT;
+    readonly rent591: Rent591;
     readonly web: WebFetch;
     private readonly _transport;
     constructor(options?: ByCrawlOptions);

package/dist/index.js

@@ -439,8 +439,15 @@ var Facebook = class extends APIResource {
       castTo: (r) => r
     });
   }
-  async getUserPosts(username) {
-    return this._request("GET", `/facebook/users/${username}/posts`);
+  async getUserPosts(username, options) {
+    return this._request("GET", `/facebook/users/${username}/posts`, {
+      params: { count: options?.count }
+    });
+  }
+  async getPagePosts(pageId, options) {
+    return this._request("GET", `/facebook/pages/${pageId}/posts`, {
+      params: { count: options?.count }
+    });
   }
   async getPost(options) {
     return this._get(`/facebook/posts`, {
@@ -450,25 +457,25 @@ var Facebook = class extends APIResource {
   }
   async getPostComments(options) {
     return this._get(`/facebook/posts/comments`, {
-      params: { url: options.url, cursor: options.cursor }
+      params: { url: options.url }
     });
   }
   async searchPosts(q, options) {
     return this._get(`/facebook/posts/search`, {
-      params: { q, count: options?.count, cursor: options?.cursor }
+      params: { q, count: options?.count }
     });
   }
-  async marketplaceBrowse(location, options) {
+  async browseMarketplace(options) {
     return this._get(`/facebook/marketplace/listings`, {
-      params: { location, category: options?.category }
+      params: { location: options?.location, category: options?.category }
     });
   }
-  async marketplaceSearch(q, options) {
+  async searchMarketplace(q, options) {
     return this._get(`/facebook/marketplace/search`, {
-      params: { q, location: options?.location }
+      params: { q, location: options?.location, category: options?.category }
     });
   }
-  async marketplaceItem(listingId) {
+  async getMarketplaceItem(listingId) {
     return this._get(`/facebook/marketplace/items/${listingId}`);
   }
   // -- Auto-pagination iterators --
@@ -593,10 +600,10 @@ var LinkedIn = class extends APIResource {
       params: { count: options?.count, offset: options?.offset }
     });
   }
-  async searchJobs(query, options) {
+  async searchJobs(q, options) {
     return this._getList(`/linkedin/jobs/search`, {
       params: {
-        q: query,
+        q,
         location: options?.location,
         count: options?.count,
         offset: options?.offset
@@ -615,9 +622,9 @@ var LinkedIn = class extends APIResource {
       castTo: (r) => r
     });
   }
-  async searchUsers(query, options) {
+  async searchUsers(q, options) {
     return this._getList(`/linkedin/users/search`, {
-      params: { q: query, count: options?.count, offset: options?.offset },
+      params: { q, count: options?.count, offset: options?.offset },
       itemsKey: "users",
       castTo: (r) => r
     });
@@ -636,16 +643,38 @@ var LinkedIn = class extends APIResource {
       castTo: (r) => r
     });
   }
-  iterSearchJobs(query, options) {
+  iterSearchJobs(q, options) {
     const count = options?.count ?? 10;
     return this._paginateByOffset(`/linkedin/jobs/search`, {
-      params: { q: query, location: options?.location, count, limit: count },
+      params: { q, location: options?.location, count, limit: count },
       itemsKey: "jobs",
       castTo: (r) => r
     });
   }
 };
 
+// src/platforms/ptt.ts
+var PTT = class extends APIResource {
+  async getBoard(boardName) {
+    return this._get(`/ptt/boards/${boardName}`);
+  }
+  async getBoardPosts(boardName, options) {
+    return this._get(`/ptt/boards/${boardName}/posts`, {
+      params: { page: options?.page, count: options?.count }
+    });
+  }
+  async getPost(url) {
+    return this._get(`/ptt/posts`, {
+      params: { url }
+    });
+  }
+  async searchPosts(boardName, q, options) {
+    return this._get(`/ptt/boards/${boardName}/search`, {
+      params: { q, count: options?.count }
+    });
+  }
+};
+
 // src/platforms/reddit.ts
 var Reddit = class extends APIResource {
   async getSubreddit(name) {
@@ -655,7 +684,12 @@ var Reddit = class extends APIResource {
   }
   async getSubredditPosts(name, options) {
     return this._getList(`/reddit/subreddits/${name}/posts`, {
-      params: { sort: options?.sort, t: options?.t, count: options?.count },
+      params: {
+        sort: options?.sort,
+        t: options?.t,
+        count: options?.count,
+        after: options?.after
+      },
       itemsKey: "posts",
       castTo: (r) => r
     });
@@ -667,7 +701,13 @@ var Reddit = class extends APIResource {
   }
   async searchPosts(q, options) {
     return this._getList(`/reddit/posts/search`, {
-      params: { q, sort: options?.sort, count: options?.count },
+      params: {
+        q,
+        sort: options?.sort,
+        t: options?.t,
+        count: options?.count,
+        after: options?.after
+      },
       itemsKey: "posts",
       castTo: (r) => r
     });
@@ -689,17 +729,35 @@ var Reddit = class extends APIResource {
   }
 };
 
+// src/platforms/rent591.ts
+var Rent591 = class extends APIResource {
+  async getListings(options) {
+    return this._get(`/rent591/listings`, {
+      params: {
+        region: options?.region,
+        first_row: options?.first_row,
+        kind: options?.kind,
+        section: options?.section,
+        price: options?.price,
+        count: options?.count
+      }
+    });
+  }
+  async getListing(listingId) {
+    return this._get(`/rent591/listings/${listingId}`);
+  }
+};
+
 // src/platforms/threads.ts
 var Threads = class extends APIResource {
-  async getPost(postId, options) {
+  async getPost(postId) {
     return this._get(`/threads/posts/${postId}`, {
-      params: { mode: options?.mode },
       castTo: (r) => r
     });
   }
-  async getPosts(ids, options) {
+  async getPosts(ids) {
     const resp = await this._request("GET", `/threads/posts`, {
-      params: { ids: ids.join(","), mode: options?.mode }
+      params: { ids: ids.join(",") }
     });
     return resp;
   }
@@ -815,13 +873,15 @@ var TikTok = class extends APIResource {
       params: { category: options?.category, count: options?.count }
     });
   }
-  async search(keyword, options) {
+  async search(q, options) {
     return this._get(`/tiktok/videos/search`, {
-      params: { q: keyword, count: options?.count }
+      params: { q, count: options?.count }
     });
   }
-  async getVideoSubtitles(videoId) {
-    return this._get(`/tiktok/videos/${videoId}/subtitles`);
+  async getVideoSubtitles(videoId, options) {
+    return this._get(`/tiktok/videos/${videoId}/subtitles`, {
+      params: { language: options?.language }
+    });
   }
   // -- Auto-pagination iterators --
   iterVideoComments(videoId) {
@@ -833,6 +893,38 @@ var TikTok = class extends APIResource {
   }
 };
 
+// src/platforms/trustpilot.ts
+var Trustpilot = class extends APIResource {
+  async getBusiness(domain) {
+    return this._get(`/trustpilot/businesses/${domain}`);
+  }
+  async getBusinessReviews(domain, options) {
+    return this._get(`/trustpilot/businesses/${domain}/reviews`, {
+      params: {
+        page: options?.page,
+        sort: options?.sort,
+        stars: options?.stars,
+        languages: options?.languages
+      }
+    });
+  }
+  async searchBusinesses(q, options) {
+    return this._get(`/trustpilot/businesses/search`, {
+      params: { q, page: options?.page }
+    });
+  }
+  async searchCategories(q) {
+    return this._get(`/trustpilot/categories/search`, {
+      params: { q }
+    });
+  }
+  async getSuggestions(q) {
+    return this._get(`/trustpilot/suggestions`, {
+      params: { q }
+    });
+  }
+};
+
 // src/platforms/webfetch.ts
 var WebFetch = class extends APIResource {
   async fetch(url, options) {
@@ -945,6 +1037,9 @@ var ByCrawl = class {
   dcard;
   gmaps;
   job104;
+  trustpilot;
+  ptt;
+  rent591;
   web;
   _transport;
   constructor(options) {
@@ -971,6 +1066,9 @@ var ByCrawl = class {
     this.dcard = new Dcard(this._transport);
     this.gmaps = new GMaps(this._transport);
     this.job104 = new Job104(this._transport);
+    this.trustpilot = new Trustpilot(this._transport);
+    this.ptt = new PTT(this._transport);
+    this.rent591 = new Rent591(this._transport);
     this.web = new WebFetch(this._transport);
   }
 };