@tapline/client 0.2.14 → 0.2.15

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.
Files changed (218) hide show
  1. package/README.md +6 -2
  2. package/dist/cjs/client.d.ts +2 -0
  3. package/dist/cjs/client.d.ts.map +1 -1
  4. package/dist/cjs/client.js +29 -26
  5. package/dist/cjs/client.js.map +1 -1
  6. package/dist/cjs/index.d.ts +2 -0
  7. package/dist/cjs/index.d.ts.map +1 -1
  8. package/dist/cjs/index.js +30 -27
  9. package/dist/cjs/index.js.map +1 -1
  10. package/dist/cjs/services/airbnb/client.d.ts +6 -6
  11. package/dist/cjs/services/airbnb/client.d.ts.map +1 -1
  12. package/dist/cjs/services/airbnb/client.js +6 -6
  13. package/dist/cjs/services/airbnb/client.js.map +1 -1
  14. package/dist/cjs/services/birdeye/client.d.ts +10 -10
  15. package/dist/cjs/services/birdeye/client.d.ts.map +1 -1
  16. package/dist/cjs/services/birdeye/client.js +10 -10
  17. package/dist/cjs/services/birdeye/client.js.map +1 -1
  18. package/dist/cjs/services/brave_search/client.d.ts +1 -1
  19. package/dist/cjs/services/brave_search/client.d.ts.map +1 -1
  20. package/dist/cjs/services/brave_search/client.js +1 -1
  21. package/dist/cjs/services/brave_search/client.js.map +1 -1
  22. package/dist/cjs/services/brave_search/types.d.ts +1211 -1273
  23. package/dist/cjs/services/brave_search/types.d.ts.map +1 -1
  24. package/dist/cjs/services/facebook/types.d.ts +417 -430
  25. package/dist/cjs/services/facebook/types.d.ts.map +1 -1
  26. package/dist/cjs/services/facebook_ad_library/types.d.ts +259 -182
  27. package/dist/cjs/services/facebook_ad_library/types.d.ts.map +1 -1
  28. package/dist/cjs/services/facebook_marketplace/types.d.ts +162 -170
  29. package/dist/cjs/services/facebook_marketplace/types.d.ts.map +1 -1
  30. package/dist/cjs/services/geckoterminal/client.d.ts +2 -2
  31. package/dist/cjs/services/geckoterminal/client.d.ts.map +1 -1
  32. package/dist/cjs/services/geckoterminal/client.js +2 -2
  33. package/dist/cjs/services/geckoterminal/client.js.map +1 -1
  34. package/dist/cjs/services/geckoterminal/types.d.ts +15 -4
  35. package/dist/cjs/services/geckoterminal/types.d.ts.map +1 -1
  36. package/dist/cjs/services/gmgn/client.d.ts +18 -18
  37. package/dist/cjs/services/gmgn/client.d.ts.map +1 -1
  38. package/dist/cjs/services/gmgn/client.js +18 -18
  39. package/dist/cjs/services/gmgn/client.js.map +1 -1
  40. package/dist/cjs/services/gmgn/types.d.ts +2 -2
  41. package/dist/cjs/services/gmgn/types.d.ts.map +1 -1
  42. package/dist/cjs/services/goplus/client.d.ts +3 -3
  43. package/dist/cjs/services/goplus/client.d.ts.map +1 -1
  44. package/dist/cjs/services/goplus/client.js +3 -3
  45. package/dist/cjs/services/goplus/client.js.map +1 -1
  46. package/dist/cjs/services/imovelweb/client.d.ts +6 -6
  47. package/dist/cjs/services/imovelweb/client.d.ts.map +1 -1
  48. package/dist/cjs/services/imovelweb/client.js +6 -6
  49. package/dist/cjs/services/imovelweb/client.js.map +1 -1
  50. package/dist/cjs/services/indeed/types.d.ts +233 -187
  51. package/dist/cjs/services/indeed/types.d.ts.map +1 -1
  52. package/dist/cjs/services/instagram/client.d.ts +12 -12
  53. package/dist/cjs/services/instagram/client.d.ts.map +1 -1
  54. package/dist/cjs/services/instagram/client.js +12 -12
  55. package/dist/cjs/services/instagram/client.js.map +1 -1
  56. package/dist/cjs/services/instagram/types.d.ts +399 -2284
  57. package/dist/cjs/services/instagram/types.d.ts.map +1 -1
  58. package/dist/cjs/services/linkedin/client.d.ts +7 -7
  59. package/dist/cjs/services/linkedin/client.d.ts.map +1 -1
  60. package/dist/cjs/services/linkedin/client.js +7 -7
  61. package/dist/cjs/services/linkedin/client.js.map +1 -1
  62. package/dist/cjs/services/pinterest/client.d.ts +4 -4
  63. package/dist/cjs/services/pinterest/client.d.ts.map +1 -1
  64. package/dist/cjs/services/pinterest/client.js +4 -4
  65. package/dist/cjs/services/pinterest/client.js.map +1 -1
  66. package/dist/cjs/services/pinterest/types.d.ts +740 -711
  67. package/dist/cjs/services/pinterest/types.d.ts.map +1 -1
  68. package/dist/cjs/services/pinterest_v2/client.d.ts +15 -0
  69. package/dist/cjs/services/pinterest_v2/client.d.ts.map +1 -0
  70. package/dist/cjs/services/pinterest_v2/client.js +28 -0
  71. package/dist/cjs/services/pinterest_v2/client.js.map +1 -0
  72. package/dist/cjs/services/pinterest_v2/index.d.ts +3 -0
  73. package/dist/cjs/services/pinterest_v2/index.d.ts.map +1 -0
  74. package/dist/cjs/services/pinterest_v2/index.js +22 -0
  75. package/dist/cjs/services/pinterest_v2/index.js.map +1 -0
  76. package/dist/cjs/services/pinterest_v2/types.d.ts +558 -0
  77. package/dist/cjs/services/pinterest_v2/types.d.ts.map +1 -0
  78. package/dist/cjs/services/pinterest_v2/types.js +4 -0
  79. package/dist/cjs/services/pinterest_v2/types.js.map +1 -0
  80. package/dist/cjs/services/ponsfamily/client.d.ts +8 -8
  81. package/dist/cjs/services/ponsfamily/client.d.ts.map +1 -1
  82. package/dist/cjs/services/ponsfamily/client.js +8 -8
  83. package/dist/cjs/services/ponsfamily/client.js.map +1 -1
  84. package/dist/cjs/services/ponsfamily/types.d.ts +83 -14
  85. package/dist/cjs/services/ponsfamily/types.d.ts.map +1 -1
  86. package/dist/cjs/services/pumpfun/client.d.ts +56 -56
  87. package/dist/cjs/services/pumpfun/client.d.ts.map +1 -1
  88. package/dist/cjs/services/pumpfun/client.js +56 -56
  89. package/dist/cjs/services/pumpfun/client.js.map +1 -1
  90. package/dist/cjs/services/pumpfun/types.d.ts +280 -101
  91. package/dist/cjs/services/pumpfun/types.d.ts.map +1 -1
  92. package/dist/cjs/services/twitter/client.d.ts +5 -5
  93. package/dist/cjs/services/twitter/client.d.ts.map +1 -1
  94. package/dist/cjs/services/twitter/client.js +5 -5
  95. package/dist/cjs/services/twitter/client.js.map +1 -1
  96. package/dist/cjs/services/twitter/types.d.ts +294 -403
  97. package/dist/cjs/services/twitter/types.d.ts.map +1 -1
  98. package/dist/cjs/services/youtube/client.d.ts +11 -11
  99. package/dist/cjs/services/youtube/client.d.ts.map +1 -1
  100. package/dist/cjs/services/youtube/client.js +11 -11
  101. package/dist/cjs/services/youtube/client.js.map +1 -1
  102. package/dist/cjs/services/youtube/types.d.ts +164 -158
  103. package/dist/cjs/services/youtube/types.d.ts.map +1 -1
  104. package/dist/cjs/services/zillow/client.d.ts +8 -6
  105. package/dist/cjs/services/zillow/client.d.ts.map +1 -1
  106. package/dist/cjs/services/zillow/client.js +10 -5
  107. package/dist/cjs/services/zillow/client.js.map +1 -1
  108. package/dist/cjs/services/zillow/types.d.ts +720 -886
  109. package/dist/cjs/services/zillow/types.d.ts.map +1 -1
  110. package/dist/client.d.ts +2 -0
  111. package/dist/client.d.ts.map +1 -1
  112. package/dist/client.js +3 -0
  113. package/dist/client.js.map +1 -1
  114. package/dist/index.d.ts +2 -0
  115. package/dist/index.d.ts.map +1 -1
  116. package/dist/index.js +2 -0
  117. package/dist/index.js.map +1 -1
  118. package/dist/services/airbnb/client.d.ts +6 -6
  119. package/dist/services/airbnb/client.d.ts.map +1 -1
  120. package/dist/services/airbnb/client.js +6 -6
  121. package/dist/services/airbnb/client.js.map +1 -1
  122. package/dist/services/birdeye/client.d.ts +10 -10
  123. package/dist/services/birdeye/client.d.ts.map +1 -1
  124. package/dist/services/birdeye/client.js +10 -10
  125. package/dist/services/birdeye/client.js.map +1 -1
  126. package/dist/services/brave_search/client.d.ts +1 -1
  127. package/dist/services/brave_search/client.d.ts.map +1 -1
  128. package/dist/services/brave_search/client.js +1 -1
  129. package/dist/services/brave_search/client.js.map +1 -1
  130. package/dist/services/brave_search/types.d.ts +1211 -1273
  131. package/dist/services/brave_search/types.d.ts.map +1 -1
  132. package/dist/services/facebook/types.d.ts +417 -430
  133. package/dist/services/facebook/types.d.ts.map +1 -1
  134. package/dist/services/facebook_ad_library/types.d.ts +259 -182
  135. package/dist/services/facebook_ad_library/types.d.ts.map +1 -1
  136. package/dist/services/facebook_marketplace/types.d.ts +162 -170
  137. package/dist/services/facebook_marketplace/types.d.ts.map +1 -1
  138. package/dist/services/geckoterminal/client.d.ts +2 -2
  139. package/dist/services/geckoterminal/client.d.ts.map +1 -1
  140. package/dist/services/geckoterminal/client.js +2 -2
  141. package/dist/services/geckoterminal/client.js.map +1 -1
  142. package/dist/services/geckoterminal/types.d.ts +15 -4
  143. package/dist/services/geckoterminal/types.d.ts.map +1 -1
  144. package/dist/services/gmgn/client.d.ts +18 -18
  145. package/dist/services/gmgn/client.d.ts.map +1 -1
  146. package/dist/services/gmgn/client.js +18 -18
  147. package/dist/services/gmgn/client.js.map +1 -1
  148. package/dist/services/gmgn/types.d.ts +2 -2
  149. package/dist/services/gmgn/types.d.ts.map +1 -1
  150. package/dist/services/goplus/client.d.ts +3 -3
  151. package/dist/services/goplus/client.d.ts.map +1 -1
  152. package/dist/services/goplus/client.js +3 -3
  153. package/dist/services/goplus/client.js.map +1 -1
  154. package/dist/services/imovelweb/client.d.ts +6 -6
  155. package/dist/services/imovelweb/client.d.ts.map +1 -1
  156. package/dist/services/imovelweb/client.js +6 -6
  157. package/dist/services/imovelweb/client.js.map +1 -1
  158. package/dist/services/indeed/types.d.ts +233 -187
  159. package/dist/services/indeed/types.d.ts.map +1 -1
  160. package/dist/services/instagram/client.d.ts +12 -12
  161. package/dist/services/instagram/client.d.ts.map +1 -1
  162. package/dist/services/instagram/client.js +12 -12
  163. package/dist/services/instagram/client.js.map +1 -1
  164. package/dist/services/instagram/types.d.ts +399 -2284
  165. package/dist/services/instagram/types.d.ts.map +1 -1
  166. package/dist/services/linkedin/client.d.ts +7 -7
  167. package/dist/services/linkedin/client.d.ts.map +1 -1
  168. package/dist/services/linkedin/client.js +7 -7
  169. package/dist/services/linkedin/client.js.map +1 -1
  170. package/dist/services/pinterest/client.d.ts +4 -4
  171. package/dist/services/pinterest/client.d.ts.map +1 -1
  172. package/dist/services/pinterest/client.js +4 -4
  173. package/dist/services/pinterest/client.js.map +1 -1
  174. package/dist/services/pinterest/types.d.ts +740 -711
  175. package/dist/services/pinterest/types.d.ts.map +1 -1
  176. package/dist/services/pinterest_v2/client.d.ts +15 -0
  177. package/dist/services/pinterest_v2/client.d.ts.map +1 -0
  178. package/dist/services/pinterest_v2/client.js +24 -0
  179. package/dist/services/pinterest_v2/client.js.map +1 -0
  180. package/dist/services/pinterest_v2/index.d.ts +3 -0
  181. package/dist/services/pinterest_v2/index.d.ts.map +1 -0
  182. package/dist/services/pinterest_v2/index.js +4 -0
  183. package/dist/services/pinterest_v2/index.js.map +1 -0
  184. package/dist/services/pinterest_v2/types.d.ts +558 -0
  185. package/dist/services/pinterest_v2/types.d.ts.map +1 -0
  186. package/dist/services/pinterest_v2/types.js +3 -0
  187. package/dist/services/pinterest_v2/types.js.map +1 -0
  188. package/dist/services/ponsfamily/client.d.ts +8 -8
  189. package/dist/services/ponsfamily/client.d.ts.map +1 -1
  190. package/dist/services/ponsfamily/client.js +8 -8
  191. package/dist/services/ponsfamily/client.js.map +1 -1
  192. package/dist/services/ponsfamily/types.d.ts +83 -14
  193. package/dist/services/ponsfamily/types.d.ts.map +1 -1
  194. package/dist/services/pumpfun/client.d.ts +56 -56
  195. package/dist/services/pumpfun/client.d.ts.map +1 -1
  196. package/dist/services/pumpfun/client.js +56 -56
  197. package/dist/services/pumpfun/client.js.map +1 -1
  198. package/dist/services/pumpfun/types.d.ts +280 -101
  199. package/dist/services/pumpfun/types.d.ts.map +1 -1
  200. package/dist/services/twitter/client.d.ts +5 -5
  201. package/dist/services/twitter/client.d.ts.map +1 -1
  202. package/dist/services/twitter/client.js +5 -5
  203. package/dist/services/twitter/client.js.map +1 -1
  204. package/dist/services/twitter/types.d.ts +294 -403
  205. package/dist/services/twitter/types.d.ts.map +1 -1
  206. package/dist/services/youtube/client.d.ts +11 -11
  207. package/dist/services/youtube/client.d.ts.map +1 -1
  208. package/dist/services/youtube/client.js +11 -11
  209. package/dist/services/youtube/client.js.map +1 -1
  210. package/dist/services/youtube/types.d.ts +164 -158
  211. package/dist/services/youtube/types.d.ts.map +1 -1
  212. package/dist/services/zillow/client.d.ts +8 -6
  213. package/dist/services/zillow/client.d.ts.map +1 -1
  214. package/dist/services/zillow/client.js +10 -5
  215. package/dist/services/zillow/client.js.map +1 -1
  216. package/dist/services/zillow/types.d.ts +720 -886
  217. package/dist/services/zillow/types.d.ts.map +1 -1
  218. package/package.json +3 -2
@@ -3,15 +3,15 @@ import type { GetCommunityParams, GetCommunityTweetsParams, GetProfileParams, Ge
3
3
  export declare class TwitterClient {
4
4
  private readonly base;
5
5
  constructor(base: BaseClient);
6
- /** An X (Twitter) Community as x.com shows it to logged-out visitors, as X's Community object: `rest_id`, name, description, member count, `created_at` (Unix milliseconds), join policy, topic, banners, rules, creator and member facepile. A logged-out viewer is not a member, so `is_member` is false and `role` is NonMember. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/community`: the same path, query parameter and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format. Costs 1 credit. */
6
+ /** Returns a Community with its name, description, member count, rules, topic, banners, creator, and member preview. Costs 1 credit. */
7
7
  getCommunity(params: GetCommunityParams): Promise<TwitterCommunityResponse>;
8
- /** The 20 posts x.com ranks by likes in an X (Twitter) Community for logged-out visitors, flattened the way Scrape Creators flattens community posts: the post's `legacy` fields plus `id`, `view_count` and the author as `user`. This is a fixed window: x.com offers no latest feed and no further pages logged-out. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/community/tweets`: the same path, query parameter and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016. Costs 1 credit. */
8
+ /** Returns the 20 posts ranked by likes in a Community, with text, engagement, view count, and author data. This fixed window has no cursor. Costs 1 credit. */
9
9
  getCommunityTweets(params: GetCommunityTweetsParams): Promise<TwitterCommunityTweetsResponse>;
10
- /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. Look the account up by `handle`, or by `user_id`, its numeric id, which still finds it after a handle change; send one of the two. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/profile`: the same path, `handle` and `cache_max_age` parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; `user_id` is Tapline's addition; Tapline caches each profile page for 2 minutes, so a profile can be up to 2 minutes old; `cache_max_age` is accepted and has no effect, and every request is charged; a handle x.com does not know answers 404 not_found, where Scrape Creators answers 200 with no user. Costs 1 credit. */
10
+ /** Returns a profile by `handle` or `user_id`, including its bio, follower counts, profile images, location, verification, and pinned post ID. Profile data may be cached for up to two minutes. Costs 1 credit. */
11
11
  getProfile(params: GetProfileParams): Promise<TwitterProfileResponse>;
12
- /** One X (Twitter) post as x.com shows it to logged-out visitors, as X's Tweet object: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/tweet`: the same path, query parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016; `trim` and `cache_max_age` are accepted and have no effect, so the post is fetched live and every request is charged. Costs 1 credit. */
12
+ /** Returns one post with its text, engagement, media, author, long-form note, article, card, edit history, and quoted-post data. Costs 1 credit. */
13
13
  getTweet(params: GetTweetParams): Promise<TwitterTweetResponse>;
14
- /** An X (Twitter) account's pinned post, if there is one, then the newest original posts x.com shows logged-out visitors, in the order the page shows them. In samples that is 5 posts in all, the pinned post included. `tweets` holds each as X's Tweet object: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`, plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns no posts. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/user-tweets`: the same path, query parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016; Tapline caches each profile page for 2 minutes, so the posts can be up to 2 minutes old; `trim` is accepted and has no effect; a handle x.com does not know answers 404 not_found, where Scrape Creators answers 200 with no user. Costs 1 credit. */
14
+ /** Returns an account's pinned post and newest original posts with text, engagement, media, links, and quoted-post data. The response contains about five posts and no cursor. Protected accounts return no posts. Costs 1 credit. */
15
15
  getUserTweets(params: GetUserTweetsParams): Promise<TwitterUserTweetsResponse>;
16
16
  }
17
17
  //# sourceMappingURL=client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/services/twitter/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEzQ,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,6uCAA6uC;IACvuC,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIjF,2qDAA2qD;IACrqD,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAInG,gqDAAgqD;IAC1pD,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI3E,24DAA24D;IACr4D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE,wzEAAwzE;IAClzE,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAGrF"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/services/twitter/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEzQ,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,wIAAwI;IAClI,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIjF,gKAAgK;IAC1J,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAInG,oNAAoN;IAC9M,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI3E,oJAAoJ;IAC9I,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIrE,sOAAsO;IAChO,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAGrF"}
@@ -4,23 +4,23 @@ export class TwitterClient {
4
4
  constructor(base) {
5
5
  this.base = base;
6
6
  }
7
- /** An X (Twitter) Community as x.com shows it to logged-out visitors, as X's Community object: `rest_id`, name, description, member count, `created_at` (Unix milliseconds), join policy, topic, banners, rules, creator and member facepile. A logged-out viewer is not a member, so `is_member` is false and `role` is NonMember. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/community`: the same path, query parameter and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format. Costs 1 credit. */
7
+ /** Returns a Community with its name, description, member count, rules, topic, banners, creator, and member preview. Costs 1 credit. */
8
8
  async getCommunity(params) {
9
9
  return this.base.get('/v1/twitter/community', { ...params });
10
10
  }
11
- /** The 20 posts x.com ranks by likes in an X (Twitter) Community for logged-out visitors, flattened the way Scrape Creators flattens community posts: the post's `legacy` fields plus `id`, `view_count` and the author as `user`. This is a fixed window: x.com offers no latest feed and no further pages logged-out. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/community/tweets`: the same path, query parameter and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016. Costs 1 credit. */
11
+ /** Returns the 20 posts ranked by likes in a Community, with text, engagement, view count, and author data. This fixed window has no cursor. Costs 1 credit. */
12
12
  async getCommunityTweets(params) {
13
13
  return this.base.get('/v1/twitter/community/tweets', { ...params });
14
14
  }
15
- /** An X (Twitter) account's public profile as x.com shows it to logged-out visitors, as X's User object: `rest_id`, `core` (name, handle, join date), `legacy` (bio, follower, following and post counts, avatar, banner, bio link, pinned post id), `location`, `privacy`, `verification` and `is_blue_verified`. Look the account up by `handle`, or by `user_id`, its numeric id, which still finds it after a handle change; send one of the two. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/profile`: the same path, `handle` and `cache_max_age` parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; `user_id` is Tapline's addition; Tapline caches each profile page for 2 minutes, so a profile can be up to 2 minutes old; `cache_max_age` is accepted and has no effect, and every request is charged; a handle x.com does not know answers 404 not_found, where Scrape Creators answers 200 with no user. Costs 1 credit. */
15
+ /** Returns a profile by `handle` or `user_id`, including its bio, follower counts, profile images, location, verification, and pinned post ID. Profile data may be cached for up to two minutes. Costs 1 credit. */
16
16
  async getProfile(params) {
17
17
  return this.base.get('/v1/twitter/profile', { ...params });
18
18
  }
19
- /** One X (Twitter) post as x.com shows it to logged-out visitors, as X's Tweet object: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/tweet`: the same path, query parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016; `trim` and `cache_max_age` are accepted and have no effect, so the post is fetched live and every request is charged. Costs 1 credit. */
19
+ /** Returns one post with its text, engagement, media, author, long-form note, article, card, edit history, and quoted-post data. Costs 1 credit. */
20
20
  async getTweet(params) {
21
21
  return this.base.get('/v1/twitter/tweet', { ...params });
22
22
  }
23
- /** An X (Twitter) account's pinned post, if there is one, then the newest original posts x.com shows logged-out visitors, in the order the page shows them. In samples that is 5 posts in all, the pinned post included. `tweets` holds each as X's Tweet object: `rest_id`, the author under `core.user_results.result`, `legacy` (full text, created time, counts, entities with every t.co link mapped, media with video variants and bitrates, reply and quote ids), `views`, `note_tweet` with the full text of a long post, `article`, `card`, `edit_control`, and the quoted post under `quoted_status_result`, plus its `url`. This is a fixed window: x.com offers no further pages logged-out, so there is no cursor. A protected account returns no posts. Fields x.com does not show logged-out visitors are left out, never filled with placeholder values: for example `favourites_count`, `listed_count`, `media_count` and a post's `source`. Fields that depend on the viewer hold what every logged-out viewer gets: `favorited`, `retweeted`, `bookmarked`, `relationship_perspectives`, `can_dm` and the other viewer flags are false. Mirrors Scrape Creators' `GET /v1/twitter/user-tweets`: the same path, query parameters and provider-data shape. The path, parameters and provider-data fields match Scrape Creators after changing the base URL to `https://api.tapline.sh`; Tapline omits Scrape Creators' top-level `success`, `credits_charged` and `credits_remaining` metadata, and the `x-api-key` header carries the Tapline API key. Differences from Scrape Creators: fields x.com does not show logged-out visitors are left out, as described above; errors use Tapline's error format; a post author's profile fields (`location`, bio, bio link, banner, pinned post ids and the exact `core.created_at`) come from its profile page, cached for 2 minutes; those lookups are best-effort, so an author whose page fails or takes more than 8 seconds keeps only what x.com embeds with posts, with a `core.created_at` from the timestamp inside the user id that can run up to about 25 minutes early, or none for accounts created before about 2016; Tapline caches each profile page for 2 minutes, so the posts can be up to 2 minutes old; `trim` is accepted and has no effect; a handle x.com does not know answers 404 not_found, where Scrape Creators answers 200 with no user. Costs 1 credit. */
23
+ /** Returns an account's pinned post and newest original posts with text, engagement, media, links, and quoted-post data. The response contains about five posts and no cursor. Protected accounts return no posts. Costs 1 credit. */
24
24
  async getUserTweets(params) {
25
25
  return this.base.get('/v1/twitter/user-tweets', { ...params });
26
26
  }
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/services/twitter/client.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAKpE,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,6uCAA6uC;IAC7uC,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA2B,uBAAuB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,2qDAA2qD;IAC3qD,KAAK,CAAC,kBAAkB,CAAC,MAAgC;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiC,8BAA8B,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,gqDAAgqD;IAChqD,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,24DAA24D;IAC34D,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,wzEAAwzE;IACxzE,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,yBAAyB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/services/twitter/client.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAKpE,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,wIAAwI;IACxI,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA2B,uBAAuB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,gKAAgK;IAChK,KAAK,CAAC,kBAAkB,CAAC,MAAgC;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAiC,8BAA8B,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,oNAAoN;IACpN,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAyB,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,oJAAoJ;IACpJ,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAuB,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,sOAAsO;IACtO,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAA4B,yBAAyB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}