@crawlora-org/sdk 1.25.0-sdk.1 → 1.27.0-sdk.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v1.27.0-sdk.1
+
+- Regenerated from the public API contract (837 to 848 operations). Adds public
+  job search and detail groups for Amazon, Apple, Google, Meta, and Tesla.
+- Google Maps business responses now distinguish a missing `review_count`
+  (`null`) from a confirmed zero, and document locale-specific category labels.
+
+## v1.26.0-sdk.1
+
+- Regenerated from the public API contract (832 to 837 operations). Adds Google Play ratings, Instagram user dataset search/item/facets, and Reddit trending dataset search.
+- Reddit post and comments operations now expose `include_metrics`. The default feed mode costs 1 credit; metrics mode makes one anonymous HTML request and costs 3 credits.
+
 ## v1.25.0-sdk.1
 
 - Regenerated from the public API contract (836 to 832 operations). Adds Apple Podcasts chart rankings, new releases, and related shows; App Store editorial collections; and the Apple Podcasts shows dataset family. Removes the TCDB endpoints, which no longer exist upstream.

package/README.md

@@ -2,7 +2,7 @@
 
 Official JavaScript and TypeScript client for the public Crawlora API. Use it
 to call Crawlora scraping, search, social, developer, marketplace, datasets,
-reviews, media, books, maps, finance, travel, prediction-market, brand, and usage endpoints with a small `fetch`-based client and generated
+reviews, media, books, maps, jobs, finance, travel, prediction-market, brand, and usage endpoints with a small `fetch`-based client and generated
 TypeScript types.
 
 - Runtime: Node.js 18+ or any modern runtime with `fetch`
@@ -26,7 +26,7 @@ npm install @crawlora-org/sdk@VERSION
 
 ## API Key
 
-Create or sign in to your Crawlora account at [crawlora.net](https://crawlora.net),
+Create or sign in to your Crawlora account at [crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-typescript-sdk),
 then create an API key in the dashboard.
 
 ```sh

package/docs/operations.md

@@ -2,7 +2,7 @@
 
 Generated from `openapi/public.json`. Deprecated, admin, and internal operations are excluded from this SDK contract.
 
-Total operations: `832`
+Total operations: `848`
 
 | Group | SDK method | Operation ID | HTTP | Params | Auth | Response | Notes |
 | --- | --- | --- | --- | --- | --- | --- | --- |
@@ -13,6 +13,8 @@ Total operations: `832`
 | airbnb | `airbnb.roomCalendar` | `airbnb-room-calendar` | `GET /airbnb/room/{id}/calendar` | `id` (path string required) | `ApiKeyAuth` | `AirbnbRoomCalendarResponse` |  |
 | airbnb | `airbnb.roomReviews` | `airbnb-room-reviews` | `GET /airbnb/room/{id}/reviews` | `id` (path string required)<br>`page` (query number) | `ApiKeyAuth` | `AirbnbRoomReviewsResponse` |  |
 | airbnb | `airbnb.search` | `airbnb-search` | `GET /airbnb/search` | `location` (query string required)<br>`check_in` (query string)<br>`check_out` (query string)<br>`adults` (query number)<br>`page` (query number)<br>`currency` (query string)<br>`ne_lat` (query number)<br>`ne_lng` (query number)<br>`sw_lat` (query number)<br>`sw_lng` (query number)<br>`zoom` (query number) | `ApiKeyAuth` | `AirbnbSearchResponse` |  |
+| amazonJobs | `amazonJobs.job` | `amazon-jobs-job` | `GET /amazon-jobs/job` | `id` (query string required) | `ApiKeyAuth` | `AmazonJobsJobResponse` |  |
+| amazonJobs | `amazonJobs.search` | `amazon-jobs-search` | `GET /amazon-jobs/search` | `q` (query string)<br>`category` (query "administrative-support" \| "applied-science" \| "audio-video-photography-production" \| "business-intelligence-data-engineering" \| "business-merchant-development" \| "buying-planning-instock-management" \| "customer-service" \| "data-science" \| "database-administration" \| "design" \| "economics" \| "editorial-writing-content-management" \| "facilities-maintenance-real-estate" \| "fgbs" \| "fulfillment-center-warehouse-associate" \| "fulfillment-operations-management" \| "hardware-development" \| "human-resources" \| "investigation-loss-prevention" \| "leadership-development-training" \| "legal" \| "marketing" \| "medical-health-safety" \| "operations-it-support-engineering" \| "project-program-product-management-non-tech" \| "project-program-product-management-technical" \| "public-policy" \| "public-relations-communications" \| "research-science" \| "sales-advertising-account-management" \| "software-development" \| "solutions-architecture" \| "supply-chain-transportation-management" \| "systems-quality-security-engineering")<br>`country` (query string)<br>`page` (query number)<br>`limit` (query number)<br>`sort` (query "relevant" \| "recent") | `ApiKeyAuth` | `AmazonJobsSearchResponse` |  |
 | amazon | `amazon.product` | `amazon-product` | `GET /amazon/product/{asin}` | `asin` (path string required)<br>`language` (query "en_US")<br>`currency` (query "USD") | `ApiKeyAuth` | `AmazonProductResponse` |  |
 | amazon | `amazon.search` | `amazon-search` | `GET /amazon/search` | `k` (query string required)<br>`s` (query string)<br>`page` (query number) | `ApiKeyAuth` | `AmazonSearchResponse` |  |
 | amazon | `amazon.suggest` | `amazon-suggest` | `GET /amazon/suggest/{keyword}` | `keyword` (path string required) | `ApiKeyAuth` | `AmazonSuggestResponse` |  |
@@ -37,6 +39,8 @@ Total operations: `832`
 | appleBooks | `appleBooks.charts` | `apple-books-charts` | `GET /apple-books/charts` | `collection` (query "top-free" \| "top-paid")<br>`genre` (query number)<br>`country` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `AppleBooksChartsResponse` |  |
 | appleBooks | `appleBooks.search` | `apple-books-search` | `GET /apple-books/search` | `term` (query string required)<br>`country` (query string)<br>`lang` (query string)<br>`limit` (query number)<br>`page` (query number) | `ApiKeyAuth` | `AppleBooksSearchResponse` |  |
 | appleBooks | `appleBooks.series` | `apple-books-series` | `GET /apple-books/series/{id}` | `id` (path string required)<br>`country` (query string)<br>`lang` (query string) | `ApiKeyAuth` | `AppleBooksSeriesResponse` |  |
+| appleJobs | `appleJobs.job` | `apple-jobs-job` | `GET /apple-jobs/job` | `id` (query string required) | `ApiKeyAuth` | `AppleJobsJobResponse` |  |
+| appleJobs | `appleJobs.search` | `apple-jobs-search` | `GET /apple-jobs/search` | `q` (query string required)<br>`location` (query string)<br>`page` (query number) | `ApiKeyAuth` | `AppleJobsSearchResponse` |  |
 | applePodcasts | `applePodcasts.charts` | `apple-podcasts-charts` | `GET /apple-podcasts/charts` | `collection` (query string)<br>`category` (query number)<br>`country` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `ApplePodcastsChartsResponse` |  |
 | applePodcasts | `applePodcasts.chartsRankings` | `apple-podcasts-charts-rankings` | `GET /apple-podcasts/charts/rankings` | `chart` (query string)<br>`type` (query string)<br>`genre` (query number)<br>`country` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `ApplePodcastsChartsRankingsResponse` |  |
 | applePodcasts | `applePodcasts.episodesSearch` | `apple-podcasts-episodes-search` | `GET /apple-podcasts/episodes/search` | `term` (query string required)<br>`country` (query string)<br>`lang` (query string)<br>`limit` (query number)<br>`page` (query number) | `ApiKeyAuth` | `ApplePodcastsEpisodesSearchResponse` |  |
@@ -177,6 +181,9 @@ Total operations: `832`
 | datasets | `datasets.housingMarketsFacets` | `datasets-housing-markets-facets` | `GET /datasets/housing-markets/facets` | `facet` (query "region_type" \| "state_code" \| "property_type" \| "parent_metro" \| "parent_metro_code" \| "income_vintage" \| "is_latest" \| "period_begin" required)<br>`q` (query string)<br>`region_type` (query "national" \| "metro" \| "county" \| "city" \| "zip")<br>`state_code` (query string)<br>`property_type` (query string)<br>`parent_metro_code` (query string)<br>`zip_code` (query string)<br>`period` (query string)<br>`latest` (query boolean)<br>`min_median_sale_price` (query number)<br>`max_median_sale_price` (query number)<br>`min_median_list_price` (query number)<br>`max_median_list_price` (query number)<br>`min_price_to_income` (query number)<br>`max_price_to_income` (query number)<br>`min_salary_to_buy` (query number)<br>`max_salary_to_buy` (query number)<br>`min_median_dom` (query number)<br>`max_median_dom` (query number)<br>`min_inventory` (query number)<br>`max_inventory` (query number)<br>`min_homes_sold` (query number) | `ApiKeyAuth` | `DatasetsHousingMarketsFacetsResponse` |  |
 | datasets | `datasets.housingMarketsItem` | `datasets-housing-markets-item` | `GET /datasets/housing-markets/items/{region_type}/{table_id}` | `region_type` (path "national" \| "metro" \| "county" \| "city" \| "zip" required)<br>`table_id` (path number required)<br>`period` (query string)<br>`property_type` (query string)<br>`history` (query boolean) | `ApiKeyAuth` | `DatasetsHousingMarketsItemResponse` |  |
 | datasets | `datasets.housingMarketsSearch` | `datasets-housing-markets-search` | `GET /datasets/housing-markets/search` | `q` (query string)<br>`region_type` (query "national" \| "metro" \| "county" \| "city" \| "zip")<br>`state_code` (query string)<br>`property_type` (query string)<br>`parent_metro_code` (query string)<br>`zip_code` (query string)<br>`period` (query string)<br>`latest` (query boolean)<br>`min_median_sale_price` (query number)<br>`max_median_sale_price` (query number)<br>`min_median_list_price` (query number)<br>`max_median_list_price` (query number)<br>`min_price_to_income` (query number)<br>`max_price_to_income` (query number)<br>`min_salary_to_buy` (query number)<br>`max_salary_to_buy` (query number)<br>`min_median_dom` (query number)<br>`max_median_dom` (query number)<br>`min_inventory` (query number)<br>`max_inventory` (query number)<br>`min_homes_sold` (query number)<br>`sort` (query "relevance" \| "price_desc" \| "price_asc" \| "list_price_desc" \| "list_price_asc" \| "price_to_income_desc" \| "price_to_income_asc" \| "salary_to_buy_desc" \| "salary_to_buy_asc" \| "dom_asc" \| "dom_desc" \| "inventory_desc" \| "homes_sold_desc" \| "period_desc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsHousingMarketsSearchResponse` |  |
+| datasets | `datasets.instagramUsersFacets` | `datasets-instagram-users-facets` | `GET /datasets/instagram-users/facets` | `facet` (query "is_verified" \| "is_business_account" \| "has_bio" \| "has_external_url" \| "category_name" \| "source_tier" required)<br>`q` (query string)<br>`username` (query string)<br>`category_name` (query string)<br>`source_tier` (query string)<br>`is_verified` (query boolean)<br>`is_business_account` (query boolean)<br>`has_bio` (query boolean)<br>`has_external_url` (query boolean)<br>`min_followers` (query number)<br>`max_followers` (query number)<br>`min_ratio` (query number)<br>`max_ratio` (query number)<br>`created_after` (query string)<br>`created_before` (query string)<br>`crawled_after` (query string)<br>`crawled_before` (query string)<br>`sort` (query "relevance" \| "followers_desc" \| "followers_asc" \| "crawled_at_desc" \| "crawled_at_asc" \| "created_at_desc" \| "created_at_asc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsInstagramUsersFacetsResponse` |  |
+| datasets | `datasets.instagramUsersItem` | `datasets-instagram-users-item` | `GET /datasets/instagram-users/items/{username}` | `username` (path string required) | `ApiKeyAuth` | `DatasetsInstagramUsersItemResponse` |  |
+| datasets | `datasets.instagramUsersSearch` | `datasets-instagram-users-search` | `GET /datasets/instagram-users/search` | `q` (query string)<br>`username` (query string)<br>`category_name` (query string)<br>`source_tier` (query string)<br>`is_verified` (query boolean)<br>`is_business_account` (query boolean)<br>`has_bio` (query boolean)<br>`has_external_url` (query boolean)<br>`min_followers` (query number)<br>`max_followers` (query number)<br>`min_ratio` (query number)<br>`max_ratio` (query number)<br>`created_after` (query string)<br>`created_before` (query string)<br>`crawled_after` (query string)<br>`crawled_before` (query string)<br>`sort` (query "relevance" \| "followers_desc" \| "followers_asc" \| "crawled_at_desc" \| "crawled_at_asc" \| "created_at_desc" \| "created_at_asc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsInstagramUsersSearchResponse` |  |
 | datasets | `datasets.jobsCompanies` | `datasets-jobs-companies` | `GET /datasets/jobs/companies` | `q` (query string)<br>`provider` (query "greenhouse" \| "lever" \| "ashby" \| "workday" \| "smartrecruiters" \| "workable" \| "recruitee" \| "rippling" \| "personio" \| "teamtailor" \| "oracle" \| "ukg" \| "icims" \| "eightfold" \| "gem" \| "pinpoint")<br>`status` (query "active" \| "empty" \| "gone" \| "blocked" \| "pending" \| "invalid")<br>`min_open_roles` (query number)<br>`sort` (query "open_desc" \| "company_asc" \| "crawled_desc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsJobsCompaniesResponse` |  |
 | datasets | `datasets.jobsCompanyItem` | `datasets-jobs-company-item` | `GET /datasets/jobs/companies/{id}` | `id` (path string required) | `ApiKeyAuth` | `DatasetsJobsCompanyItemResponse` |  |
 | datasets | `datasets.jobsFacets` | `datasets-jobs-facets` | `GET /datasets/jobs/facets` | `size` (query number) | `ApiKeyAuth` | `DatasetsJobsFacetsResponse` |  |
@@ -217,6 +224,7 @@ Total operations: `832`
 | datasets | `datasets.producthuntProductsSearch` | `datasets-producthunt-products-search` | `GET /datasets/producthunt-products/search` | `q` (query string)<br>`topic` (query string)<br>`maker` (query string)<br>`launched_after` (query string)<br>`launched_before` (query string)<br>`min_votes` (query number)<br>`min_rating` (query number)<br>`pricing_type` (query string)<br>`has_website` (query boolean)<br>`is_online` (query boolean)<br>`sort` (query "relevance" \| "votes_desc" \| "launched_desc" \| "launched_asc" \| "rating_desc" \| "best_rank_asc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsProducthuntProductsSearchResponse` |  |
 | datasets | `datasets.producthuntTrendsFacets` | `datasets-producthunt-trends-facets` | `GET /datasets/producthunt-trends/facets` | `facet` (query "topic" \| "launch_year" required)<br>`group_by` (query "topic_month" \| "topic_year" \| "topic")<br>`topic` (query string)<br>`launched_after` (query string)<br>`launched_before` (query string)<br>`min_votes` (query number)<br>`min_launches` (query number) | `ApiKeyAuth` | `DatasetsProducthuntTrendsFacetsResponse` |  |
 | datasets | `datasets.producthuntTrendsSearch` | `datasets-producthunt-trends-search` | `GET /datasets/producthunt-trends/search` | `group_by` (query "topic_month" \| "topic_year" \| "topic")<br>`topic` (query string)<br>`launched_after` (query string)<br>`launched_before` (query string)<br>`min_votes` (query number)<br>`min_launches` (query number)<br>`sort` (query "period_desc" \| "period_asc" \| "launch_count_desc" \| "sum_votes_desc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsProducthuntTrendsSearchResponse` |  |
+| datasets | `datasets.redditTrendingSearch` | `datasets-reddit-trending-search` | `GET /datasets/reddit-trending/search` | `q` (query string)<br>`subreddit` (query string)<br>`date` (query string)<br>`sort` (query "rank" \| "date_desc")<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `DatasetsRedditTrendingSearchResponse` |  |
 | datasets | `datasets.secCompaniesFacets` | `datasets-sec-companies-facets` | `GET /datasets/sec-companies/facets` | `facet` (query "sic" \| "sic_description" \| "exchange" \| "state_of_incorporation" \| "entity_type" \| "reporting_currency" \| "revenue_band" \| "forms_filed" required)<br>`q` (query string)<br>`ticker` (query string)<br>`sic` (query string)<br>`exchange` (query string)<br>`state_of_incorporation` (query string)<br>`entity_type` (query string)<br>`reporting_currency` (query string)<br>`has_financials` (query boolean)<br>`min_revenue` (query number)<br>`form_filed` (query string) | `ApiKeyAuth` | `DatasetsSecCompaniesFacetsResponse` |  |
 | datasets | `datasets.secCompaniesFinancials` | `datasets-sec-companies-financials` | `GET /datasets/sec-companies/financials/{cik}` | `cik` (path string required)<br>`statement` (query "income" \| "balance" \| "cash_flow")<br>`period` (query "annual" \| "quarterly")<br>`from` (query number)<br>`to` (query number)<br>`limit` (query number) | `ApiKeyAuth` | `DatasetsSecCompaniesFinancialsResponse` |  |
 | datasets | `datasets.secCompaniesInsider` | `datasets-sec-companies-insider` | `GET /datasets/sec-companies/insider/{cik}` | `cik` (path string required)<br>`from` (query string)<br>`to` (query string)<br>`code` (query string)<br>`limit` (query number) | `ApiKeyAuth` | `DatasetsSecCompaniesInsiderResponse` |  |
@@ -295,6 +303,8 @@ Total operations: `832`
 | goodreads | `goodreads.list` | `goodreads-list` | `GET /goodreads/list/{id}` | `id` (path string required)<br>`page` (query number) | `ApiKeyAuth` | `GoodreadsListResponse` |  |
 | goodreads | `goodreads.lists` | `goodreads-lists` | `GET /goodreads/lists` | none | `ApiKeyAuth` | `GoodreadsListsResponse` |  |
 | goodreads | `goodreads.search` | `goodreads-search` | `GET /goodreads/search` | `q` (query string required)<br>`limit` (query number) | `ApiKeyAuth` | `GoodreadsSearchResponse` |  |
+| googleJobs | `googleJobs.job` | `google-jobs-job` | `GET /google-jobs/job` | `id` (query string required) | `ApiKeyAuth` | `GoogleJobsJobResponse` |  |
+| googleJobs | `googleJobs.search` | `google-jobs-search` | `GET /google-jobs/search` | `q` (query string required)<br>`location` (query string)<br>`page` (query number) | `ApiKeyAuth` | `GoogleJobsSearchResponse` |  |
 | google | `google.financeAnalystArticles` | `google-finance-analyst-articles` | `GET /google/finance/analyst-articles/{quote}` | `quote` (path string required) | `ApiKeyAuth` | `GoogleFinanceAnalystArticlesResponse` |  |
 | google | `google.financeChart` | `google-finance-chart` | `GET /google/finance/chart/{quote}` | `quote` (path string required)<br>`window` (query string) | `ApiKeyAuth` | `GoogleFinanceChartResponse` |  |
 | google | `google.financeClassification` | `google-finance-classification` | `GET /google/finance/classification/{quote}` | `quote` (path string required) | `ApiKeyAuth` | `GoogleFinanceClassificationResponse` |  |
@@ -339,8 +349,9 @@ Total operations: `832`
 | googlePlay | `googlePlay.categories` | `googleplay-categories` | `GET /googleplay/categories` | `country` (query string)<br>`lang` (query string) | `ApiKeyAuth` | `GooglePlayCategoriesResponse` |  |
 | googlePlay | `googlePlay.datasafety` | `googleplay-datasafety` | `GET /googleplay/datasafety` | `app_id` (query string required)<br>`lang` (query string) | `ApiKeyAuth` | `GooglePlayDatasafetyResponse` |  |
 | googlePlay | `googlePlay.developer` | `googleplay-developer` | `GET /googleplay/developer/{dev_id}` | `dev_id` (path string required)<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`full_detail` (query boolean) | `ApiKeyAuth` | `GooglePlayDeveloperResponse` |  |
-| googlePlay | `googlePlay.list` | `googleplay-list` | `GET /googleplay/list` | `collection` (query "TOP_FREE" \| "TOP_PAID" \| "GROSSING" \| "NEW_FREE" \| "NEW_PAID")<br>`category` (query string)<br>`age` (query string)<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`full_detail` (query boolean) | `ApiKeyAuth` | `GooglePlayListResponse` |  |
+| googlePlay | `googlePlay.list` | `googleplay-list` | `GET /googleplay/list` | `collection` (query "TOP_FREE" \| "TOP_PAID" \| "GROSSING" \| "NEW_FREE" \| "NEW_PAID")<br>`category` (query string)<br>`device` (query "phone" \| "tablet" \| "tv" \| "chromebook" \| "watch" \| "xr" \| "car")<br>`age` (query string)<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`full_detail` (query boolean) | `ApiKeyAuth` | `GooglePlayListResponse` |  |
 | googlePlay | `googlePlay.permissions` | `googleplay-permissions` | `GET /googleplay/permissions` | `app_id` (query string required)<br>`country` (query string)<br>`lang` (query string)<br>`short` (query boolean) | `ApiKeyAuth` | `GooglePlayPermissionsResponse` |  |
+| googlePlay | `googlePlay.ratings` | `googleplay-ratings` | `GET /googleplay/ratings` | `app_id` (query string required)<br>`country` (query string)<br>`lang` (query string) | `ApiKeyAuth` | `GooglePlayRatingsResponse` |  |
 | googlePlay | `googlePlay.reviews` | `googleplay-reviews` | `GET /googleplay/reviews` | `app_id` (query string required)<br>`sort` (query "helpfulness" \| "newest" \| "rating")<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`paginate` (query boolean)<br>`next_pagination_token` (query string) | `ApiKeyAuth` | `GooglePlayReviewsResponse` |  |
 | googlePlay | `googlePlay.search` | `googleplay-search` | `GET /googleplay/search` | `term` (query string required)<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`full_detail` (query boolean)<br>`price` (query "all" \| "free" \| "paid") | `ApiKeyAuth` | `GooglePlaySearchResponse` |  |
 | googlePlay | `googlePlay.similar` | `googleplay-similar` | `GET /googleplay/similar` | `app_id` (query string required)<br>`num` (query number)<br>`country` (query string)<br>`lang` (query string)<br>`full_detail` (query boolean) | `ApiKeyAuth` | `GooglePlaySimilarResponse` |  |
@@ -451,6 +462,9 @@ Total operations: `832`
 | manga | `manga.rankings` | `manga-rankings` | `GET /manga/rankings` | `sort` (query "TRENDING_DESC" \| "POPULARITY_DESC" \| "SCORE_DESC" \| "FAVOURITES_DESC" \| "START_DATE_DESC" \| "UPDATED_AT_DESC")<br>`format` (query "MANGA" \| "NOVEL" \| "ONE_SHOT")<br>`genre` (query string)<br>`status` (query "FINISHED" \| "RELEASING" \| "NOT_YET_RELEASED" \| "CANCELLED" \| "HIATUS")<br>`page` (query number)<br>`per_page` (query number) | `ApiKeyAuth` | `MangaRankingsResponse` |  |
 | manga | `manga.search` | `manga-search` | `GET /manga/search` | `query` (query string required)<br>`sort` (query "SEARCH_MATCH" \| "POPULARITY_DESC" \| "SCORE_DESC" \| "TRENDING_DESC" \| "FAVOURITES_DESC" \| "START_DATE_DESC")<br>`page` (query number)<br>`per_page` (query number) | `ApiKeyAuth` | `MangaSearchResponse` |  |
 | manga | `manga.title` | `manga-title` | `GET /manga/title/{id}` | `id` (path string required)<br>`mal` (query boolean) | `ApiKeyAuth` | `MangaTitleResponse` |  |
+| metaJobs | `metaJobs.job` | `meta-jobs-job` | `GET /meta-jobs/job` | `id` (query string required) | `ApiKeyAuth` | `MetaJobsJobResponse` |  |
+| metaJobs | `metaJobs.list` | `meta-jobs-list` | `GET /meta-jobs/list` | `page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `MetaJobsListResponse` |  |
+| metaJobs | `metaJobs.search` | `meta-jobs-search` | `GET /meta-jobs/search` | `q` (query string)<br>`teams` (query Array<string>)<br>`roles` (query Array<string>)<br>`offices` (query Array<string>)<br>`is_remote_only` (query boolean)<br>`sort_by_new` (query boolean)<br>`results_per_page` (query "all" \| "five" \| "ten") | `ApiKeyAuth` | `MetaJobsSearchResponse` |  |
 | metacritic | `metacritic.browse` | `metacritic-browse` | `GET /metacritic/browse` | `type` (query "game" \| "movie" \| "tv" required)<br>`genre` (query string)<br>`sort` (query "score" \| "popularity" \| "release_date" \| "oldest")<br>`page` (query number)<br>`per_page` (query number) | `ApiKeyAuth` | `MetacriticBrowseResponse` |  |
 | metacritic | `metacritic.game` | `metacritic-game` | `GET /metacritic/game/{slug}` | `slug` (path string required) | `ApiKeyAuth` | `MetacriticGameResponse` |  |
 | metacritic | `metacritic.gameCriticReviews` | `metacritic-game-critic-reviews` | `GET /metacritic/game/{slug}/critic-reviews` | `slug` (path string required)<br>`page` (query number)<br>`per_page` (query number)<br>`sort` (query "date" \| "score" \| "publication") | `ApiKeyAuth` | `MetacriticGameCriticReviewsResponse` |  |
@@ -571,9 +585,9 @@ Total operations: `832`
 | productHunt | `productHunt.makers` | `producthunt-makers` | `GET /producthunt/product/{id}/makers` | `id` (path string required)<br>`cursor` (query string) | `ApiKeyAuth` | `ProductHuntMakersResponse` |  |
 | productHunt | `productHunt.reviews` | `producthunt-reviews` | `GET /producthunt/product/{id}/reviews` | `id` (path string required) | `ApiKeyAuth` | `ProductHuntReviewsResponse` |  |
 | productHunt | `productHunt.search` | `producthunt-search` | `GET /producthunt/search` | `query` (query string required)<br>`type` (query "product" \| "user" \| "launch")<br>`page` (query number)<br>`featured` (query boolean)<br>`topics` (query string) | `ApiKeyAuth` | `ProductHuntSearchResponse` |  |
-| reddit | `reddit.comments` | `reddit-comments` | `GET /reddit/comments/{id}` | `id` (path string required)<br>`sort` (query "confidence" \| "top" \| "new" \| "controversial" \| "old" \| "qa")<br>`limit` (query number)<br>`depth` (query number) | `ApiKeyAuth` | `RedditCommentsResponse` |  |
+| reddit | `reddit.comments` | `reddit-comments` | `GET /reddit/comments/{id}` | `id` (path string required)<br>`sort` (query "confidence" \| "top" \| "new" \| "controversial" \| "old" \| "qa")<br>`limit` (query number)<br>`depth` (query number)<br>`include_metrics` (query boolean) | `ApiKeyAuth` | `RedditCommentsResponse` |  |
 | reddit | `reddit.domainPosts` | `reddit-domain-posts` | `GET /reddit/domain/{domain}/posts` | `domain` (path string required)<br>`sort` (query "hot" \| "new" \| "top" \| "rising")<br>`time` (query "hour" \| "day" \| "week" \| "month" \| "year" \| "all")<br>`limit` (query number)<br>`after` (query string) | `ApiKeyAuth` | `RedditDomainPostsResponse` |  |
-| reddit | `reddit.post` | `reddit-post` | `GET /reddit/post/{id}` | `id` (path string required) | `ApiKeyAuth` | `RedditPostResponse` |  |
+| reddit | `reddit.post` | `reddit-post` | `GET /reddit/post/{id}` | `id` (path string required)<br>`include_metrics` (query boolean) | `ApiKeyAuth` | `RedditPostResponse` |  |
 | reddit | `reddit.search` | `reddit-search` | `GET /reddit/search` | `q` (query string required)<br>`subreddit` (query string)<br>`sort` (query "relevance" \| "hot" \| "new" \| "top" \| "comments")<br>`time` (query "hour" \| "day" \| "week" \| "month" \| "year" \| "all")<br>`limit` (query number)<br>`after` (query string) | `ApiKeyAuth` | `RedditSearchResponse` |  |
 | reddit | `reddit.subredditAbout` | `reddit-subreddit-about` | `GET /reddit/subreddit/{subreddit}/about` | `subreddit` (path string required)<br>`limit` (query number) | `ApiKeyAuth` | `RedditSubredditAboutResponse` |  |
 | reddit | `reddit.subredditComments` | `reddit-subreddit-comments` | `GET /reddit/subreddit/{subreddit}/comments` | `subreddit` (path string required)<br>`limit` (query number)<br>`after` (query string) | `ApiKeyAuth` | `RedditSubredditCommentsResponse` |  |
@@ -712,6 +726,8 @@ Total operations: `832`
 | steam | `steam.tags` | `steam-tags` | `GET /steam/tags` | `tags` (query string)<br>`untags` (query string)<br>`category1` (query string)<br>`category2` (query string)<br>`category3` (query string)<br>`os` (query string)<br>`maxprice` (query string)<br>`specials` (query boolean)<br>`hidef2p` (query boolean)<br>`deck_compatibility` (query "1" \| "2" \| "3")<br>`vrsupport` (query string)<br>`filter` (query "globaltopsellers" \| "topsellers" \| "popularnew" \| "comingsoon")<br>`supportedlang` (query string)<br>`sort_by` (query "Relevance" \| "Released_DESC" \| "Name_ASC" \| "Price_ASC" \| "Price_DESC" \| "Reviews_DESC")<br>`start` (query number)<br>`count` (query number)<br>`cc` (query string)<br>`l` (query string) | `ApiKeyAuth` | `SteamTagsResponse` |  |
 | steam | `steam.tagsList` | `steam-tags-list` | `GET /steam/tags/list` | `l` (query string) | `ApiKeyAuth` | `SteamTagsListResponse` |  |
 | steam | `steam.topSellers` | `steam-top-sellers` | `GET /steam/top-sellers` | `cc` (query string)<br>`l` (query string) | `ApiKeyAuth` | `SteamTopSellersResponse` |  |
+| teslaJobs | `teslaJobs.job` | `tesla-jobs-job` | `GET /tesla-jobs/job` | `id` (query string required) | `ApiKeyAuth` | `TeslaJobsJobResponse` |  |
+| teslaJobs | `teslaJobs.list` | `tesla-jobs-list` | `GET /tesla-jobs/list` | `query` (query string)<br>`location` (query string)<br>`page` (query number)<br>`page_size` (query number) | `ApiKeyAuth` | `TeslaJobsListResponse` |  |
 | threads | `threads.post` | `threads-post` | `GET /threads/post/{username}/{code}` | `username` (path string required)<br>`code` (path string required) | `ApiKeyAuth` | `ThreadsPostResponse` |  |
 | threads | `threads.postReplies` | `threads-post-replies` | `GET /threads/post/{username}/{code}/replies` | `username` (path string required)<br>`code` (path string required) | `ApiKeyAuth` | `ThreadsPostRepliesResponse` |  |
 | threads | `threads.profile` | `threads-profile` | `GET /threads/profile/{username}` | `username` (path string required) | `ApiKeyAuth` | `ThreadsProfileResponse` |  |

package/docs/recipes.md

@@ -36,9 +36,26 @@ Newer platforms are grouped like every other endpoint:
 
 ```ts
 const posts = await crawlora.reddit.search({ q: "typescript", subreddit: "programming" });
+const postWithMetrics = await crawlora.reddit.post({ id: "1v8hy3q", include_metrics: true });
+const commentsWithMetrics = await crawlora.reddit.comments({ id: "1v8hy3q", include_metrics: true, limit: 25 });
 const brand = await crawlora.brand.retrieve({ domain: "stripe.com" });
 ```
 
+Omit `include_metrics` for the 1-credit feed mode. Set it to `true` for the
+3-credit anonymous HTML mode with public post and comment engagement metrics.
+
+## Company Job Searches
+
+Search public job listings directly from employer career sites:
+
+```ts
+const amazon = await crawlora.amazonJobs.search({ q: "software engineer", country: "US" });
+const apple = await crawlora.appleJobs.search({ q: "machine learning", location: "United States" });
+const google = await crawlora.googleJobs.search({ q: "data scientist", location: "Singapore" });
+const meta = await crawlora.metaJobs.search({ q: "product manager", is_remote_only: true });
+const tesla = await crawlora.teslaJobs.list({ query: "manufacturing", location: "Texas" });
+```
+
 ## Threads Public Lookups
 
 ```ts