scrapeunblocker 0.9.0 → 0.10.1

data/lib/scrapeunblocker/plugins.rb

@@ -0,0 +1,3814 @@
+# frozen_string_literal: true
+
+# Generated by headquarters/scripts/sdk-plugins/generate.py from the public OpenAPI spec - do not edit by hand.
+
+module ScrapeUnblocker
+  # Plugin endpoints as methods; Client includes this module. Each method
+  # returns the parsed JSON body. Options left nil are not sent.
+  module Plugins
+    # Call any plugin endpoint by path, e.g.
+    # plugin("/marketplace/target-search", query: "tv"). Parameters go in as
+    # the API names them (snake_case). Use it for an endpoint this SDK version
+    # has no method for yet.
+    def plugin(path, **params)
+      post_json(path, params)
+    end
+
+    # Scrape Amazon Best Sellers lists.
+    #
+    # Returns an Amazon ranked list for a category on any regional marketplace: Best Sellers
+    # (default), New Releases, Movers & Shakers, Most Wished For or Gift Ideas (`list_type`).
+    # The response carries the `category` (`name`, `slug`, `nodeId`, `url`, `parents`,
+    # `subcategories` - each with a url you can pass back as `category`) and up to `max_results`
+    # ranked `items`: `rank`, `asin`, `title`, `url`, `image`, `price` + `currency`,
+    # `offersCount`, `rating`, `reviewsCount`, and on Movers & Shakers `salesRank`,
+    # `previousSalesRank` and `salesRankChangePct`. Pass `category` as a department slug
+    # (`electronics`), slug plus browse-node id (`electronics/172541`) or a pasted Amazon list
+    # url; leave it empty for the all-departments root (department list, no items). A list holds
+    # up to 100 items over two pages of 50, and each page fetched is billed as one request. When
+    # Amazon has no list for a category it says so, and that text is returned in `message` with
+    # an empty `items` array. An item whose card Amazon did not load (it loads ranks 31-50 of
+    # each page lazily) comes back with only `rank`, `asin` and `url`; `itemsWithDetails` counts
+    # the complete ones. `proxy_country` defaults to the marketplace's home country (amazon.com
+    # -> US) so prices are in the store's currency.
+    #
+    # @param category [String] Which category: a department slug ('electronics', 'books', 'toys-
+    # and-games'), a slug plus browse-node id ('electronics/172541' = Headphones), or any Amazon
+    # Best Sellers / New Releases / Movers & Shakers / Most Wished For / Gift Ideas url (its
+    # marketplace and list type are then used). Empty = the all-departments root, which returns
+    # the department list (`category.subcategories`) and no items.
+    # @param list_type [String] Which ranked list: bestsellers, new_releases,
+    # movers_and_shakers, most_wished_for, gift_ideas. Ignored when `category` is a list url.
+    # API default: bestsellers.
+    # @param marketplace [String] Regional Amazon site. Ignored when `category` is a url. One
+    # of: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl,
+    # amazon.se, amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx,
+    # amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa, amazon.sg, amazon.com.au.
+    # API default: amazon.com.
+    # @param max_results [Integer] How many ranked items to return (1-100). Amazon lists hold up
+    # to 100 items, 50 per page; each page fetched is billed as one request. Amazon's page HTML
+    # carries full details for the first 30 of each page; the rest load while scrolling, so
+    # asking for them adds a browser render (slower, ~10-25 s). API default: 30.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to the marketplace's home country so prices come back in the store's
+    # currency.
+    # Calls POST /marketplace/amazon-bestsellers.
+    def amazon_bestsellers(category = nil, list_type: nil, marketplace: nil, max_results: nil, proxy_country: nil)
+      post_json("/marketplace/amazon-bestsellers", {
+        category: category,
+        list_type: list_type,
+        marketplace: marketplace,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape the reviews on an Amazon product page.
+    #
+    # Returns the review data an Amazon product page shows to a signed-out visitor, as JSON: the
+    # overall `rating`, total `reviewCount` (global ratings), the 5..1-star `histogram` (percent
+    # per star), the AI `customersSay` summary (overall text plus per-aspect `sentiment`,
+    # `mentions`, `positive`, `negative`, `summary` and the quoted review `excerpts` Amazon
+    # shows for the aspect) and the top `reviews` (each with `id`, `url`, `author`, `rating`,
+    # `title`, `body`, `date`, `country`, `fromOtherCountry`, `verified`, `helpfulVotes`,
+    # `variant` and `images`). Identify the product with `asin` (plus `marketplace`) or a
+    # product `url`. Scope: Amazon only shows its full review list to signed-in customers, so
+    # this endpoint returns the public slice on the product page - typically 5 to 13 top
+    # reviews, local ones first and then reviews from other countries - not a complete review
+    # export. When Amazon hides the top reviews behind a sign-in prompt (common on amazon.com),
+    # `reviewsGated` is `true` and `reviews` is empty; the rating, histogram and customers-say
+    # data, including its review excerpts, are still returned. Every field is always present and
+    # is `null` when the page does not show it. `proxy_country` defaults to the marketplace's
+    # home country; the proxy that served the request is reported as `exitCountry` (its country)
+    # and `exitProvider` (its type: `isp`, `residential` or `datacenter`).
+    #
+    # @param asin [String] Amazon product id (10-char ASIN, e.g. 'B07PXGQC1Q'; books use their
+    # ISBN-10). Give either `asin` (with `marketplace`) or a product `url`.
+    # @param url [String] Full Amazon product url, e.g. 'https://www.amazon.de/dp/B0D1XD1ZV3'.
+    # The ASIN and marketplace are read from it, so `asin`/`marketplace` are not needed when a
+    # url is given.
+    # @param marketplace [String] Regional Amazon site the ASIN belongs to. Reviews are read
+    # from that store. One of: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it,
+    # amazon.es, amazon.nl, amazon.se, amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca,
+    # amazon.com.mx, amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa, amazon.sg,
+    # amazon.com.au. API default: amazon.com.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to the marketplace's home country. The reviews come from the marketplace
+    # itself, so any proxy country returns the same reviews.
+    # Calls POST /marketplace/amazon-reviews.
+    def amazon_reviews(asin: nil, url: nil, marketplace: nil, proxy_country: nil)
+      post_json("/marketplace/amazon-reviews", {
+        asin: asin,
+        url: url,
+        marketplace: marketplace,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Walmart product search.
+    #
+    # Searches Walmart for `query` and returns the products as JSON: `name`, `price` and
+    # `wasPrice`, `rating`, `reviewCount`, `brand`, `seller`, `availability`, `image` and a
+    # product `url`. Sort with `sort`, filter with `min_price`/`max_price`, and collect up to
+    # `max_results` across pages.
+    #
+    # @param query [String] What to search, e.g. 'laptop' or 'coffee maker'.
+    # @param sort [String] Ordering: best_match, price_low, price_high, best_seller,
+    # rating_high, new. API default: best_match.
+    # @param min_price [Integer] Lowest price to include (USD).
+    # @param max_price [Integer] Highest price to include (USD).
+    # @param page [Integer] 1-based page to start from (~40 per page). API default: 1.
+    # @param max_results [Integer] How many products to collect across pages. API default: 40.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /marketplace/walmart-search.
+    def walmart_search(query, sort: nil, min_price: nil, max_price: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/marketplace/walmart-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Target product search.
+    #
+    # Searches Target for `query` and returns the products as JSON: `tcin`, `title`, `brand`,
+    # `price` and `formattedPrice`, `currency`, `image` and a product `url`. Sort with `sort`,
+    # filter with `min_price`/`max_price`, and collect up to `max_results` across pages. Data
+    # comes from Target's Redsky API, since target.com itself is a client-rendered shell.
+    #
+    # @param query [String] What to search, e.g. 'coffee maker' or 'tv'.
+    # @param sort [String] Ordering: relevance, newest, price_low, price_high. API default:
+    # relevance.
+    # @param min_price [Integer] Lowest price to include (USD).
+    # @param max_price [Integer] Highest price to include (USD).
+    # @param max_results [Integer] How many products to collect across pages. API default: 24.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /marketplace/target-search.
+    def target_search(query, sort: nil, min_price: nil, max_price: nil, max_results: nil, proxy_country: nil)
+      post_json("/marketplace/target-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Best Buy product search.
+    #
+    # Searches Best Buy (US) for `query` and returns the products as JSON: `sku`, `title`,
+    # `brand`, `model`, `price`, `originalPrice` (when on sale), `currency`, `rating`,
+    # `reviewCount`, `image` and a product `url`, plus Best Buy's `totalResults`. Sort with
+    # `sort`, filter with `min_price`/`max_price`, and collect up to `max_results` across pages
+    # starting at `page`.
+    #
+    # @param query [String] What to search, e.g. 'laptop' or 'noise cancelling headphones'.
+    # @param sort [String] Ordering: relevance, best_selling, price_low, price_high, rating,
+    # newest, discount. API default: relevance.
+    # @param min_price [Integer] Lowest price to include (USD).
+    # @param max_price [Integer] Highest price to include (USD).
+    # @param max_results [Integer] How many products to collect across pages. API default: 24.
+    # @param page [Integer] 1-based results page to start from (48 per page, up to 40). API
+    # default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /marketplace/bestbuy-search.
+    def bestbuy_search(query, sort: nil, min_price: nil, max_price: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/marketplace/bestbuy-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Home Depot product search.
+    #
+    # Searches Home Depot for `query` and returns the products as JSON: `itemId`, `title`,
+    # `brand`, `price`, `originalPrice`, `currency`, `rating`, `reviewCount`, `image`, a product
+    # `url` and `modelNumber`. Sort with `sort`, filter with `min_price`/`max_price`, and
+    # collect up to `max_results` across pages.
+    #
+    # @param query [String] What to search, e.g. 'cordless drill' or 'interior paint'.
+    # @param sort [String] Ordering: relevance, price_low, price_high, top_rated, best_seller.
+    # API default: relevance.
+    # @param min_price [Integer] Lowest price to include (USD).
+    # @param max_price [Integer] Highest price to include (USD).
+    # @param page [Integer] 1-based page to start from (~24 per page). API default: 1.
+    # @param max_results [Integer] How many products to collect across pages. API default: 24.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /marketplace/homedepot-search.
+    def homedepot_search(query, sort: nil, min_price: nil, max_price: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/marketplace/homedepot-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Etsy product search.
+    #
+    # Searches Etsy for `query` and returns the products as JSON: `title`, `price` + `currency`
+    # (ISO code) + `currencySymbol`, `shop`, `image`, a listing `url` and `sponsored`. Paid ad
+    # placements, which Etsy mixes in regardless of `sort`, are left out unless
+    # `include_sponsored=true`. Sort with `sort`, filter with `min_price`/`max_price`, and
+    # collect up to `max_results` across pages. Prices are in USD by default.
+    #
+    # @param query [String] What to search, e.g. 'handmade jewelry'.
+    # @param sort [String] Ordering: relevancy, price_asc, price_desc, newest, top_reviews. API
+    # default: relevancy.
+    # @param min_price [Integer] Lowest price to include.
+    # @param max_price [Integer] Highest price to include.
+    # @param page [Integer] 1-based page to start from. API default: 1.
+    # @param max_results [Integer] How many products to collect across pages. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US (USD prices).
+    # @param include_sponsored [Boolean] Also return Etsy's paid ad placements (`sponsored:
+    # true`). Off by default: ads ignore the search order and `sort`. API default: false.
+    # Calls POST /marketplace/etsy-search.
+    def etsy_search(query, sort: nil, min_price: nil, max_price: nil, page: nil, max_results: nil, proxy_country: nil, include_sponsored: nil)
+      post_json("/marketplace/etsy-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+        include_sponsored: include_sponsored,
+      })
+    end
+
+    # Scrape SHEIN product search.
+    #
+    # Searches SHEIN (US store) for `query` and returns the products as JSON: `id`, `sku`,
+    # `title`, `url`, `price`, `originalPrice`, `currency`, `discountPercent`, `rating`,
+    # `reviewCount`, `category`, `image`, `soldOut` and `storeCode`. Order with `sort`, filter
+    # with `min_price`/`max_price`. Returns SHEIN's first results page (up to 20 products);
+    # SHEIN does not serve deeper pages to automated clients.
+    #
+    # @param query [String] What to search, e.g. 'summer dress' or 'phone case'.
+    # @param sort [String] Ordering: relevance, price_low, price_high. API default: relevance.
+    # @param min_price [Integer] Lowest price to include (USD).
+    # @param max_price [Integer] Highest price to include (USD).
+    # @param max_results [Integer] How many products to return (at most 20: SHEIN serves only
+    # its first results page). API default: 20.
+    # @param page [Integer] Must be 1: SHEIN challenges every deeper results page. API default:
+    # 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Optional.
+    # Calls POST /marketplace/shein-search.
+    def shein_search(query, sort: nil, min_price: nil, max_price: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/marketplace/shein-search", {
+        query: query,
+        sort: sort,
+        min_price: min_price,
+        max_price: max_price,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Zalando product search.
+    #
+    # Searches Zalando for `query` and returns the products as JSON: `sku`, `brand`, `name`,
+    # `price`, `currency`, `image` and a product `url`. Pick the storefront with `domain` and
+    # collect up to `max_results` across pages.
+    #
+    # @param query [String] What to search, e.g. 'nike sneakers' or 'winter jacket'.
+    # @param domain [String] Zalando storefront: en.zalando.de, www.zalando.co.uk,
+    # www.zalando.fr, www.zalando.it, www.zalando.es, www.zalando.nl, www.zalando.pl,
+    # www.zalando.de. API default: en.zalando.de.
+    # @param page [Integer] 1-based page to start from (~48 per page). API default: 1.
+    # @param max_results [Integer] How many products to collect across pages. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to an EU country.
+    # Calls POST /marketplace/zalando-search.
+    def zalando_search(query, domain: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/marketplace/zalando-search", {
+        query: query,
+        domain: domain,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Search Temu by keyword.
+    #
+    # Searches Temu for `keyword` and returns the matching product urls (~40 per page). This is
+    # discovery only - fetch each url's data (name, price, rating, reviews, images) through
+    # `POST /goods/temu-product`. Use `sort` to pick Temu's own result order (relevance,
+    # best_selling, recent, price_asc, price_desc). Response time is typically ~2s.
+    #
+    # @param keyword [String] Search phrase, e.g. 'kids toys' or 'phone case'.
+    # @param limit [Integer] Max product urls to return (one search page carries ~40). API
+    # default: 40.
+    # @param sort [String] Result order, using Temu's own sort: `relevance` (default),
+    # `best_selling` (top sales), `recent` (most recent), `price_asc` (price low to high) or
+    # `price_desc` (price high to low). API default: relevance.
+    # Calls POST /goods/temu-search.
+    def temu_search(keyword, limit: nil, sort: nil)
+      post_json("/goods/temu-search", {
+        keyword: keyword,
+        limit: limit,
+        sort: sort,
+      })
+    end
+
+    # Scrape a Temu product page.
+    #
+    # Fetches a single Temu product and returns it as JSON: `name`, `description`, `brand`,
+    # `sku`, `price`, `priceCurrency`, `availability`, `itemCondition`, `rating`, `reviewCount`,
+    # `variantGroupId`, `images`, `reviews` (per-review rating and date; Temu masks the review
+    # text and author name in this document) and `video` (a `{contentUrl, thumbnailUrl,
+    # uploadDate}` object when the product ships one, else null). Temu serves product data only
+    # to search-engine crawlers, so this reads the ld+json SEO document rather than a browser
+    # render. The url must be a product page (path ends in `-g-<id>.html`).
+    #
+    # @param url [String] Full Temu product url, e.g.
+    # 'https://www.temu.com/xyz-g-601099512345678.html'. Must be a product page (its path ends
+    # in `-g-<id>.html`); search/category urls have no product data and are rejected.
+    # Calls POST /goods/temu-product.
+    def temu_product(url)
+      post_json("/goods/temu-product", {
+        url: url,
+      })
+    end
+
+    # Scrape AliExpress search results.
+    #
+    # Searches AliExpress for `keyword` and returns the products as JSON: `title`, product
+    # `url`, `price` (numeric) + `priceFormatted` + `currency`/`currencySymbol`,
+    # `originalPrice`, `rating`, `orders` (sold count) and `images`. Sort with `sort` (relevance
+    # / orders / price_asc / price_desc / newest) and collect up to `max_results` across pages.
+    # AliExpress localises price by region, so the currency follows the proxy country; pass
+    # `proxy_country` to pin it.
+    #
+    # @param keyword [String] What to search, e.g. 'wireless earbuds' or 'phone case'.
+    # @param sort [String] Ordering: relevance, orders, price_asc, price_desc, newest. API
+    # default: relevance.
+    # @param max_results [Integer] How many products to collect across pages (~60 per page, max
+    # 1200). API default: 60.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'); also pins AliExpress price currency. Leave blank to let the API pick.
+    # Calls POST /goods/aliexpress-search.
+    def aliexpress_search(keyword, sort: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/goods/aliexpress-search", {
+        keyword: keyword,
+        sort: sort,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Alibaba.com product search results.
+    #
+    # Searches Alibaba.com for `q` and returns the products as JSON: `productId`, `title`,
+    # `url`, `image`/`images`, `priceText` with `priceMin`/`priceMax` and `currency` (USD),
+    # `priceTiers` (price per quantity range), promotion price, `moq` + `moqUnit` (minimum
+    # order), `sold`, store `rating` + `reviewsCount`, `leadTimeDays`, `category`,
+    # `certifications`, `sponsored`, and the `supplier` (name, store and profile URL, country,
+    # `yearsOnAlibaba`, `verified`, `verifiedPro`, `goldSupplier`, `tradeAssurance`,
+    # `responseRate`). Sort by relevance or sales, filter with `verified`, `verified_pro`,
+    # `trade_assurance` and `supplier_country`, and collect up to `max_results` across pages (48
+    # per page, each page billed as one request, see `pagesFetched`). Each product also has a
+    # `thumbnail` (300x300 rendition of `image`, which is the full-size original). Paging:
+    # `nextPage` is the next Alibaba page not yet returned (pass it as `page` to continue) and
+    # `hasMore` says whether there is one; when `max_results` ends inside a page, the rest of
+    # that page is not returned (`droppedFromLastPage`), so use multiples of 48 to get every
+    # product.
+    #
+    # @param q [String] What to search, e.g. 'bluetooth speaker' or 'yoga mat'. Any language.
+    # @param page [Integer] 1-based results page to start from (1-100). Use `nextPage` of a
+    # previous response to continue. API default: 1.
+    # @param max_results [Integer] Products to collect across pages (1-480); Alibaba serves 48
+    # per page and each page fetched is billed as one request. API default: 48.
+    # @param sort [String] Order: relevance, sales (sales = most sold in the last 180 days
+    # first). API default: relevance.
+    # @param verified [Boolean] Only Verified suppliers (third-party inspected). API default:
+    # false.
+    # @param verified_pro [Boolean] Only Verified PRO suppliers. API default: false.
+    # @param trade_assurance [Boolean] Only products covered by Trade Assurance. API default:
+    # false.
+    # @param supplier_country [String] Only suppliers located in this country (ISO-2), e.g. CN,
+    # US, IN.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /marketplace/alibaba-search.
+    def alibaba_search(q, page: nil, max_results: nil, sort: nil, verified: nil, verified_pro: nil, trade_assurance: nil, supplier_country: nil, proxy_country: nil)
+      post_json("/marketplace/alibaba-search", {
+        q: q,
+        page: page,
+        max_results: max_results,
+        sort: sort,
+        verified: verified,
+        verified_pro: verified_pro,
+        trade_assurance: trade_assurance,
+        supplier_country: supplier_country,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape one Alibaba.com product's full detail.
+    #
+    # Fetches one Alibaba.com product (by `product_id` or `url`) and returns it as JSON:
+    # `title`, `categories`, `images`, `videos`, price summary (`priceText`,
+    # `priceMin`/`priceMax` in the local `currency` of the proxy country, which varies by
+    # country, and `priceMinUsd`/`priceMaxUsd` in USD, the same for every country), `priceTiers`
+    # (price per quantity range, local `price` and `priceUsd`), `moq` + `unit`, SKU `variants`
+    # (`skuPricing` is `sku` when SKUs carry their own prices, `tiers` when every SKU is priced
+    # by `priceTiers` and the SKU prices are null), `attributes`, `leadTimes` (days per quantity
+    # range), `packaging`, `shippingMethods`, `shipFrom`, `tradeAssurance`, and the `supplier`
+    # (name, store/profile URL, country, location, years on Alibaba, business type,
+    # `goldSupplier`, `verified` + `verifiedBy`, rating, reviews, response time, on-time
+    # delivery rate). Companion to `/marketplace/alibaba-search`.
+    #
+    # @param product_id [String] Numeric Alibaba product id, e.g. '1601919386560' (the number
+    # before .html).
+    # @param url [String] Alibaba product URL, e.g. 'https://www.alibaba.com/product-
+    # detail/..._1601919386560.html'. Either url or product_id is required.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Alibaba prices in that country's currency; USD figures are always included. Leave
+    # blank to let the API pick.
+    # Calls POST /marketplace/alibaba-product.
+    def alibaba_product(product_id = nil, url: nil, proxy_country: nil)
+      post_json("/marketplace/alibaba-product", {
+        product_id: product_id,
+        url: url,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape 1688.com wholesale search results.
+    #
+    # Searches 1688.com (China's B2B wholesale marketplace) for `q` and returns the offers as
+    # JSON: `offerId`, `title`, `url`, `image`/`images`, `price` in yuan (`currency` CNY),
+    # `priceTiers` (price per quantity range with `minQuantity`/`maxQuantity`), `soldText` +
+    # `sold` (lower bound of units sold), `repurchaseRatePercent`, `serviceTags`,
+    # `promotionTags`, `tags`, `sponsored`, and the `supplier` (`name`, `loginId`, `memberId`,
+    # `shopUrl`, `yearsOnPlatform`, `province`, `city`, `factoryInspected`, `businessInspected`,
+    # `superFactory`, `tradeScores`). Sort by relevance, sales or price, filter with
+    # `price_min`/`price_max` (yuan) and `province`, and collect up to `max_results` across
+    # pages (60 per page, each page billed as one request, see `pagesFetched`). Paging:
+    # `nextPage` is the next 1688 page not yet returned (pass it as `page` to continue) and
+    # `hasMore` says whether there is one; when `max_results` ends inside a page, the rest of
+    # that page is not returned (`droppedFromLastPage`), so use multiples of 60 to get every
+    # offer. Text is returned in Chinese as 1688 publishes it. Companion to
+    # `/marketplace/1688-product`.
+    #
+    # @param q [String] What to search, in Chinese or English, e.g. '手机壳', '连衣裙', 'bluetooth
+    # earphones'. Chinese keywords match the most offers.
+    # @param page [Integer] 1-based results page to start from (1-34). Use `nextPage` of a
+    # previous response to continue. API default: 1.
+    # @param max_results [Integer] Offers to collect across pages (1-300); 1688 serves 60 per
+    # page and each page fetched is billed as one request. API default: 60.
+    # @param sort [String] Order: relevance, sales, price_asc, price_desc (sales = most sold in
+    # the last 30 days first; price in yuan). API default: relevance.
+    # @param price_min [Float] Only offers priced at or above this many yuan (CNY).
+    # @param price_max [Float] Only offers priced at or below this many yuan (CNY).
+    # @param province [String] Only suppliers in this Chinese province, by its Chinese name,
+    # e.g. 广东 (Guangdong), 浙江 (Zhejiang), 江苏 (Jiangsu).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'DE',
+    # 'SG'). Leave blank to let the API pick.
+    # Calls POST /marketplace/1688-search.
+    def alibaba1688_search(q, page: nil, max_results: nil, sort: nil, price_min: nil, price_max: nil, province: nil, proxy_country: nil)
+      post_json("/marketplace/1688-search", {
+        q: q,
+        page: page,
+        max_results: max_results,
+        sort: sort,
+        price_min: price_min,
+        price_max: price_max,
+        province: province,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape one 1688.com offer's full detail.
+    #
+    # Fetches one 1688.com offer (by `offer_id` or `url`) and returns it as JSON: `title`,
+    # `status`, `brand`, `category`, prices in yuan (`currency` CNY: `priceText`,
+    # `priceMin`/`priceMax`), `pricing` (`tiers` when every SKU is priced by the quantity ladder
+    # `priceTiers`, `sku` when each SKU carries its own `price`), `originalPriceTiers` (before a
+    # promotion), `unit`, `moq` (minimum order), `available` (stock), `sold` + `soldText` +
+    # `soldPeriod`, `variantOptions` (option names and values with images) and `variants` (every
+    # SKU with `skuId`, `options`, `price`, `available`), `attributes`, `images`, `video`,
+    # `descriptionUrl`, `shipping` (`from`, `dispatch` promise, `unitWeightKg`, `freeShipping`),
+    # `services` (guarantees), `labels`, `rating` (`goodRatePercent`, `score`, `reviewCount`,
+    # `reviewsWithPhotos`, review `tags`), `favorites` and the `supplier` (`name`, `loginId`,
+    # `memberId`, `userId`, `shopUrl`, `serviceScore`, `repeatPurchaseRate3m`, `factory`,
+    # `tpMember`, `location`). Text is returned in Chinese as 1688 publishes it. Companion to
+    # `/marketplace/1688-search`.
+    #
+    # @param offer_id [String] Numeric 1688 offer id, e.g. '735353578254' (the number in
+    # detail.1688.com/offer/<id>.html).
+    # @param url [String] 1688 offer link, e.g.
+    # 'https://detail.1688.com/offer/735353578254.html' (mobile m.1688.com and offerId= links
+    # work too). Either offer_id or url is required.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'DE',
+    # 'SG'). Leave blank to let the API pick.
+    # Calls POST /marketplace/1688-product.
+    def alibaba1688_product(offer_id = nil, url: nil, proxy_country: nil)
+      post_json("/marketplace/1688-product", {
+        offer_id: offer_id,
+        url: url,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Search TikTok Shop products by keyword or category.
+    #
+    # Lists TikTok Shop (US) products for a keyword (`q`) or a category (`category`, URL or id).
+    # Each product card carries `productId`, `url`, `title`, `image`, `price` (current,
+    # original, discountPercent, currency, fromPrice), `rating`, `reviewCount`, `soldCount`,
+    # `brand`, `seller` (id, name, logo), promotion `labels` and, when TikTok binds one, the
+    # promoting `video` (id, url, author, play and like counts, `durationSeconds`). A keyword
+    # search also returns `relatedSearches` and `relatedCategories`; a category returns its
+    # `subcategories` and `breadcrumbs`. Up to 30 products (one page, one billed request). A
+    # keyword or category TikTok has no listing for returns 404.
+    #
+    # @param q [String] Search keyword, e.g. 'led face mask' (or a TikTok Shop keyword URL like
+    # 'https://www.tiktok.com/shop/product/led-face-mask'). Either this or `category`.
+    # @param category [String] List a category instead of a keyword: a category URL
+    # ('https://www.tiktok.com/shop/c/beauty-personal-care/601450') or its numeric id
+    # ('601450').
+    # @param max_results [Integer] Products to return (1-30). One page is read: a keyword lists
+    # up to 30 products, a category about 15. API default: 30.
+    # Calls POST /social/tiktok-shop-search.
+    def tiktok_shop_search(q = nil, category: nil, max_results: nil)
+      post_json("/social/tiktok-shop-search", {
+        q: q,
+        category: category,
+        max_results: max_results,
+      })
+    end
+
+    # Scrape one TikTok Shop product.
+    #
+    # Fetches a public TikTok Shop (US) product page by `url` or `product_id` and returns it as
+    # JSON: `productId`, `url`, `title`, `description` (plus `descriptionImages`), `status`,
+    # `available`, `brand`, `price` (current, original, discountPercent, currency, display
+    # strings, min/max for a price range), `soldCount`, `rating`, `reviewCount`,
+    # `ratingDistribution`, `categories`, `images`, `options` and `variants` (per-SKU price,
+    # stock and availability), `specifications`, `shipping` (fee, free, delivery days and
+    # estimate), promotion `labels`, `seller` (id, name, store URL, rating, followers, sold
+    # count, product / video / review counts, service scores, business name and address) and the
+    # top `reviews` the page shows (rating, text, date, variant, images). One billed request. No
+    # login or cookies; a product that does not exist or is not sold in the US returns 404.
+    #
+    # @param url [String] A TikTok Shop product URL ('https://www.tiktok.com/shop/pdp/goli-
+    # ashwagandha/1729527313880355335', 'https://shop.tiktok.com/us/pdp/1729527313880355335', a
+    # /view/product/ link) or a bare product id. Either this or `product_id`.
+    # @param product_id [String] The numeric product id (e.g. '1729527313880355335').
+    # Calls POST /social/tiktok-shop-product.
+    def tiktok_shop_product(url = nil, product_id: nil)
+      post_json("/social/tiktok-shop-product", {
+        url: url,
+        product_id: product_id,
+      })
+    end
+
+    # Scrape a TikTok Shop store and its products.
+    #
+    # Fetches a TikTok Shop (US) store by URL or seller id and returns its profile as `store`
+    # (id, name, url, rating, followers, soldCount, productCount, reviewCount, videoCount, logo,
+    # label such as 'OFFICIAL SHOP', service `scores` like positive feedback and on-time
+    # delivery, description) plus the `products` on its storefront page (up to 20, same card
+    # shape as /social/tiktok-shop-search) and `hasMore`. The store page does not carry the
+    # seller's business name and address, so `businessName` / `businessAddress` are null here; a
+    # product's `seller` (/social/tiktok-shop-product) has them. A store with no products listed
+    # returns its profile and an empty `products`. One billed request. Most stores answer in a
+    # few seconds; a store TikTok shows only past its verification puzzle (common for smaller
+    # shops) is read through that puzzle and can take up to about 50 s. A seller id TikTok has
+    # no US store for returns 404.
+    #
+    # @param store [String] A TikTok Shop store URL ('https://www.tiktok.com/shop/store/goli-
+    # nutrition/7495794203056835079') or the seller id ('7495794203056835079').
+    # @param max_results [Integer] Storefront products to return (0-20); 0 = store profile only.
+    # One page is read. API default: 20.
+    # Calls POST /social/tiktok-shop-store.
+    def tiktok_shop_store(store, max_results: nil)
+      post_json("/social/tiktok-shop-store", {
+        store: store,
+        max_results: max_results,
+      })
+    end
+
+    # Scrape Vinted product search.
+    #
+    # Searches Vinted for `query` and returns the listings as JSON: `title`, `price` and
+    # `currency`, `brand`, `size`, `condition`, `image` and an item `url`. Pick the marketplace
+    # with `domain`, sort with `order`, filter with `price_from`/`price_to`, and collect up to
+    # `max_results` across pages.
+    #
+    # @param query [String] What to search, e.g. 'nike air max' or 'levis 501'.
+    # @param domain [String] Marketplace TLD: co.uk, com, de, fr, it, es, nl, pl. API default:
+    # co.uk.
+    # @param order [String] Ordering: relevance, newest_first, price_low_to_high,
+    # price_high_to_low. API default: relevance.
+    # @param price_from [Integer] Lowest price to include.
+    # @param price_to [Integer] Highest price to include.
+    # @param max_results [Integer] How many listings to collect across pages. API default: 96.
+    # @param page [Integer] 1-based page to start from (~96 per page). API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to an EU country.
+    # Calls POST /marketplace/vinted-search.
+    def vinted_search(query, domain: nil, order: nil, price_from: nil, price_to: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/marketplace/vinted-search", {
+        query: query,
+        domain: domain,
+        order: order,
+        price_from: price_from,
+        price_to: price_to,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Leboncoin search.
+    #
+    # Searches Leboncoin (France) for `query` and returns the ads as JSON: `id`, `title`,
+    # `price` and `currency`, `location` (city + postcode), `category`, publication `date`,
+    # `image`, listing `url`, `sellerType` (pro/private) and the ad's `attributes`. Narrow with
+    # `category`, `location` and `min_price`/`max_price`, order with `sort`, and collect up to
+    # `max_results` across pages. Paid 'a la une' placements (`sponsored: true`) are left out
+    # unless `include_sponsored=true`.
+    #
+    # @param query [String] What to search, e.g. 'velo electrique' or 'iphone 13'.
+    # @param category [String] Category: vehicles, cars, motorcycles, vans, car_parts,
+    # real_estate, real_estate_sale, rentals, flatshare, holiday_rentals, commercial_property,
+    # electronics, computers, photo_audio_video, phones, consoles, video_games,
+    # computer_accessories, home_garden, furniture, appliances, diy, decoration, garden,
+    # fashion, clothing, shoes, bags_accessories, watches_jewelry, baby_equipment, leisure,
+    # books, sports, bikes, toys, music_instruments, collectibles, antiques, animals, jobs,
+    # job_offers, or a numeric Leboncoin category id.
+    # @param location [String] Where to search: a city ('Bordeaux'), a city with postcode
+    # ('Toulouse 31000'), a department code ('75') or a region ('Ile-de-France').
+    # @param min_price [Integer] Lowest price to include (EUR).
+    # @param max_price [Integer] Highest price to include (EUR).
+    # @param sort [String] Ordering: relevance, newest, price_low, price_high. API default:
+    # relevance.
+    # @param max_results [Integer] How many listings to collect across pages. API default: 35.
+    # @param page [Integer] 1-based page to start from (35 per page). API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Optional.
+    # @param include_sponsored [Boolean] Also return Leboncoin's paid 'a la une' placements
+    # (`sponsored: true`). Off by default: they ignore the query, category and sort. API
+    # default: false.
+    # Calls POST /marketplace/leboncoin-search.
+    def leboncoin_search(query, category: nil, location: nil, min_price: nil, max_price: nil, sort: nil, max_results: nil, page: nil, proxy_country: nil, include_sponsored: nil)
+      post_json("/marketplace/leboncoin-search", {
+        query: query,
+        category: category,
+        location: location,
+        min_price: min_price,
+        max_price: max_price,
+        sort: sort,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+        include_sponsored: include_sponsored,
+      })
+    end
+
+    # Scrape Woolworths (Australia) groceries.
+    #
+    # Woolworths Australia (woolworths.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (stockcode), `name`,
+    # `brand`, `size`, `url`, `barcode`, `price`, `wasPrice`, `onSale`, `savings`, `promotion`
+    # (`type` half_price / special / multibuy / offer, `text`, multibuy `quantity` and `price`),
+    # `unitPrice` (`price`, `per`, `text`), `soldBy`, `inStock`, `available`, `purchaseLimit`,
+    # `isNew`, `sponsored`, `image`, `categories`, `healthStarRating` and `rating`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=product&product=` returns `product`
+    # with those fields and `description`, `ingredients`, `allergens` (`contains`, `mayContain`,
+    # `freeFrom`), `dietary`, `nutrition` (per serving and per 100 g / mL), `servingSize`,
+    # `servingsPerPack`, `storage`, `countryOfOrigin`, `department`, `aisle`, `images` and
+    # `variants`. Prices are Woolworths' online prices in AUD. Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param query [String] What to search for (mode=search), e.g. 'milk', 'tim tam', 'chicken
+    # breast'.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc,
+    # unit_price_desc, name. API default: relevance.
+    # @param specials_only [Boolean] mode=search: only products on special. API default: false.
+    # @param page [Integer] 1-based listing page to start from (36 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-360. Each page fetched is
+    # billed one unit. API default: 36.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: Woolworths answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/woolworths.
+    def woolworths_search(query, sort: nil, specials_only: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/woolworths", {
+        mode: "search",
+        query: query,
+        sort: sort,
+        specials_only: specials_only,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Woolworths (Australia) groceries.
+    #
+    # Woolworths Australia (woolworths.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (stockcode), `name`,
+    # `brand`, `size`, `url`, `barcode`, `price`, `wasPrice`, `onSale`, `savings`, `promotion`
+    # (`type` half_price / special / multibuy / offer, `text`, multibuy `quantity` and `price`),
+    # `unitPrice` (`price`, `per`, `text`), `soldBy`, `inStock`, `available`, `purchaseLimit`,
+    # `isNew`, `sponsored`, `image`, `categories`, `healthStarRating` and `rating`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=product&product=` returns `product`
+    # with those fields and `description`, `ingredients`, `allergens` (`contains`, `mayContain`,
+    # `freeFrom`), `dietary`, `nutrition` (per serving and per 100 g / mL), `servingSize`,
+    # `servingsPerPack`, `storage`, `countryOfOrigin`, `department`, `aisle`, `images` and
+    # `variants`. Prices are Woolworths' online prices in AUD. Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param category [String] mode=category: a browse link
+    # (https://www.woolworths.com.au/shop/browse/dairy-eggs-fridge/milk), its path ('dairy-eggs-
+    # fridge/milk') or a category id ('1_6E4F4E4'). mode=specials: the specials page - 'half-
+    # price' (default), 'lower-shelf-price', 'everyday-low-price', 'seasonal-price', 'buy-more-
+    # save-more', 'online-only-specials' or a specials link.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc,
+    # unit_price_desc, name. API default: relevance.
+    # @param page [Integer] 1-based listing page to start from (36 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-360. Each page fetched is
+    # billed one unit. API default: 36.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: Woolworths answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/woolworths.
+    def woolworths_category(category, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/woolworths", {
+        mode: "category",
+        category: category,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Woolworths (Australia) groceries.
+    #
+    # Woolworths Australia (woolworths.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (stockcode), `name`,
+    # `brand`, `size`, `url`, `barcode`, `price`, `wasPrice`, `onSale`, `savings`, `promotion`
+    # (`type` half_price / special / multibuy / offer, `text`, multibuy `quantity` and `price`),
+    # `unitPrice` (`price`, `per`, `text`), `soldBy`, `inStock`, `available`, `purchaseLimit`,
+    # `isNew`, `sponsored`, `image`, `categories`, `healthStarRating` and `rating`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=product&product=` returns `product`
+    # with those fields and `description`, `ingredients`, `allergens` (`contains`, `mayContain`,
+    # `freeFrom`), `dietary`, `nutrition` (per serving and per 100 g / mL), `servingSize`,
+    # `servingsPerPack`, `storage`, `countryOfOrigin`, `department`, `aisle`, `images` and
+    # `variants`. Prices are Woolworths' online prices in AUD. Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param category [String] mode=category: a browse link
+    # (https://www.woolworths.com.au/shop/browse/dairy-eggs-fridge/milk), its path ('dairy-eggs-
+    # fridge/milk') or a category id ('1_6E4F4E4'). mode=specials: the specials page - 'half-
+    # price' (default), 'lower-shelf-price', 'everyday-low-price', 'seasonal-price', 'buy-more-
+    # save-more', 'online-only-specials' or a specials link.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc,
+    # unit_price_desc, name. API default: relevance.
+    # @param page [Integer] 1-based listing page to start from (36 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-360. Each page fetched is
+    # billed one unit. API default: 36.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: Woolworths answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/woolworths.
+    def woolworths_specials(category: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/woolworths", {
+        mode: "specials",
+        category: category,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Woolworths (Australia) groceries.
+    #
+    # Woolworths Australia (woolworths.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (stockcode), `name`,
+    # `brand`, `size`, `url`, `barcode`, `price`, `wasPrice`, `onSale`, `savings`, `promotion`
+    # (`type` half_price / special / multibuy / offer, `text`, multibuy `quantity` and `price`),
+    # `unitPrice` (`price`, `per`, `text`), `soldBy`, `inStock`, `available`, `purchaseLimit`,
+    # `isNew`, `sponsored`, `image`, `categories`, `healthStarRating` and `rating`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=product&product=` returns `product`
+    # with those fields and `description`, `ingredients`, `allergens` (`contains`, `mayContain`,
+    # `freeFrom`), `dietary`, `nutrition` (per serving and per 100 g / mL), `servingSize`,
+    # `servingsPerPack`, `storage`, `countryOfOrigin`, `department`, `aisle`, `images` and
+    # `variants`. Prices are Woolworths' online prices in AUD. Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param product [String] mode=product: a stockcode ('888137') or a product link
+    # (https://www.woolworths.com.au/shop/productdetails/888137/woolworths-full-cream-milk).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: Woolworths answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/woolworths.
+    def woolworths_product(product, proxy_country: nil)
+      post_json("/groceries/woolworths", {
+        mode: "product",
+        product: product,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Coles (Australia) groceries.
+    #
+    # Coles Australia (coles.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id`, `name`, `brand`,
+    # `size`, `url`, `price`, `wasPrice`, `onSale`, `savings`, `promotion` (`type` half_price /
+    # special / multibuy / offer, `text`, multibuy `quantity` and `price`), `unitPrice`
+    # (`price`, `per`, `text`), `inStock`, `available`, `availableQuantity`, `purchaseLimit`,
+    # `promotionalLimit`, `onlineOnly`, `sponsored`, `image`, `categories` and
+    # `minimumShelfLife`, plus `totalResults`, `totalPages` and `nextPage`. `special` limits a
+    # search or the specials listing to half-price, multibuy or online-only deals.
+    # `mode=product&product=` returns `product` with those fields and `barcode`, `description`,
+    # `ingredients`, `allergens`, `dietary`, `storage`, `nutrition` (per serving and per 100 g /
+    # mL), `servingSize`, `servingsPerPack`, `countryOfOrigin`, `images` and `variants`. Prices
+    # are Coles' online prices in AUD. Listings collect up to `max_results` from `page` on,
+    # billed one unit per page.
+    #
+    # @param query [String] What to search for (mode=search), e.g. 'milk', 'tim tam', 'chicken
+    # breast'.
+    # @param special [String] Products on special only: all, half-price, multibuy, online-only.
+    # mode=specials defaults to 'all'; with mode=search it filters the results.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc. API
+    # default: relevance.
+    # @param page [Integer] 1-based listing page to start from (48 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-480. Each page fetched is
+    # billed one unit. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from: AU, NZ, US or CA
+    # (Coles serves only these). Leave blank to spread over all of them.
+    # Calls POST /groceries/coles.
+    def coles_search(query, special: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/coles", {
+        mode: "search",
+        query: query,
+        special: special,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Coles (Australia) groceries.
+    #
+    # Coles Australia (coles.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id`, `name`, `brand`,
+    # `size`, `url`, `price`, `wasPrice`, `onSale`, `savings`, `promotion` (`type` half_price /
+    # special / multibuy / offer, `text`, multibuy `quantity` and `price`), `unitPrice`
+    # (`price`, `per`, `text`), `inStock`, `available`, `availableQuantity`, `purchaseLimit`,
+    # `promotionalLimit`, `onlineOnly`, `sponsored`, `image`, `categories` and
+    # `minimumShelfLife`, plus `totalResults`, `totalPages` and `nextPage`. `special` limits a
+    # search or the specials listing to half-price, multibuy or online-only deals.
+    # `mode=product&product=` returns `product` with those fields and `barcode`, `description`,
+    # `ingredients`, `allergens`, `dietary`, `storage`, `nutrition` (per serving and per 100 g /
+    # mL), `servingSize`, `servingsPerPack`, `countryOfOrigin`, `images` and `variants`. Prices
+    # are Coles' online prices in AUD. Listings collect up to `max_results` from `page` on,
+    # billed one unit per page.
+    #
+    # @param category [String] mode=category: a browse link
+    # (https://www.coles.com.au/browse/dairy-eggs-fridge/milk) or its path ('dairy-eggs-
+    # fridge/milk').
+    # @param special [String] Products on special only: all, half-price, multibuy, online-only.
+    # mode=specials defaults to 'all'; with mode=search it filters the results.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc. API
+    # default: relevance.
+    # @param page [Integer] 1-based listing page to start from (48 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-480. Each page fetched is
+    # billed one unit. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from: AU, NZ, US or CA
+    # (Coles serves only these). Leave blank to spread over all of them.
+    # Calls POST /groceries/coles.
+    def coles_category(category, special: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/coles", {
+        mode: "category",
+        category: category,
+        special: special,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Coles (Australia) groceries.
+    #
+    # Coles Australia (coles.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id`, `name`, `brand`,
+    # `size`, `url`, `price`, `wasPrice`, `onSale`, `savings`, `promotion` (`type` half_price /
+    # special / multibuy / offer, `text`, multibuy `quantity` and `price`), `unitPrice`
+    # (`price`, `per`, `text`), `inStock`, `available`, `availableQuantity`, `purchaseLimit`,
+    # `promotionalLimit`, `onlineOnly`, `sponsored`, `image`, `categories` and
+    # `minimumShelfLife`, plus `totalResults`, `totalPages` and `nextPage`. `special` limits a
+    # search or the specials listing to half-price, multibuy or online-only deals.
+    # `mode=product&product=` returns `product` with those fields and `barcode`, `description`,
+    # `ingredients`, `allergens`, `dietary`, `storage`, `nutrition` (per serving and per 100 g /
+    # mL), `servingSize`, `servingsPerPack`, `countryOfOrigin`, `images` and `variants`. Prices
+    # are Coles' online prices in AUD. Listings collect up to `max_results` from `page` on,
+    # billed one unit per page.
+    #
+    # @param special [String] Products on special only: all, half-price, multibuy, online-only.
+    # mode=specials defaults to 'all'; with mode=search it filters the results.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, unit_price_asc. API
+    # default: relevance.
+    # @param page [Integer] 1-based listing page to start from (48 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-480. Each page fetched is
+    # billed one unit. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from: AU, NZ, US or CA
+    # (Coles serves only these). Leave blank to spread over all of them.
+    # Calls POST /groceries/coles.
+    def coles_specials(special: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/coles", {
+        mode: "specials",
+        special: special,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Coles (Australia) groceries.
+    #
+    # Coles Australia (coles.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id`, `name`, `brand`,
+    # `size`, `url`, `price`, `wasPrice`, `onSale`, `savings`, `promotion` (`type` half_price /
+    # special / multibuy / offer, `text`, multibuy `quantity` and `price`), `unitPrice`
+    # (`price`, `per`, `text`), `inStock`, `available`, `availableQuantity`, `purchaseLimit`,
+    # `promotionalLimit`, `onlineOnly`, `sponsored`, `image`, `categories` and
+    # `minimumShelfLife`, plus `totalResults`, `totalPages` and `nextPage`. `special` limits a
+    # search or the specials listing to half-price, multibuy or online-only deals.
+    # `mode=product&product=` returns `product` with those fields and `barcode`, `description`,
+    # `ingredients`, `allergens`, `dietary`, `storage`, `nutrition` (per serving and per 100 g /
+    # mL), `servingSize`, `servingsPerPack`, `countryOfOrigin`, `images` and `variants`. Prices
+    # are Coles' online prices in AUD. Listings collect up to `max_results` from `page` on,
+    # billed one unit per page.
+    #
+    # @param product [String] mode=product: a Coles product id ('8150288') or a product link
+    # (https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288).
+    # @param proxy_country [String] Proxy country the request is sent from: AU, NZ, US or CA
+    # (Coles serves only these). Leave blank to spread over all of them.
+    # Calls POST /groceries/coles.
+    def coles_product(product, proxy_country: nil)
+      post_json("/groceries/coles", {
+        mode: "product",
+        product: product,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape ALDI Australia groceries.
+    #
+    # ALDI Australia (aldi.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (SKU), `name`,
+    # `brand`, `size`, `url`, `price`, `priceText`, `wasPrice`, `onSale`, `unitPrice` (`price`,
+    # `per`, `text`), `bottleDeposit`, `specialBuy` (on-sale date and label), `badges`,
+    # `available`, `soldOnline`, `ageRestricted`, `image`, `categories` and `categoryKeys`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=specials` lists one Special Buys drop
+    # (the current one, or the date / link in `category`; `theme` narrows it) and returns
+    # `promotions`, every drop ALDI has announced with its themes. `mode=product&product=`
+    # returns `product` with those fields and `description`, `ingredients`, `allergens`,
+    # `claims`, `storage`, `usage`, `countryOfOrigin` and `images`. Prices are ALDI's in-store
+    # prices in AUD (ALDI Australia does not sell groceries online). Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param query [String] What to search for (mode=search), e.g. 'milk', 'chocolate',
+    # 'nappies'.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, name_asc, name_desc.
+    # API default: relevance.
+    # @param page [Integer] 1-based listing page to start from (60 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-600. Each page fetched is
+    # billed one unit. API default: 60.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: ALDI answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/aldi-au.
+    def aldi_au_search(query, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/aldi-au", {
+        mode: "search",
+        query: query,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape ALDI Australia groceries.
+    #
+    # ALDI Australia (aldi.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (SKU), `name`,
+    # `brand`, `size`, `url`, `price`, `priceText`, `wasPrice`, `onSale`, `unitPrice` (`price`,
+    # `per`, `text`), `bottleDeposit`, `specialBuy` (on-sale date and label), `badges`,
+    # `available`, `soldOnline`, `ageRestricted`, `image`, `categories` and `categoryKeys`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=specials` lists one Special Buys drop
+    # (the current one, or the date / link in `category`; `theme` narrows it) and returns
+    # `promotions`, every drop ALDI has announced with its themes. `mode=product&product=`
+    # returns `product` with those fields and `description`, `ingredients`, `allergens`,
+    # `claims`, `storage`, `usage`, `countryOfOrigin` and `images`. Prices are ALDI's in-store
+    # prices in AUD (ALDI Australia does not sell groceries online). Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param category [String] mode=category: a category link
+    # (https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160) or its key
+    # ('1111111160'; '1588161425841179' = Lower Prices). mode=specials: the Special Buys drop -
+    # its date ('2026-10-14') or link (https://www.aldi.com.au/special-buys/2026-10-14); blank =
+    # the current drop.
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, name_asc, name_desc.
+    # API default: relevance.
+    # @param page [Integer] 1-based listing page to start from (60 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-600. Each page fetched is
+    # billed one unit. API default: 60.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: ALDI answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/aldi-au.
+    def aldi_au_category(category, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/aldi-au", {
+        mode: "category",
+        category: category,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape ALDI Australia groceries.
+    #
+    # ALDI Australia (aldi.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (SKU), `name`,
+    # `brand`, `size`, `url`, `price`, `priceText`, `wasPrice`, `onSale`, `unitPrice` (`price`,
+    # `per`, `text`), `bottleDeposit`, `specialBuy` (on-sale date and label), `badges`,
+    # `available`, `soldOnline`, `ageRestricted`, `image`, `categories` and `categoryKeys`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=specials` lists one Special Buys drop
+    # (the current one, or the date / link in `category`; `theme` narrows it) and returns
+    # `promotions`, every drop ALDI has announced with its themes. `mode=product&product=`
+    # returns `product` with those fields and `description`, `ingredients`, `allergens`,
+    # `claims`, `storage`, `usage`, `countryOfOrigin` and `images`. Prices are ALDI's in-store
+    # prices in AUD (ALDI Australia does not sell groceries online). Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param category [String] mode=category: a category link
+    # (https://www.aldi.com.au/products/dairy-eggs-fridge/milk/k/1111111160) or its key
+    # ('1111111160'; '1588161425841179' = Lower Prices). mode=specials: the Special Buys drop -
+    # its date ('2026-10-14') or link (https://www.aldi.com.au/special-buys/2026-10-14); blank =
+    # the current drop.
+    # @param theme [String] mode=specials: one theme of the drop, e.g. 'Gardening' (see
+    # `promotions[].themes`).
+    # @param sort [String] Listing order: relevance, price_asc, price_desc, name_asc, name_desc.
+    # API default: relevance.
+    # @param page [Integer] 1-based listing page to start from (60 products per page). API
+    # default: 1.
+    # @param max_results [Integer] Products to collect across pages, 1-600. Each page fetched is
+    # billed one unit. API default: 60.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: ALDI answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/aldi-au.
+    def aldi_au_specials(category: nil, theme: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/groceries/aldi-au", {
+        mode: "specials",
+        category: category,
+        theme: theme,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape ALDI Australia groceries.
+    #
+    # ALDI Australia (aldi.com.au) products as JSON. `mode=search&query=`,
+    # `mode=category&category=` and `mode=specials` return `products`: `id` (SKU), `name`,
+    # `brand`, `size`, `url`, `price`, `priceText`, `wasPrice`, `onSale`, `unitPrice` (`price`,
+    # `per`, `text`), `bottleDeposit`, `specialBuy` (on-sale date and label), `badges`,
+    # `available`, `soldOnline`, `ageRestricted`, `image`, `categories` and `categoryKeys`, plus
+    # `totalResults`, `totalPages` and `nextPage`. `mode=specials` lists one Special Buys drop
+    # (the current one, or the date / link in `category`; `theme` narrows it) and returns
+    # `promotions`, every drop ALDI has announced with its themes. `mode=product&product=`
+    # returns `product` with those fields and `description`, `ingredients`, `allergens`,
+    # `claims`, `storage`, `usage`, `countryOfOrigin` and `images`. Prices are ALDI's in-store
+    # prices in AUD (ALDI Australia does not sell groceries online). Listings collect up to
+    # `max_results` from `page` on, billed one unit per page.
+    #
+    # @param product [String] mode=product: an ALDI SKU ('000000000000398691') or a product link
+    # (https://www.aldi.com.au/product/farmdale-light-milk-2l-000000000000398691).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'AU',
+    # 'US'). Leave blank: ALDI answers every country, so the load spreads over all exits.
+    # Calls POST /groceries/aldi-au.
+    def aldi_au_product(product, proxy_country: nil)
+      post_json("/groceries/aldi-au", {
+        mode: "product",
+        product: product,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Booking.com hotels.
+    #
+    # Searches Booking.com for `location` and returns the properties as JSON: `name`, `price`
+    # (with `checkin`/`checkout`), `reviewScore`, `address`, coordinates, `image` and a hotel
+    # `url`. Set `adults`, `children`, `rooms` and `currency`, and collect up to `max_results`
+    # across pages. Prices only appear when check-in/check-out dates are given.
+    #
+    # @param location [String] City or place to search, e.g. 'Austin' or 'Paris'.
+    # @param checkin [String] Check-in YYYY-MM-DD (needed for prices).
+    # @param checkout [String] Check-out YYYY-MM-DD.
+    # @param adults [Integer] Number of adults.
+    # @param children [Integer] Number of children.
+    # @param rooms [Integer] Number of rooms.
+    # @param currency [String] Price currency: USD, EUR, GBP, AUD, CAD, CHF, JPY, CNY, INR, BRL,
+    # MXN, PLN, SEK, NOK, DKK, AED, SGD, ZAR, TRY, RUB. API default: USD.
+    # @param max_results [Integer] How many properties to collect across pages. API default: 25.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE').
+    # Calls POST /travel/booking.
+    def booking_hotels(location, checkin: nil, checkout: nil, adults: nil, children: nil, rooms: nil, currency: nil, max_results: nil, proxy_country: nil)
+      post_json("/travel/booking", {
+        location: location,
+        checkin: checkin,
+        checkout: checkout,
+        adults: adults,
+        children: children,
+        rooms: rooms,
+        currency: currency,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Booking.com hotel reviews.
+    #
+    # Given a Booking.com `hotel` (page URL or `<cc>/<slug>`), returns its newest guest
+    # `reviews`: `id`, `reviewDate`, `rating`, `ratingText`, `title`, `ratingBand`,
+    # `positiveText`, `negativeText`, `reviewer` (`name`, `country`, `countryCode`), `tripType`,
+    # `travelerType`, `nights`, `stayMonth`, `helpfulVotes`, `submittedFromMobile`, `language`
+    # and the raw `tags`. Booking serves the newest 15 reviews written in each language: pick
+    # the languages with `languages` (or `all`), cap the total with `max_results` and drop older
+    # reviews with `since`. Billed one unit per language page fetched (`pagesFetched`).
+    #
+    # @param hotel [String] Booking.com hotel page URL, e.g.
+    # https://www.booking.com/hotel/fr/le-meurice.html (a locale suffix such as .en-gb.html and
+    # query parameters are fine), or `<cc>/<slug>` such as fr/le-meurice.
+    # @param languages [String] Review languages to read, comma-separated, or `all`: en, de, fr,
+    # es, it, nl, pt, pl, ru, ja, zh, ko, sv, da, no, fi, cs, tr. Default en. Booking serves the
+    # newest 15 reviews written in each language; each language is one page and one billed unit,
+    # fetched in the order given until max_results is reached.
+    # @param max_results [Integer] How many reviews to return across languages (1-270, at most
+    # 15 per language). API default: 15.
+    # @param since [String] Only reviews written on or after this date (YYYY-MM-DD).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE').
+    # Calls POST /travel/booking-reviews.
+    def booking_reviews(hotel, languages: nil, max_results: nil, since: nil, proxy_country: nil)
+      post_json("/travel/booking-reviews", {
+        hotel: hotel,
+        languages: languages,
+        max_results: max_results,
+        since: since,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Airbnb stay listings.
+    #
+    # Searches Airbnb for `location` and returns the stay listings as JSON: `name`, `roomType`,
+    # `price` (USD by default) with any original price, `rating` and `reviewCount`, coordinates,
+    # `badges` (e.g. Guest favourite), `image` and a clean room `url`. Filter with
+    # `checkin`/`checkout`, `adults`, `min_price`/`max_price` and `room_type`, and collect up to
+    # `max_results` across pages.
+    #
+    # @param location [String] City to search, e.g. 'Austin, TX' or 'Paris, France'.
+    # @param checkin [String] Check-in date YYYY-MM-DD (with checkout).
+    # @param checkout [String] Check-out date YYYY-MM-DD (with checkin).
+    # @param adults [Integer] Number of adult guests.
+    # @param room_type [String] Room type filter: entire_home, private_room, hotel_room,
+    # shared_room. Omit for all.
+    # @param min_price [Integer] Minimum nightly price.
+    # @param max_price [Integer] Maximum nightly price.
+    # @param max_results [Integer] How many listings to collect across pages. API default: 48.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US so prices are in USD.
+    # Calls POST /travel/airbnb.
+    def airbnb_search(location, checkin: nil, checkout: nil, adults: nil, room_type: nil, min_price: nil, max_price: nil, max_results: nil, proxy_country: nil)
+      post_json("/travel/airbnb", {
+        location: location,
+        checkin: checkin,
+        checkout: checkout,
+        adults: adults,
+        room_type: room_type,
+        min_price: min_price,
+        max_price: max_price,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape an Airbnb listing's full details.
+    #
+    # Fetches one Airbnb stay (by listing id or room URL) and returns it as JSON: `title`,
+    # `description`, `roomType`, `propertyType`, `location` (city, country, `lat`/`lng`), `host`
+    # (name, `isSuperhost`, `responseRate`, `yearsHosting`, photo), `rating` (overall plus
+    # accuracy, cleanliness, check-in, communication, location, value), `reviewsCount`,
+    # `guests`, `bedrooms`, `beds`, `bathrooms`, grouped `amenities`, `photos` with captions,
+    # `highlights`, `houseRules`, `checkIn`/`checkOut` times and `isGuestFavorite`. Add
+    # `check_in`/`check_out` for `available`, the `cancellationPolicy` and `price` (total,
+    # nightly, breakdown) in `currency`; add `include_reviews` for up to `max_reviews` guest
+    # `reviews`. Companion to the Airbnb search plugin (`/travel/airbnb`).
+    #
+    # @param room [String] Airbnb listing id (e.g. 23860926) or a room URL on any Airbnb domain,
+    # e.g. 'https://www.airbnb.co.uk/rooms/23860926'.
+    # @param check_in [String] Check-in date YYYY-MM-DD. With check_out, adds price,
+    # availability and the cancellation policy.
+    # @param check_out [String] Check-out date YYYY-MM-DD (with check_in).
+    # @param adults [Integer] Adult guests (affects the price). API default: 1.
+    # @param children [Integer] Children aged 2-12. API default: 0.
+    # @param infants [Integer] Infants under 2. API default: 0.
+    # @param pets [Integer] Pets. API default: 0.
+    # @param currency [String] Price currency, ISO code such as USD, EUR, GBP. API default: USD.
+    # @param locale [String] Language for Airbnb's texts, e.g. en, de, fr, es, pt-BR. Host-
+    # written text is returned translated when Airbnb has a translation. API default: en.
+    # @param include_reviews [Boolean] Also return guest reviews. API default: false.
+    # @param max_reviews [Integer] How many reviews to return with include_reviews (1-100). API
+    # default: 20.
+    # @param reviews_sort [String] Review order: most_relevant, most_recent, highest_rated,
+    # lowest_rated. API default: most_relevant.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /travel/airbnb-room.
+    def airbnb_room(room, check_in: nil, check_out: nil, adults: nil, children: nil, infants: nil, pets: nil, currency: nil, locale: nil, include_reviews: nil, max_reviews: nil, reviews_sort: nil, proxy_country: nil)
+      post_json("/travel/airbnb-room", {
+        room: room,
+        check_in: check_in,
+        check_out: check_out,
+        adults: adults,
+        children: children,
+        infants: infants,
+        pets: pets,
+        currency: currency,
+        locale: locale,
+        include_reviews: include_reviews,
+        max_reviews: max_reviews,
+        reviews_sort: reviews_sort,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape all reviews of an Airbnb listing.
+    #
+    # Given an Airbnb `room` (listing id or room URL), returns its guest `reviews`: `id`,
+    # `rating`, `text` (as written) with its `language`, `translatedText` (Airbnb's translation
+    # into `locale`), `date` (ISO), `localizedDate`, `stayDetail`, `photos`, `reviewer` (`id`,
+    # `name`, `photo`, `location` or `tenure`, `profileUrl`, `profileId`, `isSuperhost`,
+    # `deleted`) and the host's `response`. `reviewer.id` is Airbnb's account id (the one in its
+    # photo URLs; airbnb.com/users/show/<id> asks anonymous visitors to log in), while
+    # `profileUrl` is the public profile link Airbnb's own review cards open, keyed by a
+    # separate public id given as `profileId`. `deleted` is true when the guest has since closed
+    # their Airbnb account; Airbnb still sends the name, photo and location or tenure from the
+    # review, and they are returned as sent. Reads every review, not just the few on the room
+    # page: page with `page` (or `offset`) and `max_reviews` (up to 500 per call), order with
+    # `sort` (most_relevant, most_recent, highest_rated, lowest_rated) and drop older reviews
+    # with `since`. Also returns the `listing` summary (title, overall and category `rating`,
+    # `ratingDistribution`, `ratingCounts`, `reviewsCount`, `reviewTags`, host) and
+    # `totalResults`, `hasMore`, `nextPage`, `nextOffset`. `ratingDistribution` is Airbnb's own
+    # list of each star's share of the ratings as a 0-1 fraction (`{"stars": 5, "percentage":
+    # 0.957}` = 95.7%), not a count like the other review plugins return; `ratingCounts` gives
+    # the number of ratings per star (`{"5": 692, ...}`) worked out from those shares and
+    # `reviewsCount`, and is null when the shares do not fit it (seen on hotel listings, whose
+    # distribution covers more ratings than `reviewsCount`). Billed one unit per 50-review page
+    # read (`pagesFetched`). Companion to the Airbnb search (`/travel/airbnb`) and listing
+    # (`/travel/airbnb-room`) plugins.
+    #
+    # @param room [String] Airbnb listing id (e.g. 23860926) or a room URL on any Airbnb domain,
+    # e.g. 'https://www.airbnb.co.uk/rooms/23860926'.
+    # @param max_reviews [Integer] How many reviews to return (1-500). Airbnb serves 50 reviews
+    # per request; each request is one billed unit. API default: 50.
+    # @param page [Integer] 1-based page of `max_reviews`-sized pages (1-1000). Use the
+    # `nextPage` of a previous response to continue. API default: 1.
+    # @param offset [Integer] Start at this review position instead of `page` (0-20000). Use the
+    # `nextOffset` of a previous response to resume exactly.
+    # @param sort [String] Review order: most_relevant, most_recent, highest_rated, lowest_rated
+    # (the default is Airbnb's own order). API default: most_relevant.
+    # @param locale [String] Language to translate reviews and host responses into, e.g. en, de,
+    # fr, es, pt-BR. The original text and its language are always returned too. API default:
+    # en.
+    # @param since [String] Only reviews written on or after this date (YYYY-MM-DD). With
+    # sort=most_recent it also stops paging once older reviews start.
+    # @param include_listing [Boolean] Also return the listing summary (title, overall and
+    # category ratings, rating distribution, host). Set false to skip that request. API default:
+    # true.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE').
+    # Calls POST /travel/airbnb-reviews.
+    def airbnb_reviews(room, max_reviews: nil, page: nil, offset: nil, sort: nil, locale: nil, since: nil, include_listing: nil, proxy_country: nil)
+      post_json("/travel/airbnb-reviews", {
+        room: room,
+        max_reviews: max_reviews,
+        page: page,
+        offset: offset,
+        sort: sort,
+        locale: locale,
+        since: since,
+        include_listing: include_listing,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a TripAdvisor list (restaurants / hotels / attractions).
+    #
+    # Given a TripAdvisor list `url` (Restaurants, Hotels or Attractions for a city/area),
+    # returns the places as JSON: `name`, `url`, `image`, `rating`, `reviewCount`, `priceRange`,
+    # `cuisine`, `phone`, `address`, `country` and `coordinates`. Paginates through
+    # TripAdvisor's `-oaN-` pages up to `max_results`. Data is read from TripAdvisor's
+    # schema.org ld+json, which is more stable than its HTML.
+    #
+    # @param url [String] TripAdvisor list URL (Restaurants / Hotels / Attractions), e.g.
+    # https://www.tripadvisor.com/Restaurants-g60763-New_York_City_New_York.html
+    # @param max_results [Integer] How many places to collect across pages (~30 per page, max
+    # 1020). TripAdvisor renders slowly, so large values take a while. API default: 30.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /travel/tripadvisor.
+    def tripadvisor_list(url, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/travel/tripadvisor", {
+        url: url,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape TripAdvisor reviews (hotels / restaurants / attractions).
+    #
+    # Given a TripAdvisor place review `url` (Hotel_Review, Restaurant_Review, Attraction_Review
+    # or AttractionProductReview, any TripAdvisor site) or a `location_id`, returns the place
+    # summary (`name`, `type`, `rating`, `reviewsCount`, `ratingHistogram`, `subratings`,
+    # `address`, `coordinates`, `phone`, `website`) and its `reviews`: `title`, `text`,
+    # `rating`, `publishedDate`, `travelDate`, `tripType`, `language`, `helpfulVotes`, `user`,
+    # `subratings`, `photos` and `ownerResponse`. Newest first; pages through TripAdvisor's
+    # review pages up to `max_reviews`. Pick the review language with `language` and cut off old
+    # reviews with `since`. Billed one unit per review page fetched (`pagesFetched`).
+    #
+    # @param url [String] TripAdvisor place review page on any TripAdvisor site: Hotel_Review,
+    # Restaurant_Review, Attraction_Review or AttractionProductReview, e.g.
+    # https://www.tripadvisor.com/Hotel_Review-g60763-d93589-Reviews-The_Michelangelo_New_York-
+    # New_York_City_New_York.html. Pass this or `location_id`.
+    # @param location_id [Integer] TripAdvisor location id (the digits after -d in a place URL,
+    # e.g. 93589). Pass this or `url`.
+    # @param max_reviews [Integer] How many reviews to collect across pages (1-200). TripAdvisor
+    # shows 10 reviews per page (15 for restaurants); each page is one billed unit. API default:
+    # 20.
+    # @param page [Integer] 1-based review page to start from (10 reviews per page, 15 for
+    # restaurants). Use the `nextPage` of a previous response to continue. API default: 1.
+    # @param language [String] Review language, which TripAdvisor ties to its site: en, de, fr,
+    # it, es, pt, nl, ja, ko, ru, sv, tr, da. Default: the language of the URL's site
+    # (tripadvisor.com = en), or - when that site lists no reviews for the place - the place's
+    # most-reviewed of these languages. Reviews written in other languages appear machine-
+    # translated, flagged by `isMachineTranslated` and `originalLanguage`.
+    # @param since [String] Only reviews published on or after this date (YYYY-MM-DD). Stops
+    # paging once older reviews start, so it also saves pages.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank: pinning a country makes the call much slower.
+    # Calls POST /travel/tripadvisor-reviews.
+    def tripadvisor_reviews(url = nil, location_id: nil, max_reviews: nil, page: nil, language: nil, since: nil, proxy_country: nil)
+      post_json("/travel/tripadvisor-reviews", {
+        url: url,
+        location_id: location_id,
+        max_reviews: max_reviews,
+        page: page,
+        language: language,
+        since: since,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Shopping product listings.
+    #
+    # Runs the Google Shopping vertical (`udm=28`) for `q` and returns the product cards as
+    # JSON: `title`, `price`, `currency`, `originalPrice`, `discount`, `merchant`, `rating` and
+    # `reviewCount`. Set `proxy_country`/`gl` to target a market (prices/merchants are region-
+    # specific) and `min_price`/`max_price` to filter. One render returns the first page of
+    # products (v1). Note: Google Shopping exposes no per-product URL, so `url` is omitted and
+    # `image` is best-effort.
+    #
+    # @param q [String] Product search term, e.g. 'wireless headphones'.
+    # @param gl [String] Market of search, ISO-2, e.g. 'us', 'de'. Sets prices/merchants. API
+    # default: us.
+    # @param min_price [Integer] Minimum price filter (whole units, gl currency).
+    # @param max_price [Integer] Maximum price filter (whole units, gl currency).
+    # @param max_results [Integer] How many products to return (v1: first page). API default:
+    # 60.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Prices/merchants are market-specific.
+    # Calls POST /goods/google-shopping.
+    def google_shopping(q, gl: nil, min_price: nil, max_price: nil, max_results: nil, proxy_country: nil)
+      post_json("/goods/google-shopping", {
+        q: q,
+        gl: gl,
+        min_price: min_price,
+        max_price: max_price,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Jobs listings.
+    #
+    # Runs the Google Jobs vertical (`udm=8`) for `q` and returns the job cards as JSON:
+    # `title`, `company`, `location`, `via` (source), `salary`, `employmentType`, `remote`,
+    # `postedAge`, `qualifications`, `benefits`, `logo`, a stable `jobId` and a `shareUrl`.
+    # Append a `location` to narrow the search, and set `proxy_country`/`gl`/`hl` to target a
+    # market. One render returns ~10 jobs (v1).
+    #
+    # @param q [String] Job search term, e.g. 'software engineer' or 'nurse'.
+    # @param location [String] Optional location, appended to the query, e.g. 'Austin, TX'.
+    # @param hl [String] Google UI language, e.g. 'en', 'de'. API default: en.
+    # @param gl [String] Google country of search, ISO-2, e.g. 'us'. API default: us.
+    # @param max_results [Integer] How many jobs to return. One render yields ~10 (v1). API
+    # default: 10.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Jobs are location-sensitive; pick the market you want.
+    # Calls POST /jobs/google-jobs.
+    def google_jobs(q, location: nil, hl: nil, gl: nil, max_results: nil, proxy_country: nil)
+      post_json("/jobs/google-jobs", {
+        q: q,
+        location: location,
+        hl: hl,
+        gl: gl,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Trends (interest over time, by region, related queries).
+    #
+    # Compares 1-5 `keywords` on Google Trends and returns the data behind the explore page as
+    # JSON: `interestOverTime` (one point per time bucket with a 0-100 value per keyword, ISO
+    # `date`, `timestamp`, `isPartial`), `averages`, `interestByRegion` (`geoCode`, `geoName`,
+    # values per keyword), and per keyword `relatedQueries` and `relatedTopics` (opt-in via
+    # `sections`), each with `top` and `rising` lists. Filter with `geo` (worldwide, country,
+    # region or US metro), `timeframe` (presets such as 'today 12-m' or a custom date range),
+    # `category` and `property` (web, images, news, youtube, shopping). Use `sections` to fetch
+    # only what you need. Billed as one request per keyword compared.
+    #
+    # @param keywords [String, Array<String>] 1-5 search terms to compare, comma-separated, e.g.
+    # 'coffee,tea'. A Knowledge Graph topic id such as '/m/0dl567' also works.
+    # @param geo [String] Where: empty = worldwide, an ISO-2 country ('US'), a region ('US-CA')
+    # or a US metro ('US-CA-807').
+    # @param timeframe [String] Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today
+    # 3-m, today 12-m, today 5-y, all, or a custom 'YYYY-MM-DD YYYY-MM-DD' (hourly for the last
+    # 7 days: 'YYYY-MM-DDTHH YYYY-MM-DDTHH'). API default: today 12-m.
+    # @param category [Integer] Google Trends category id (0 = all categories, e.g. 71 = Food &
+    # Drink, 5 = Computers & Electronics). API default: 0.
+    # @param property [String] Which Google search to measure: web, images, news, youtube,
+    # shopping. API default: web.
+    # @param hl [String] Language of labels (region names, topic titles), e.g. 'en-US', 'de',
+    # 'fr'. API default: en-US.
+    # @param tz [Integer] Timezone offset in minutes that day/hour buckets align to (Trends'
+    # convention: 300 = UTC-5, -60 = UTC+1). Default 0 = UTC. API default: 0.
+    # @param region_resolution [String] Level of the interest-by-region map: country, region,
+    # city, dma. Default = Trends' own choice (countries worldwide, regions in a country).
+    # @param include_low_volume [Boolean] Include regions with low search volume in the region
+    # map. API default: false.
+    # @param sections [String] What to fetch: a comma list of interest_over_time,
+    # interest_by_region, related_queries, related_topics, or 'all'. Fewer sections = faster.
+    # related_topics is opt-in (Google often returns it empty). API default:
+    # interest_over_time,interest_by_region,related_queries.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Optional - by default a country outside the US and Europe is used; results follow
+    # `geo`, not the proxy country.
+    # Calls POST /trends/google-trends.
+    def google_trends(keywords, geo: nil, timeframe: nil, category: nil, property: nil, hl: nil, tz: nil, region_resolution: nil, include_low_volume: nil, sections: nil, proxy_country: nil)
+      post_json("/trends/google-trends", {
+        keywords: plugin_join(keywords, ","),
+        geo: geo,
+        timeframe: timeframe,
+        category: category,
+        property: property,
+        hl: hl,
+        tz: tz,
+        region_resolution: region_resolution,
+        include_low_volume: include_low_volume,
+        sections: sections,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Maps place details.
+    #
+    # Returns the full data for one Google Maps place as JSON: `name`, `address` (+
+    # `addressLines`), `phone`, `website`, `rating`, `categories`, `latitude`/`longitude`,
+    # `plusCode`, `hours` + `openNow`, `description`, `photo`, `cid`, `featureId`,
+    # `googleMapsUrl` and `relatedPlaces`. Identify the place with `place_id` (ChIJ...), a Maps
+    # `url`, or a raw `feature_id` (0xHEX:0xHEX). Location-neutral - the feature id resolves the
+    # place directly; `proxy_country` defaults to a US proxy to clear Google's consent wall.
+    #
+    # @param url [String] A Google Maps place URL (share link or /maps/place/... URL). The
+    # feature id or place_id is read out of it.
+    # @param place_id [String] A Google place_id, e.g. 'ChIJN1t_tDeuEmsRUsoyG83frY4'.
+    # @param feature_id [String] A Maps feature id '0xHEX:0xHEX', e.g.
+    # '0x47e66e2964e34e2d:0x8ddca9ee380ef7e0'. Fastest - no resolve step.
+    # @param hl [String] Google UI language, e.g. 'en', 'de', 'fr'. API default: en.
+    # @param gl [String] Google country, ISO-2 lowercase, e.g. 'us'. API default: us.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US - an EU country hits Google's consent wall. API default: us.
+    # @param raw [Boolean] Include the decoded place core array under `raw`. API default: false.
+    # Calls POST /maps/place-details.
+    def maps_place_details(url: nil, place_id: nil, feature_id: nil, hl: nil, gl: nil, proxy_country: nil, raw: nil)
+      post_json("/maps/place-details", {
+        url: url,
+        place_id: place_id,
+        feature_id: feature_id,
+        hl: hl,
+        gl: gl,
+        proxy_country: proxy_country,
+        raw: raw,
+      })
+    end
+
+    # Search Bing.
+    #
+    # Searches Bing for `keyword` in a real browser and returns the results page as JSON:
+    # `topAds`, `bottomAds`, `organic` (each with `position`, `title`, `url`, `displayedUrl`,
+    # `domain`, `description`), `relatedSearches` and `totalResults`. Same parameters and
+    # response shape as `/serpApi`. `proxy_country` sets both the market and the location the
+    # search is sent from, which decides the ads.
+    #
+    # @param keyword [String] Search terms.
+    # @param pages_to_check [Integer] How many result pages to collect (1-10, ~10 results each).
+    # API default: 1.
+    # @param proxy_country [String] Country to search from (ISO-2). Sets the result market and
+    # the location the search is sent from, which decides the ads. Defaults to US.
+    # @param language [String] Interface language (ISO-639-1, e.g. en, de). Defaults to en.
+    # Calls POST /search/bing.
+    def bing_search(keyword, pages_to_check: nil, proxy_country: nil, language: nil)
+      post_json("/search/bing", {
+        keyword: keyword,
+        pages_to_check: pages_to_check,
+        proxy_country: proxy_country,
+        language: language,
+      })
+    end
+
+    # Search Bing Images.
+    #
+    # Runs Bing Images for `q` in a real browser and returns the image results as JSON, in the
+    # same shape as `/images/google-search`. Every result carries `imageUrl` (the origin image,
+    # not a Bing thumbnail), `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`,
+    # `thumbnailUrl`, `width`, `height` and `bingImagesUrl` (Bing's image viewer link). `pages`
+    # fetches up to 10 result pages of ~35 each; every page fetched is billed as one request.
+    #
+    # @param q [String] Image search term, e.g. 'eiffel tower'.
+    # @param pages [Integer] How many Bing Images result pages to fetch (1-10, ~35 results
+    # each). Each page fetched is billed as one request. API default: 1.
+    # @param max_results [Integer] Optional cap on the number of results returned (default: all
+    # results of the fetched pages).
+    # @param proxy_country [String] Country to search from (ISO-2); sets the Bing market.
+    # Defaults to US.
+    # @param language [String] Interface language (ISO-639-1, e.g. en, de). Defaults to en.
+    # Calls POST /images/bing-search.
+    def bing_images(q, pages: nil, max_results: nil, proxy_country: nil, language: nil)
+      post_json("/images/bing-search", {
+        q: q,
+        pages: pages,
+        max_results: max_results,
+        proxy_country: proxy_country,
+        language: language,
+      })
+    end
+
+    # Search DuckDuckGo.
+    #
+    # Searches DuckDuckGo for `keyword` and returns the results as JSON: `topAds`, `bottomAds`,
+    # `organic` (each with `position`, `title`, `url`, `displayedUrl`, `domain`, `description`)
+    # and `relatedSearches`. Same parameters and response shape as `/serpApi`. The first page is
+    # rendered in a real browser and carries the ads; further pages add organic results.
+    #
+    # @param keyword [String] Search terms.
+    # @param pages_to_check [Integer] How many result pages to collect (1-10, ~10 results each).
+    # API default: 1.
+    # @param proxy_country [String] Country to search from (ISO-2). Sets the result market and
+    # the location the search is sent from, which decides the ads. Defaults to US.
+    # @param language [String] Interface language (ISO-639-1, e.g. en, de). Defaults to en.
+    # Calls POST /search/duckduckgo.
+    def duckduckgo_search(keyword, pages_to_check: nil, proxy_country: nil, language: nil)
+      post_json("/search/duckduckgo", {
+        keyword: keyword,
+        pages_to_check: pages_to_check,
+        proxy_country: proxy_country,
+        language: language,
+      })
+    end
+
+    # Search Yahoo.
+    #
+    # Searches Yahoo for `keyword` in a real browser and returns the results page as JSON:
+    # `topAds`, `bottomAds`, `organic` (each with `position`, `title`, `url`, `displayedUrl`,
+    # `domain`, `description`) and `relatedSearches`. Same parameters and response shape as
+    # `/serpApi`. `proxy_country` picks Yahoo's regional site and the location the search is
+    # sent from, which decides the ads; `language`, when set, restricts results to that
+    # language.
+    #
+    # @param keyword [String] Search terms.
+    # @param pages_to_check [Integer] How many result pages to collect (1-10, ~10 results each).
+    # API default: 1.
+    # @param proxy_country [String] Country to search from (ISO-2). Sets the result market and
+    # the location the search is sent from, which decides the ads. Defaults to US.
+    # @param language [String] Interface language (ISO-639-1, e.g. en, de). Defaults to en.
+    # Calls POST /search/yahoo.
+    def yahoo_search(keyword, pages_to_check: nil, proxy_country: nil, language: nil)
+      post_json("/search/yahoo", {
+        keyword: keyword,
+        pages_to_check: pages_to_check,
+        proxy_country: proxy_country,
+        language: language,
+      })
+    end
+
+    # Search Yahoo Images.
+    #
+    # Runs Yahoo Images for `q` in a real browser and returns the image results as JSON, in the
+    # same shape as `/images/google-search`. Every result carries `imageUrl` (the origin image,
+    # not a thumbnail), `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`,
+    # `width`, `height` and `yahooImagesUrl` (Yahoo's image viewer link). `pages` fetches up to
+    # 10 result pages of ~60 each; every page fetched is billed as one request.
+    #
+    # @param q [String] Image search term, e.g. 'eiffel tower'.
+    # @param pages [Integer] How many Yahoo Images result pages to fetch (1-10, ~60 results
+    # each). Each page fetched is billed as one request. API default: 1.
+    # @param max_results [Integer] Optional cap on the number of results returned (default: all
+    # results of the fetched pages).
+    # @param proxy_country [String] Country to search from (ISO-2); picks Yahoo's regional site.
+    # Defaults to US.
+    # Calls POST /images/yahoo-search.
+    def yahoo_images(q, pages: nil, max_results: nil, proxy_country: nil)
+      post_json("/images/yahoo-search", {
+        q: q,
+        pages: pages,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Search Brave.
+    #
+    # Searches Brave Search for `keyword` in a real browser and returns the results as JSON:
+    # `topAds`, `bottomAds`, `organic` (each with `position`, `title`, `url`, `displayedUrl`,
+    # `domain`, `description`) and `relatedSearches`. Same parameters and response shape as
+    # `/serpApi`; ~20 organic results per page. Brave picks the result region from the
+    # searcher's location, so `proxy_country` sets it through the proxy's location.
+    #
+    # @param keyword [String] Search terms.
+    # @param pages_to_check [Integer] How many result pages to collect (1-10, ~10 results each).
+    # API default: 1.
+    # @param proxy_country [String] Country to search from (ISO-2). Sets the result market and
+    # the location the search is sent from, which decides the ads. Defaults to US.
+    # @param language [String] Interface language (ISO-639-1, e.g. en, de). Defaults to en.
+    # Calls POST /search/brave.
+    def brave_search(keyword, pages_to_check: nil, proxy_country: nil, language: nil)
+      post_json("/search/brave", {
+        keyword: keyword,
+        pages_to_check: pages_to_check,
+        proxy_country: proxy_country,
+        language: language,
+      })
+    end
+
+    # Search Brave Images.
+    #
+    # Runs Brave Images for `q` in a real browser and returns the image results as JSON, in the
+    # same shape as `/images/google-search`. Every result carries `imageUrl` (the origin image,
+    # not a thumbnail), `sourceDomain`, `sourcePageUrl`, `title`, `sourceName`, `thumbnailUrl`,
+    # `width` and `height`. Brave returns its whole result set (~200 images) on one page, billed
+    # as one request; `max_results` caps it.
+    #
+    # @param q [String] Image search term, e.g. 'eiffel tower'.
+    # @param max_results [Integer] Optional cap on the number of results returned (default: all,
+    # ~200).
+    # @param proxy_country [String] Country to search from (ISO-2); Brave takes the region from
+    # it. Defaults to US.
+    # Calls POST /images/brave-search.
+    def brave_images(q, max_results: nil, proxy_country: nil)
+      post_json("/images/brave-search", {
+        q: q,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Zillow real-estate listings.
+    #
+    # Searches Zillow for `location` (a city/state or ZIP) and returns the listings as JSON:
+    # `price`, `beds`, `baths`, `area`, `address`, `homeType`, `zestimate`, `rentZestimate`,
+    # `daysOnZillow`, coordinates, broker and a clean `url`. Filter with `status` (for_sale /
+    # for_rent / sold), `min_price`/`max_price`, `beds`, `baths` and `home_type`, sort with
+    # `sort`, and collect up to `max_results` across pages. Rental results can include apartment
+    # buildings (`isBuilding: true`): they have no `zpid` and carry `lotId`, `buildingName`, a
+    # rent range (`price` to `maxPrice`), `units` and `availableUnits` instead.
+    #
+    # @param location [String] City/state or ZIP to search, e.g. 'Austin, TX' or '78704'.
+    # @param status [String] Listing status: for_sale, for_rent, sold. API default: for_sale.
+    # @param max_results [Integer] How many listings to collect across pages (~41 per page). API
+    # default: 41.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param sort [String] Ordering: newest, price_asc, price_desc, relevant, beds, sqft, lot.
+    # API default: newest.
+    # @param home_type [String] Property type filter: houses, condos, townhomes, multi_family,
+    # apartments, manufactured, lots_land. Omit for all.
+    # @param min_price [Integer] Minimum price (or monthly rent).
+    # @param max_price [Integer] Maximum price (or monthly rent).
+    # @param beds [Integer] Minimum bedrooms.
+    # @param baths [Integer] Minimum bathrooms.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /realestate/zillow.
+    def zillow_search(location, status: nil, max_results: nil, page: nil, sort: nil, home_type: nil, min_price: nil, max_price: nil, beds: nil, baths: nil, proxy_country: nil)
+      post_json("/realestate/zillow", {
+        location: location,
+        status: status,
+        max_results: max_results,
+        page: page,
+        sort: sort,
+        home_type: home_type,
+        min_price: min_price,
+        max_price: max_price,
+        beds: beds,
+        baths: baths,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a single Zillow property's full detail.
+    #
+    # Fetches one Zillow property (by `url` or `zpid`) and returns the full record as JSON:
+    # `price`, `zestimate`, `rentZestimate`, `beds`, `baths`, `area`, `lotSize`, `yearBuilt`,
+    # `homeType`, `status`, `description`, `priceHistory`, `taxHistory`, `schools`, `facts`,
+    # `parking`, listing `brokerName`/`listingAgent`, `mlsid`, `monthlyHoaFee`, `pricePerSqft`,
+    # `daysOnZillow`, `taxAssessedValue`, coordinates, the `photos` gallery and
+    # `virtualTourUrl`. Every field is always present and is `null` when Zillow does not show it
+    # for that listing (for-sale and sold pages carry fewer sections than rentals). Companion to
+    # the Zillow search plugin (`/realestate/zillow`).
+    #
+    # @param url [String] Zillow property URL, e.g.
+    # 'https://www.zillow.com/homedetails/.../29432984_zpid/'. Either url or zpid is required.
+    # @param zpid [String] Zillow property id (zpid), e.g. '29432984'. Alternative to url.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /realestate/zillow-detail.
+    def zillow_detail(url: nil, zpid: nil, proxy_country: nil)
+      post_json("/realestate/zillow-detail", {
+        url: url,
+        zpid: zpid,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Redfin real-estate listings.
+    #
+    # Searches Redfin for `location` (a city/state or ZIP) and returns the listings as JSON:
+    # `price`, `beds`, `baths`, `sqFt`, `lotSize`, address, coordinates, `propertyType`,
+    # `mlsStatus`, `mlsId`, `daysOnMarket`, `pricePerSqFt` and a clean `url`. Filter with
+    # `status` (for_sale / sold), `min_price`/`max_price`, `beds`, `baths` and `property_type`,
+    # sort with `sort`, and collect up to `max_results` across pages. Use `mode=detail` with a
+    # listing `url` for one home in full (agents, public records, tax, price history, Redfin
+    # Estimate).
+    #
+    # @param location [String] City/state or ZIP to search, e.g. 'Austin, TX' or '78704'. Search
+    # mode.
+    # @param status [String] Listing status: for_sale, sold. API default: for_sale.
+    # @param max_results [Integer] How many listings to collect across pages (~350 per page).
+    # API default: 350.
+    # @param sort [String] Ordering: recommended, newest, price_asc, price_desc, sqft,
+    # price_per_sqft. API default: recommended.
+    # @param property_type [String] Property type filter: houses, condos, townhomes,
+    # multi_family, land, manufactured, other. Omit for all.
+    # @param min_price [Integer] Minimum price.
+    # @param max_price [Integer] Maximum price.
+    # @param beds [Integer] Minimum bedrooms.
+    # @param baths [Integer] Minimum bathrooms.
+    # @param sold_within_days [Integer] For status=sold: look back this many days (default 90).
+    # API default: 90.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /realestate/redfin.
+    def redfin_search(location, status: nil, max_results: nil, sort: nil, property_type: nil, min_price: nil, max_price: nil, beds: nil, baths: nil, sold_within_days: nil, proxy_country: nil)
+      post_json("/realestate/redfin", {
+        mode: "search",
+        location: location,
+        status: status,
+        max_results: max_results,
+        sort: sort,
+        property_type: property_type,
+        min_price: min_price,
+        max_price: max_price,
+        beds: beds,
+        baths: baths,
+        sold_within_days: sold_within_days,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Redfin real-estate listings.
+    #
+    # Searches Redfin for `location` (a city/state or ZIP) and returns the listings as JSON:
+    # `price`, `beds`, `baths`, `sqFt`, `lotSize`, address, coordinates, `propertyType`,
+    # `mlsStatus`, `mlsId`, `daysOnMarket`, `pricePerSqFt` and a clean `url`. Filter with
+    # `status` (for_sale / sold), `min_price`/`max_price`, `beds`, `baths` and `property_type`,
+    # sort with `sort`, and collect up to `max_results` across pages. Use `mode=detail` with a
+    # listing `url` for one home in full (agents, public records, tax, price history, Redfin
+    # Estimate).
+    #
+    # @param url [String] Redfin URL. Required for detail mode (a listing URL); optional in
+    # search mode (a city/zip page URL).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /realestate/redfin.
+    def redfin_detail(url, proxy_country: nil)
+      post_json("/realestate/redfin", {
+        mode: "detail",
+        url: url,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Rightmove property listings.
+    #
+    # Searches Rightmove (the UK's largest property portal) for `location` and returns the
+    # listings as JSON: `address`, `price` (`amount` + `currency` + `display` + `frequency`),
+    # `transactionType`, `bedrooms`, `bathrooms`, `propertyType`, `summary`, `coordinates`,
+    # `images`, `agent` (name / branch / phone) and listing dates. Filter with `channel` (buy /
+    # rent), `min_price`/`max_price`, `min_bedrooms`/`max_bedrooms` and `property_type`, sort
+    # with `sort`, and collect up to `max_results` across pages.
+    #
+    # @param location [String] UK place name, e.g. 'London', 'Manchester', 'Milton Keynes'.
+    # @param channel [String] buy (for sale) or rent (to rent). API default: buy.
+    # @param min_price [Integer] Minimum price (GBP).
+    # @param max_price [Integer] Maximum price (GBP).
+    # @param min_bedrooms [Integer] Minimum bedrooms.
+    # @param max_bedrooms [Integer] Maximum bedrooms.
+    # @param property_type [String] Rightmove property types, comma-separated, e.g.
+    # 'flat,detached'.
+    # @param sort [String] Ordering: relevance, newest, price_asc, price_desc, oldest. API
+    # default: relevance.
+    # @param max_results [Integer] How many listings to collect across pages (~24 per page, max
+    # 1008). API default: 48.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /realestate/rightmove.
+    def rightmove_search(location, channel: nil, min_price: nil, max_price: nil, min_bedrooms: nil, max_bedrooms: nil, property_type: nil, sort: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/realestate/rightmove", {
+        location: location,
+        channel: channel,
+        min_price: min_price,
+        max_price: max_price,
+        min_bedrooms: min_bedrooms,
+        max_bedrooms: max_bedrooms,
+        property_type: property_type,
+        sort: sort,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape idealista property listings (Spain, Italy, Portugal).
+    #
+    # Searches idealista (idealista.com, idealista.it, idealista.pt) for `location` - or takes
+    # any idealista search `url` - and returns the listings as JSON: `id`, `url`, `title`,
+    # `price` + `currency` (+ `pricePeriod` for rentals), `originalPrice` and `priceDropPercent`
+    # after a price cut, `pricePerM2`, `area`, `rooms`, `floor`, `lift`, `exterior`, `parking`,
+    # `description`, `tags`, `images`, `imageCount`, `multimedia` (plan, video, 3D tour),
+    # `agency` and `professional`. Filter by `operation` (sale / rent), `property_type`, price
+    # and size ranges, `rooms`, `bathrooms` and `features`, order with `sort`, and collect up to
+    # `max_results` across pages (30 per page; idealista shows at most 60 pages per search). A
+    # search with no match answers 200 with an empty `listings`. Billed one unit per page
+    # fetched (`pagesFetched`).
+    #
+    # @param location [String] Location as idealista writes it in its URLs: a municipality
+    # ('madrid-madrid', 'barcelona-barcelona', 'milano-milano', 'lisboa'), a district
+    # ('madrid/centro', 'lisboa/arroios') or a province ('malaga-provincia'). Required unless
+    # url is given.
+    # @param url [String] Any idealista search URL (idealista.com, idealista.it or idealista.pt)
+    # with its filters, e.g. https://www.idealista.com/alquiler-viviendas/barcelona-
+    # barcelona/con-precio-hasta_2000,de-dos-dormitorios/. Overrides location and the filter
+    # parameters.
+    # @param country [String] es, it, pt (idealista.com / .it / .pt). API default: es.
+    # @param operation [String] sale or rent. API default: sale.
+    # @param property_type [String] One of: homes, new_homes, offices, premises, garages, lands,
+    # storage, buildings, rooms. API default: homes.
+    # @param min_price [Integer] Minimum price in EUR (monthly rent with operation=rent).
+    # @param max_price [Integer] Maximum price in EUR.
+    # @param min_size [Integer] Minimum area in m².
+    # @param max_size [Integer] Maximum area in m².
+    # @param rooms [String] Comma-separated room counts: bedrooms in Spain (0 = studio ... 4 =
+    # four or more) and Portugal (T0 ... T4+), total rooms in Italy (1 ... 5 = five or more).
+    # E.g. '2,3'.
+    # @param bathrooms [String] Comma-separated 1, 2, 3 (3 = three or more).
+    # @param features [String] Comma-separated: lift, terrace, balcony, garage, pool, garden,
+    # air_conditioning, storage_room, fitted_wardrobes, accessible, luxury, new_construction,
+    # good_condition, to_renovate.
+    # @param sort [String] One of: relevance, price_asc, price_desc, newest, oldest, size_asc,
+    # size_desc, price_per_m2_asc, price_per_m2_desc, biggest_drop. API default: relevance.
+    # @param page [Integer] 1-based results page to start from (30 listings per page, at most
+    # 60). Use the `nextPage` of a previous response to continue.
+    # @param max_results [Integer] How many listings to collect across pages (1-300); each page
+    # fetched is one billed unit. API default: 30.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2). Leave blank
+    # for the exit chosen for the site.
+    # Calls POST /realestate/idealista.
+    def idealista_search(location, url: nil, country: nil, operation: nil, property_type: nil, min_price: nil, max_price: nil, min_size: nil, max_size: nil, rooms: nil, bathrooms: nil, features: nil, sort: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/realestate/idealista", {
+        location: location,
+        url: url,
+        country: country,
+        operation: operation,
+        property_type: property_type,
+        min_price: min_price,
+        max_price: max_price,
+        min_size: min_size,
+        max_size: max_size,
+        rooms: rooms,
+        bathrooms: bathrooms,
+        features: features,
+        sort: sort,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape one idealista listing (Spain, Italy, Portugal).
+    #
+    # Given an idealista `listing` id (with `country`) or URL, returns the listing as JSON:
+    # `title`, `locationLine`, `operation`, `propertyType`, `price` + `currency` (+
+    # `pricePeriod`), `originalPrice`/`priceDropPercent`, `pricePerM2`, `priceDetails` (the
+    # price breakdown idealista shows, e.g. community fees or deposit), `area`, `usableArea`,
+    # `rooms`, `bathrooms`, `floor`, `lift`, `builtYear`, `energyRating`, `features` (every
+    # feature group idealista lists), `description`, `address`, `coordinates`
+    # (`locationApproximate` when the advertiser hid the exact spot), `images`, `floorPlans`,
+    # `multimediaCounts`, `advertiser` (name, type, reference, agency page) and `updated`. A
+    # listing its advertiser removed answers 404. Billed one unit.
+    #
+    # @param listing [String] idealista listing id ('111278716') or URL, e.g.
+    # https://www.idealista.com/inmueble/111278716/, https://www.idealista.it/immobile/37068709/
+    # or https://www.idealista.pt/imovel/34868387/.
+    # @param country [String] Country of a bare listing id: es, it, pt. Ignored for a URL. API
+    # default: es.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2). Leave blank
+    # for the exit chosen for the site.
+    # Calls POST /realestate/idealista-detail.
+    def idealista_detail(listing, country: nil, proxy_country: nil)
+      post_json("/realestate/idealista-detail", {
+        listing: listing,
+        country: country,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape ImmobilienScout24 property listings.
+    #
+    # Searches ImmobilienScout24 (Germany's largest property portal) for `location` and returns
+    # the listings as JSON: `title`, `price` + `currency` + `priceType` (`rent_cold` /
+    # `rent_warm` / `purchase`), `warmRent`, `livingArea`, `rooms`, `plotArea`, `address`,
+    # `district`, `coordinates`, `image`/`images`, `realtor` and a listing `url`. Filter with
+    # `channel` (rent / buy), `property_type` (apartment / house), `min_price`/`max_price`,
+    # `min_rooms`/`max_rooms` and `min_area`/`max_area`, and collect up to `max_results` across
+    # pages.
+    #
+    # @param location [String] German city ('Berlin', 'Muenchen', 'Köln', 'Frankfurt am Main'),
+    # a state ('Bayern'), or an ImmoScout24 region path such as 'berlin/berlin/mitte' or
+    # 'bayern/muenchen-kreis/unterschleissheim'.
+    # @param channel [String] rent or buy. API default: rent.
+    # @param property_type [String] apartment or house. API default: apartment.
+    # @param min_price [Float] Minimum price in EUR (cold rent per month, or purchase price).
+    # @param max_price [Float] Maximum price in EUR (cold rent per month, or purchase price).
+    # @param min_rooms [Float] Minimum number of rooms (half rooms allowed, e.g. 2.5).
+    # @param max_rooms [Float] Maximum number of rooms.
+    # @param min_area [Float] Minimum living area in m².
+    # @param max_area [Float] Maximum living area in m².
+    # @param max_results [Integer] How many listings to collect across pages (20 per page, max
+    # 500). API default: 20.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /realestate/immobilienscout24.
+    def immobilienscout24_search(location, channel: nil, property_type: nil, min_price: nil, max_price: nil, min_rooms: nil, max_rooms: nil, min_area: nil, max_area: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/realestate/immobilienscout24", {
+        location: location,
+        channel: channel,
+        property_type: property_type,
+        min_price: min_price,
+        max_price: max_price,
+        min_rooms: min_rooms,
+        max_rooms: max_rooms,
+        min_area: min_area,
+        max_area: max_area,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape mobile.de car listings.
+    #
+    # Searches mobile.de (Germany's largest car marketplace) and returns the result-list cards
+    # as JSON: `title`, `makeModel`, `price` (numeric EUR) plus `priceFormatted`,
+    # `firstRegistration`, `mileage`, `power` (`kw` + `ps`), `fuel`, and the detail `id` +
+    # `url`. Pass a friendly `make` name (or a raw `make_id`), and filter with
+    # `price_min`/`price_max`, `year_min`, `mileage_max` and `fuel`; collect up to `max_results`
+    # across pages. `model` is accepted as free text but is not used to filter (mobile.de needs
+    # a numeric model id we do not resolve).
+    #
+    # @param make [String] Make name, e.g. 'bmw', 'volkswagen', 'audi'. Required unless
+    # `make_id` is given.
+    # @param make_id [Integer] Raw mobile.de numeric make id, overrides `make` (e.g. 3500 =
+    # BMW).
+    # @param model [String] Model name (free text). Model-id resolution is not available, so it
+    # is used only as a note; results are not filtered by model.
+    # @param price_min [Integer] Minimum price in EUR.
+    # @param price_max [Integer] Maximum price in EUR.
+    # @param year_min [Integer] Earliest first-registration year (YYYY).
+    # @param mileage_max [Integer] Maximum mileage in km.
+    # @param fuel [String] Fuel: petrol, diesel, electric, hybrid (or a raw mobile.de code).
+    # @param max_results [Integer] How many listings to collect across pages (~20 per page). API
+    # default: 20.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /vehicles/mobile-de.
+    def mobile_de(make = nil, make_id: nil, model: nil, price_min: nil, price_max: nil, year_min: nil, mileage_max: nil, fuel: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/vehicles/mobile-de", {
+        make: make,
+        make_id: make_id,
+        model: model,
+        price_min: price_min,
+        price_max: price_max,
+        year_min: year_min,
+        mileage_max: mileage_max,
+        fuel: fuel,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape AutoScout24 car listings.
+    #
+    # Searches AutoScout24 (Europe's largest car marketplace) and returns the listings as JSON:
+    # `title`, `make`, `model`, `condition` (used / new), `price` (`raw` + `formatted` +
+    # `label`), `mileageKm`, `firstRegistration`, `fuel`, `transmission`, `powerKw`/`powerHp`,
+    # `engineCc`, `location` (country / zip / city / street), `seller` (type, name, phones) and
+    # `images`. Filter with `fuel`, `transmission`, `price_from`/`price_to`,
+    # `year_from`/`year_to`, `mileage_to`, `power_from`/`power_to` (`power_unit`) and `country`,
+    # sort with `sort`, and collect up to `max_results` across pages.
+    #
+    # @param make [String] Make slug, e.g. 'bmw', 'volkswagen', 'audi'.
+    # @param model [String] Model slug, e.g. 'x5', 'golf'. Requires `make`.
+    # @param fuel [String] Fuel: gasoline, diesel, electric, hybrid, lpg, cng (or a raw
+    # AutoScout24 code).
+    # @param transmission [String] Transmission: automatic, manual, semi-automatic.
+    # @param price_from [Integer] Minimum price in EUR.
+    # @param price_to [Integer] Maximum price in EUR.
+    # @param year_from [Integer] Earliest first-registration year.
+    # @param year_to [Integer] Latest first-registration year.
+    # @param mileage_to [Integer] Maximum mileage in km.
+    # @param power_from [Integer] Minimum power (unit set by `power_unit`).
+    # @param power_to [Integer] Maximum power (unit set by `power_unit`).
+    # @param power_unit [String] Power unit for the power filters: 'kw' or 'hp'. API default:
+    # kw.
+    # @param country [String] Seller country (ISO-2), e.g. 'DE', 'IT', 'NL'.
+    # @param sort [String] Ordering: relevance, price_asc, price_desc, newest, mileage_asc,
+    # year_desc, power_desc. API default: relevance.
+    # @param max_results [Integer] How many listings to collect across pages (~20 per page, max
+    # 400). API default: 40.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /vehicles/autoscout24.
+    def autoscout24_search(make: nil, model: nil, fuel: nil, transmission: nil, price_from: nil, price_to: nil, year_from: nil, year_to: nil, mileage_to: nil, power_from: nil, power_to: nil, power_unit: nil, country: nil, sort: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/vehicles/autoscout24", {
+        make: make,
+        model: model,
+        fuel: fuel,
+        transmission: transmission,
+        price_from: price_from,
+        price_to: price_to,
+        year_from: year_from,
+        year_to: year_to,
+        mileage_to: mileage_to,
+        power_from: power_from,
+        power_to: power_to,
+        power_unit: power_unit,
+        country: country,
+        sort: sort,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Indeed job listings.
+    #
+    # Searches Indeed for `query` in `location` and returns the job listings as JSON: `title`,
+    # `company`, `location`, `salary` (with parsed `min`/`max`), `jobTypes`, `companyRating`, a
+    # `snippet`, `datePosted` (YYYY-MM-DD), `sponsored` (Indeed's paid placement) and a clean
+    # job `url`. Filter with `country`, `job_type`, `days` (posting age), `remote`, sort with
+    # `sort` (`date` returns the collected jobs newest first, sponsored ones included), and
+    # collect up to `max_results` across pages. Indeed sits behind Cloudflare + PerimeterX -
+    # handled for you.
+    #
+    # @param query [String] What to search, e.g. 'software engineer' or 'nurse'.
+    # @param country [String] Indeed country site: us, uk, ca, au, in, ie, de, fr, nl, es, it,
+    # at, ch, be, pl, se, sg, za, nz, mx. API default: us.
+    # @param location [String] Where, e.g. 'Austin, TX' or 'London'.
+    # @param radius [Integer] Search radius in miles/km around the location.
+    # @param job_type [String] Job type: fulltime, parttime, contract, internship, temporary.
+    # @param days [Integer] Max posting age in days: 1, 3, 7, 14.
+    # @param remote [Boolean] Only remote jobs. API default: false.
+    # @param sort [String] Ordering: relevance, date. API default: relevance.
+    # @param max_results [Integer] How many jobs to collect across pages. API default: 30.
+    # @param start [Integer] 0-based result offset to start from. API default: 0.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to the country's site.
+    # Calls POST /jobs/indeed.
+    def indeed_jobs(query, country: nil, location: nil, radius: nil, job_type: nil, days: nil, remote: nil, sort: nil, max_results: nil, start: nil, proxy_country: nil)
+      post_json("/jobs/indeed", {
+        query: query,
+        country: country,
+        location: location,
+        radius: radius,
+        job_type: job_type,
+        days: days,
+        remote: remote,
+        sort: sort,
+        max_results: max_results,
+        start: start,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Glassdoor job listings.
+    #
+    # Searches Glassdoor for `keyword` and returns the job listings as JSON: `title`, `jobId`,
+    # `url`, `company` (+ `companyId`, `companyRating`, `companyLogo`), `location`, `ageInDays`,
+    # `salary` (p10/median/p90, payPeriod, currency, source), `snippet`, `skills`, `easyApply`
+    # and `sponsored`. Filter with `location`, `from_age`, `job_type`, `min_salary`,
+    # `experience` and `remote`, sort with `sort` (recency / relevance), and collect up to
+    # `max_results` across pages.
+    #
+    # @param keyword [String] Job title / keywords to search, e.g. 'software engineer'.
+    # @param location [String] Location name to filter by, e.g. 'New York, NY'. Resolved to
+    # Glassdoor's location id automatically; pass loc_id to skip resolution. A name Glassdoor
+    # does not know is a 400.
+    # @param loc_id [Integer] Glassdoor numeric location id (overrides `location` resolution).
+    # @param loc_type [String] Location type for loc_id: C=city, S=state, N=nation, M=metro.
+    # @param sort [String] Ordering: recency, relevance. API default: recency.
+    # @param job_type [String] Employment type: fulltime, parttime, contract, internship,
+    # temporary, apprenticeship. Omit for any.
+    # @param experience [String] Experience level: internship, entrylevel, midseniorlevel,
+    # director, executive. Omit for any.
+    # @param from_age [Integer] Posted within N days (1, 3, 7, 14 or 30).
+    # @param min_salary [Integer] Minimum annual salary.
+    # @param remote [Boolean] Remote jobs only. API default: false.
+    # @param radius [Integer] Search radius in miles around the location.
+    # @param max_results [Integer] How many jobs to collect across pages (~30 per page). API
+    # default: 30.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /jobs/glassdoor.
+    def glassdoor_jobs(keyword, location: nil, loc_id: nil, loc_type: nil, sort: nil, job_type: nil, experience: nil, from_age: nil, min_salary: nil, remote: nil, radius: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/jobs/glassdoor", {
+        keyword: keyword,
+        location: location,
+        loc_id: loc_id,
+        loc_type: loc_type,
+        sort: sort,
+        job_type: job_type,
+        experience: experience,
+        from_age: from_age,
+        min_salary: min_salary,
+        remote: remote,
+        radius: radius,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Glassdoor company reviews.
+    #
+    # Returns a company's Glassdoor employee reviews as JSON. Each review has `id`, `url`,
+    # `title`, `rating` (1-5), `subratings` (work/life balance, culture and values, diversity
+    # and inclusion, career opportunities, compensation and benefits, senior management),
+    # `recommendToFriend`, `ceoApproval`, `businessOutlook`, `pros`, `cons`, `advice`,
+    # `jobTitle`, `employmentStatus`, `isCurrentEmployee`, `yearsOfEmployment`, `location`,
+    # `date`, `helpfulCount`, `notHelpfulCount`, `featured`, `employerResponse` and `view` (the
+    # sort / filter view it came from). The response also carries `summary` (overall rating,
+    # review counts, recommend / CEO approval / business outlook percentages, the CEO, sub-
+    # rating averages, star distribution, reviews in the last 7 and 30 days), `companyMeta`
+    # (name, logo, website, industry, sector, headquarters, size) and `totalReviews`. The counts
+    # are Glassdoor's own and measure different sets: `totalReviews` is the number of reviews
+    # matching every filter of the call (`rating`, `job_title`, `keyword`, `topic`,
+    # `employment_status`, `language`, `current_only`; the default view is English reviews by
+    # full-time and part-time employees), the set the views read from. `summary.allReviewsCount`
+    # is every review Glassdoor holds for the employer, rated or not, in any language and
+    # employment status; no filter changes it. `summary.reviewCount` is the number of ratings
+    # behind `summary.overallRating`, and `summary.ratedReviewsCount` the number of reviews that
+    # carry a star rating; Glassdoor counts the two separately, so they can differ by a few.
+    # Both follow `rating` but not the language or employment filters, so they are usually above
+    # `totalReviews`. `summary.ratingDistribution` holds the star counts Glassdoor sends for its
+    # rating bars (`overall`, each sub-rating, and `recommendToFriend`); for employers with many
+    # reviews they cover only part of them (Google: 18,643 overall against a `reviewCount` of
+    # 52,845), so read them as proportions, not totals, and with `rating` set only that star is
+    # counted. `summary.reviewsLast7Days` and `reviewsLast30Days` count reviews matching the
+    # filters. Give `company` as a Glassdoor employer id, a Glassdoor company URL or a company
+    # name. Only US proxies are used (`proxy_country` accepts US or blank): Glassdoor redirects
+    # other countries to their local site, where these pages do not exist. Glassdoor shows
+    # anonymous visitors only the first page (3 reviews) of each sort / filter view and
+    # redirects deeper pages to sign-in, so there is no page parameter: use `sort`, `rating` and
+    # the filters to reach other reviews, or raise `max_results` to read several views in one
+    # call. `hasMore` is always false and `nextPage` null; `publicLimitReached` is true when
+    # fewer reviews came back than asked because the views anonymous visitors may read ran out.
+    # Every field is always present and is `null` when Glassdoor does not show it. Billed per
+    # review view fetched (`pagesFetched`).
+    #
+    # @param company [String] The company: a Glassdoor employer id (e.g. '9079'), any Glassdoor
+    # company URL (e.g. 'https://www.glassdoor.com/Reviews/Google-Reviews-E9079.htm'), or a
+    # company name (e.g. 'Bank of America', matched with Glassdoor's company search).
+    # @param sort [String] Review order: recent, helpful, highest, lowest. API default: recent.
+    # @param rating [Integer] Only reviews with this overall star rating (1-5).
+    # @param job_title [String] Only reviews from job titles matching this text, e.g. 'software
+    # engineer' (Glassdoor's own job-title search).
+    # @param keyword [String] Only reviews mentioning this keyword, e.g. 'remote'.
+    # @param topic [String] Only reviews about one topic: compensation, culture,
+    # career_development, management, work_life_balance, diversity_and_inclusion.
+    # @param employment_status [String] Comma list of full_time, part_time, contract, intern,
+    # freelance. Defaults to Glassdoor's own view: full_time,part_time.
+    # @param language [String] Comma list of review languages (ISO 639-3): eng, fra, deu, nld,
+    # por, spa, ita. Defaults to eng.
+    # @param current_only [Boolean] Only reviews by current employees. API default: false.
+    # @param max_results [Integer] How many reviews to return. Glassdoor shows anonymous
+    # visitors 3 reviews per view; above that the call also reads the other sort orders and each
+    # star rating, and merges the distinct reviews. API default: 3.
+    # @param proxy_country [String] Proxy country the request is sent from. Only US (or blank,
+    # the default) is accepted: Glassdoor redirects visitors from other countries to their local
+    # site, where the English reviews pages do not exist.
+    # Calls POST /reviews/glassdoor.
+    def glassdoor_reviews(company, sort: nil, rating: nil, job_title: nil, keyword: nil, topic: nil, employment_status: nil, language: nil, current_only: nil, max_results: nil, proxy_country: nil)
+      post_json("/reviews/glassdoor", {
+        company: company,
+        sort: sort,
+        rating: rating,
+        job_title: job_title,
+        keyword: keyword,
+        topic: topic,
+        employment_status: employment_status,
+        language: language,
+        current_only: current_only,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Glassdoor company salaries.
+    #
+    # Returns a company's Glassdoor salary estimates by job title as JSON. Each row has
+    # `jobTitle`, `jobTitleId`, `basePay` and `totalPay` percentiles (`P10`, `P25`, `P50`,
+    # `P75`, `P90`), `currency`, `salaryCount` (salaries behind the estimate) and `mostRecent`
+    # (latest report). The response also carries `companyMeta` (name, rating, logo, website,
+    # industry, sector, headquarters, size, total salary count), `jobTitleCount` and `numPages`.
+    # Give `company` as a Glassdoor employer id, a Glassdoor company URL or a company name;
+    # narrow with `job_title` (Glassdoor's own job-title search) and collect up to `max_results`
+    # rows across pages, most-reported job titles first. Every field is always present and is
+    # `null` when Glassdoor does not show it. Billed per salary page fetched (10 rows per page).
+    #
+    # @param company [String] The company: a Glassdoor employer id (e.g. '9079'), any Glassdoor
+    # company URL (e.g. 'https://www.glassdoor.com/Overview/Working-at-Google-
+    # EI_IE9079.11,17.htm'), or a company name (e.g. 'Bank of America', matched with Glassdoor's
+    # company search).
+    # @param job_title [String] Narrow to job titles matching this text, using Glassdoor's own
+    # job-title search, e.g. 'software engineer'.
+    # @param max_results [Integer] How many job-title rows to return (10 per Glassdoor page,
+    # most-reported titles first). API default: 20.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US, so pay is reported for the US market in USD.
+    # Calls POST /salaries/glassdoor.
+    def glassdoor_salaries(company, job_title: nil, max_results: nil, proxy_country: nil)
+      post_json("/salaries/glassdoor", {
+        company: company,
+        job_title: job_title,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Naukri job listings.
+    #
+    # Searches Naukri (India's largest job board) for `keyword` in `location` and returns the
+    # job listings as JSON: `title`, `company`, `location` (with `workMode` hybrid / remote /
+    # on-site), `experience` (with parsed `experienceMinYears`/`experienceMaxYears`), `salary`
+    # (with parsed `min`/`max`), `skills`, `companyRating`, `reviewsCount`, a `description`
+    # snippet, `postedDate` and a clean job `url`. Filter with `location`, `experience` (years),
+    # `days` (posting age) and `remote`, sort with `sort`, and collect up to `max_results`
+    # across pages.
+    #
+    # @param keyword [String] What to search, e.g. 'python developer' or 'data analyst'.
+    # @param location [String] City to search in, e.g. 'Bangalore' or 'Mumbai'.
+    # @param experience [Integer] Candidate experience in years (0-30).
+    # @param days [Integer] Max posting age in days: 1, 3, 7, 15, 30.
+    # @param remote [Boolean] Only work-from-home / remote jobs. API default: false.
+    # @param sort [String] Ordering: relevance, date. API default: relevance.
+    # @param max_results [Integer] How many jobs to collect across pages (~20 per page). API
+    # default: 40.
+    # @param page [Integer] 1-based results page to start from. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /jobs/naukri.
+    def naukri_jobs(keyword, location: nil, experience: nil, days: nil, remote: nil, sort: nil, max_results: nil, page: nil, proxy_country: nil)
+      post_json("/jobs/naukri", {
+        keyword: keyword,
+        location: location,
+        experience: experience,
+        days: days,
+        remote: remote,
+        sort: sort,
+        max_results: max_results,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Wellfound startup jobs.
+    #
+    # Searches Wellfound (formerly AngelList Talent) startup jobs by `role`, `location` or
+    # remote `role` (or a Wellfound search `url`) and returns `jobs`: `title`, `url`, the full
+    # `description`, `compensation` with parsed `salary` (`min`, `max`, `currency`) and `equity`
+    # (`min`, `max` in %), `jobType` (`full-time`, `part-time`, `contract`, `internship`),
+    # `locations`, `remote`, `remotePolicy` (`ONSITE`, `REMOTE`, `ONSITE_OR_REMOTE`, `HYBRID`),
+    # `acceptedRemoteLocations`, `yearsExperienceMin`/`Max`, `postedAt` and the hiring `company`
+    # (`name`, `slug`, `url`, `tagline`, `companySize`, `stage`, `badges`). A listing page holds
+    # 20 companies with up to 3 matching jobs each; by default the call returns one page, with
+    # `max_results` it pages through up to that many jobs. Totals: `totalJobs`,
+    # `totalCompanies`, `pageCount`, `nextPage`. `mode=job&job=<url>` returns one job in full:
+    # description (text and HTML), salary with period, the same `jobType` and `remotePolicy`
+    # values (the page's wording in `remotePolicyText`, plus `wfhFlexible`), skills,
+    # `visaSponsorship`, `relocation`, `hiresRemotelyIn`, preferred timezones, hiring contact,
+    # posting date, and the company's size, markets, badges, funding and founders. Billed one
+    # unit per page fetched (`pagesFetched`).
+    #
+    # @param role [String] Role to search, as text or Wellfound slug: 'software engineer',
+    # 'product-manager', 'data-scientist'.
+    # @param location [String] Location, as text or Wellfound slug: 'new york', 'san-francisco',
+    # 'london', 'berlin'.
+    # @param remote [Boolean] Remote jobs only (needs role, no location). API default: false.
+    # @param url [String] A Wellfound search URL instead of role / location / remote:
+    # https://wellfound.com/role/l/software-engineer/san-francisco, /role/r/<role>,
+    # /location/<location>.
+    # @param page [Integer] 1-based listing page to start from (1-500); use `nextPage` of a
+    # previous response to continue. API default: 1.
+    # @param max_results [Integer] How many jobs to collect across pages (1-500). Default: the
+    # whole first page (20 companies with up to 3 jobs each, usually 30-60 jobs). Each page
+    # fetched is one billed unit.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /jobs/wellfound.
+    def wellfound_jobs(role = nil, location: nil, remote: nil, url: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/jobs/wellfound", {
+        mode: "search",
+        role: role,
+        location: location,
+        remote: remote,
+        url: url,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Wellfound startup jobs.
+    #
+    # Searches Wellfound (formerly AngelList Talent) startup jobs by `role`, `location` or
+    # remote `role` (or a Wellfound search `url`) and returns `jobs`: `title`, `url`, the full
+    # `description`, `compensation` with parsed `salary` (`min`, `max`, `currency`) and `equity`
+    # (`min`, `max` in %), `jobType` (`full-time`, `part-time`, `contract`, `internship`),
+    # `locations`, `remote`, `remotePolicy` (`ONSITE`, `REMOTE`, `ONSITE_OR_REMOTE`, `HYBRID`),
+    # `acceptedRemoteLocations`, `yearsExperienceMin`/`Max`, `postedAt` and the hiring `company`
+    # (`name`, `slug`, `url`, `tagline`, `companySize`, `stage`, `badges`). A listing page holds
+    # 20 companies with up to 3 matching jobs each; by default the call returns one page, with
+    # `max_results` it pages through up to that many jobs. Totals: `totalJobs`,
+    # `totalCompanies`, `pageCount`, `nextPage`. `mode=job&job=<url>` returns one job in full:
+    # description (text and HTML), salary with period, the same `jobType` and `remotePolicy`
+    # values (the page's wording in `remotePolicyText`, plus `wfhFlexible`), skills,
+    # `visaSponsorship`, `relocation`, `hiresRemotelyIn`, preferred timezones, hiring contact,
+    # posting date, and the company's size, markets, badges, funding and founders. Billed one
+    # unit per page fetched (`pagesFetched`).
+    #
+    # @param job [String] mode=job: the job URL (https://wellfound.com/jobs/4787364-software-
+    # engineer) or '<id>-<slug>', as returned in `jobs[].url` by mode=search.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /jobs/wellfound.
+    def wellfound_job(job, proxy_country: nil)
+      post_json("/jobs/wellfound", {
+        mode: "job",
+        job: job,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Wellfound startup company profiles.
+    #
+    # Given a Wellfound `company` (slug like `stripe` or a wellfound.com/company/<slug> URL),
+    # returns its profile: `name`, `tagline`, `description`, `website` and social links,
+    # `companySize`, `stage`, `badges`, `markets`, `locations`, `companyTypes`, `hiring`,
+    # `openJobs` with `openJobsByRole`, `totalRaised`, `fundingRounds` (`type`, `date`,
+    # `valuation`), `founders` (name, profile URL, role, bio, location), `teamMembersCount`,
+    # `perks`, `media`, the first open `jobs` (with `jobsTotal`) and `similarCompanies`. Company
+    # profiles sit behind a Cloudflare challenge, so a call can take up to about a minute.
+    # `mode=search` lists Wellfound's startup directory by `location` or `industry` (10
+    # companies per page, paged up to `max_results`) with website, description, markets,
+    # locations and open-job counts. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param company [String] mode=profile: the company slug ('stripe') or URL
+    # (https://wellfound.com/company/stripe).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /companies/wellfound.
+    def wellfound_company(company, proxy_country: nil)
+      post_json("/companies/wellfound", {
+        mode: "profile",
+        company: company,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Wellfound startup company profiles.
+    #
+    # Given a Wellfound `company` (slug like `stripe` or a wellfound.com/company/<slug> URL),
+    # returns its profile: `name`, `tagline`, `description`, `website` and social links,
+    # `companySize`, `stage`, `badges`, `markets`, `locations`, `companyTypes`, `hiring`,
+    # `openJobs` with `openJobsByRole`, `totalRaised`, `fundingRounds` (`type`, `date`,
+    # `valuation`), `founders` (name, profile URL, role, bio, location), `teamMembersCount`,
+    # `perks`, `media`, the first open `jobs` (with `jobsTotal`) and `similarCompanies`. Company
+    # profiles sit behind a Cloudflare challenge, so a call can take up to about a minute.
+    # `mode=search` lists Wellfound's startup directory by `location` or `industry` (10
+    # companies per page, paged up to `max_results`) with website, description, markets,
+    # locations and open-job counts. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param location [String] mode=search: location as text or slug ('new york', 'london').
+    # @param industry [String] mode=search: Wellfound industry slug ('saas', 'fintech-2',
+    # 'artificial-intelligence', 'health-care', 'e-commerce'; see wellfound.com/browse/tech-
+    # industries). Common names such as 'fintech', 'healthcare', 'crypto' or 'edtech' are mapped
+    # to their slug.
+    # @param url [String] mode=search: a Wellfound directory URL
+    # (https://wellfound.com/startups/location/new-york or /startups/industry/<industry>)
+    # instead of location / industry.
+    # @param page [Integer] mode=search: 1-based page to start from (10 companies per page). API
+    # default: 1.
+    # @param max_results [Integer] mode=search: how many companies to collect (1-100); each page
+    # fetched is one billed unit. API default: 10.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /companies/wellfound.
+    def wellfound_company_search(location: nil, industry: nil, url: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/companies/wellfound", {
+        mode: "search",
+        location: location,
+        industry: industry,
+        url: url,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape company career sites (Greenhouse, Lever, Ashby, Workday and more).
+    #
+    # Every open job on a company's career site hosted on Greenhouse, Lever, Ashby, Workday,
+    # SmartRecruiters, Workable or Recruitee, from its career page `url` (or `provider` +
+    # `company`). Each job (`jobs`) has `id`, `title`, `company`, `provider`, `url`, `applyUrl`,
+    # `location` and `locations`, `country`, `remote`, `workplaceType` (remote / hybrid /
+    # onsite), `department`, `team`, `employmentType`, `postedAt`, `updatedAt`, `requisitionId`,
+    # `salary` and `salaryRanges` (min, max, currency, interval) where the ATS publishes pay,
+    # `customFields` (the ATS's extra fields) and, with `include_description=true`,
+    # `descriptionText` and `descriptionHtml`. A field the ATS does not expose is null. Filter
+    # with `keyword` (title words), `location`, `department` and `remote`; `limit` caps the jobs
+    # returned. The answer also carries the detected `provider`, `company`, `companyName`,
+    # `boardUrl`, `totalJobs` on the board and `matchedJobs`. A link to one posting returns just
+    # that posting with its description. Billed one unit per upstream request that returned data
+    # (`pagesFetched`): one for a whole Greenhouse, Ashby, Workable or Recruitee board, one per
+    # Lever (100 jobs), Workday (20 jobs) or SmartRecruiters (100 jobs) listing page, plus one
+    # per Workday / SmartRecruiters posting whose description is read.
+    #
+    # @param url [String] The company's career page on its ATS, e.g. 'https://job-
+    # boards.greenhouse.io/stripe', 'https://jobs.lever.co/palantir',
+    # 'https://jobs.ashbyhq.com/ramp',
+    # 'https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite',
+    # 'https://jobs.smartrecruiters.com/Ubisoft2', 'https://apply.workable.com/huggingface',
+    # 'https://bunq.recruitee.com'. A link to one posting returns just that posting.
+    # @param provider [String] Instead of `url`: the ATS (greenhouse, lever, ashby, workday,
+    # smartrecruiters, workable, recruitee), with `company`.
+    # @param company [String] Instead of `url`: the company's board name on that ATS, as in its
+    # career URL: Greenhouse token ('stripe'), Lever / Ashby / Workable / Recruitee slug,
+    # SmartRecruiters company id ('Ubisoft2'), Workday '<tenant>.wd<N>/<site>'
+    # ('nvidia.wd5/NVIDIAExternalCareerSite').
+    # @param keyword [String] Only jobs whose title contains every word, e.g. 'software
+    # engineer'.
+    # @param location [String] Only jobs in this place (city, region or country as the company
+    # writes it, e.g. 'London', 'Germany', 'Remote'); case-insensitive.
+    # @param department [String] Only jobs in this department or team, e.g. 'Engineering'.
+    # @param remote [Boolean] Only remote jobs. API default: false.
+    # @param limit [Integer] How many jobs to return (1-2000). API default: 100.
+    # @param include_description [Boolean] Add each job's full description (`descriptionText`,
+    # `descriptionHtml`). On Workday and SmartRecruiters this reads every posting separately
+    # (one billed request each, at most 300 per call). API default: false.
+    # @param proxy_country [String] Proxy country the requests are sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /jobs/career-site.
+    def career_site_jobs(url = nil, provider: nil, company: nil, keyword: nil, location: nil, department: nil, remote: nil, limit: nil, include_description: nil, proxy_country: nil)
+      post_json("/jobs/career-site", {
+        url: url,
+        provider: provider,
+        company: company,
+        keyword: keyword,
+        location: location,
+        department: department,
+        remote: remote,
+        limit: limit,
+        include_description: include_description,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Trustpilot company reviews.
+    #
+    # Returns a company's Trustpilot profile and reviews as JSON. `company` is the reviewed
+    # domain (e.g. `www.nike.com`). The response has a `company` summary (`trustScore`,
+    # `totalReviews`, `ratingDistribution` 1-5, `categories`, `contact`) and a `reviews` array -
+    # each with `rating`, `title`, `text`, `verified`, `author` (name, country, review count),
+    # `reply` (the company's response) and dates. Page with `page`/`pages` (20 reviews per
+    # page), and filter with `stars`, `sort` (recency/relevancy), `language`, `date`, `search`,
+    # `verified` or `replies`.
+    #
+    # @param company [String] The reviewed company's domain, e.g. 'www.nike.com' or 'nike.com'.
+    # A full site URL or a pasted Trustpilot review URL is also accepted.
+    # @param page [Integer] 1-based page to start from (20 reviews/page). API default: 1.
+    # @param pages [Integer] How many consecutive pages to fetch from `page` onward (20 reviews
+    # each). Stops early at the last page. API default: 1.
+    # @param stars [Array<Integer>] Only reviews with these star ratings (1, 2, 3, 4, 5).
+    # Repeatable, e.g. stars=4&stars=5.
+    # @param sort [String] Ordering: recency, relevancy. Default 'recency' (newest first). API
+    # default: recency.
+    # @param language [String] Review language ISO-2 code (e.g. 'en', 'de') or 'all'. Default
+    # 'all'. API default: all.
+    # @param date [String] Only reviews from a recent window: last30days, last3months,
+    # last6months, last12months. Omit for all time.
+    # @param search [String] Keyword to search within the company's reviews.
+    # @param verified [Boolean] Only verified reviews (Trustpilot's verified badge). API
+    # default: false.
+    # @param replies [Boolean] Only reviews the company has replied to. API default: false.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to a country chosen for the site.
+    # Calls POST /reviews/trustpilot.
+    def trustpilot_reviews(company, page: nil, pages: nil, stars: nil, sort: nil, language: nil, date: nil, search: nil, verified: nil, replies: nil, proxy_country: nil)
+      post_json("/reviews/trustpilot", {
+        company: company,
+        page: page,
+        pages: pages,
+        stars: stars,
+        sort: sort,
+        language: language,
+        date: date,
+        search: search,
+        verified: verified,
+        replies: replies,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape G2 software reviews.
+    #
+    # Given a G2 `product` (slug like `slack`, or a g2.com product URL), returns the product
+    # summary (`name`, `rating`, `reviewCount`, `starDistribution`, `categories`, `aiSummary`,
+    # `pros`, `cons`, `segments`) and its `reviews`: `title`, `rating`, `date`, `reviewer` (job
+    # title, industry, company size), `likeBest`, `dislike`, `problemsSolved`, the full
+    # `answers`, badges (`validatedReviewer`, `currentUser`, `incentivized`, `source`) and
+    # `vendorResponse`. Pages through G2's review pages up to `max_results` (10 per page, at
+    # most 10 pages per view); pick the view with `sort`, `stars` and `search`. `details=true`
+    # adds the vendor, description, website and languages. `mode=search&query=` searches G2's
+    # product catalog. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param product [String] G2 product slug, e.g. 'slack' or 'hubspot-sales-hub', or a g2.com
+    # product URL such as https://www.g2.com/products/slack/reviews. Required unless
+    # mode=search.
+    # @param page [Integer] 1-based page to start from: 10 reviews per page, at most 10 (G2's
+    # limit per sort/filter view); with mode=search 20 products per page, at most 20. Use the
+    # `nextPage` of a previous response to continue. API default: 1.
+    # @param max_results [Integer] How many reviews to collect across pages (1-100, default 10).
+    # With mode=search, how many products (1-100, default 20) - search answers whole pages of
+    # 20, so it can return a few more. Each page fetched is one billed unit.
+    # @param sort [String] Review order: g2_default, most_recent, most_helpful, highest_rated,
+    # lowest_rated. Default: G2's own ranking. API default: g2_default.
+    # @param stars [Integer] Only reviews with this star rating (1-5).
+    # @param search [String] Only reviews whose answers mention this keyword.
+    # @param details [Boolean] Also fetch the product page for its vendor, description, website
+    # and languages (one more billed unit). API default: false.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /reviews/g2.
+    def g2_reviews(product, page: nil, max_results: nil, sort: nil, stars: nil, search: nil, details: nil, proxy_country: nil)
+      post_json("/reviews/g2", {
+        mode: "reviews",
+        product: product,
+        page: page,
+        max_results: max_results,
+        sort: sort,
+        stars: stars,
+        search: search,
+        details: details,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape G2 software reviews.
+    #
+    # Given a G2 `product` (slug like `slack`, or a g2.com product URL), returns the product
+    # summary (`name`, `rating`, `reviewCount`, `starDistribution`, `categories`, `aiSummary`,
+    # `pros`, `cons`, `segments`) and its `reviews`: `title`, `rating`, `date`, `reviewer` (job
+    # title, industry, company size), `likeBest`, `dislike`, `problemsSolved`, the full
+    # `answers`, badges (`validatedReviewer`, `currentUser`, `incentivized`, `source`) and
+    # `vendorResponse`. Pages through G2's review pages up to `max_results` (10 per page, at
+    # most 10 pages per view); pick the view with `sort`, `stars` and `search`. `details=true`
+    # adds the vendor, description, website and languages. `mode=search&query=` searches G2's
+    # product catalog. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param query [String] Keyword to search G2 products for (mode=search), e.g. 'crm'.
+    # @param page [Integer] 1-based page to start from: 10 reviews per page, at most 10 (G2's
+    # limit per sort/filter view); with mode=search 20 products per page, at most 20. Use the
+    # `nextPage` of a previous response to continue. API default: 1.
+    # @param max_results [Integer] How many reviews to collect across pages (1-100, default 10).
+    # With mode=search, how many products (1-100, default 20) - search answers whole pages of
+    # 20, so it can return a few more. Each page fetched is one billed unit.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /reviews/g2.
+    def g2_search(query, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/reviews/g2", {
+        mode: "search",
+        query: query,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Capterra software reviews.
+    #
+    # Given a Capterra `product` (numeric id like `135003`, `id/slug` like `135003/Slack`, or a
+    # capterra.com/p/<id>/<slug>/ URL), returns the product summary (`name`, `vendor`, `rating`,
+    # `reviewCount`, sub-`ratings` `easeOfUse`, `customerSupport` (Capterra's "Customer Service"
+    # rating), `features` and `valueForMoney`, `categories`, `description`, `pricing`) and its
+    # `reviews`: `title`, `rating`, the same sub-`ratings` with `likelihoodToRecommend` (0-10),
+    # `date`, `reviewer` (job title, industry, company size, time used, validations),
+    # `comments`, `pros`, `cons`, `reasonsForChoosing`, `reasonsForSwitching` with
+    # `alternativesConsidered` / `switchedFrom`, `advice`, the incentive badges (`incentive`,
+    # `incentivized`, `vendorReferred`, `reviewSource`), `source` (Capterra, GetApp or Software
+    # Advice) and `vendorResponse`. Pages through Capterra's review pages up to `max_results`
+    # (25 per page, at most 100 pages, in Capterra's "Most Helpful" order). A product with only
+    # a few reviews has no review pages; its reviews come from its profile in one page. A
+    # product without reviews answers 200 with an empty `reviews` list. `mode=search&query=`
+    # searches Capterra's product catalog (one page of up to 20 products, plus matching
+    # categories). A bare product id costs one extra fetch the first time a page past the first
+    # is asked for (Capterra redirects it to the canonical slug); `id/slug` (echoed in `query`)
+    # avoids it. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param product [String] Capterra product: its numeric id ('135003'), 'id/slug'
+    # ('135003/Slack') or a capterra.com product URL such as
+    # https://www.capterra.com/p/135003/Slack/reviews/. Required unless mode=search.
+    # @param slug [String] Optional product slug ('Slack') to go with a bare id. Capterra finds
+    # the product by id alone; the canonical slug is returned.
+    # @param page [Integer] 1-based review page to start from: 25 reviews per page, at most 100
+    # (Capterra's limit per product). Use the `nextPage` of a previous response to continue. API
+    # default: 1.
+    # @param max_results [Integer] How many reviews to collect across pages (1-500, default 25);
+    # each page fetched is one billed unit. With mode=search, how many products (1-20, default
+    # 20; one page).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /reviews/capterra.
+    def capterra_reviews(product, slug: nil, page: nil, max_results: nil, proxy_country: nil)
+      post_json("/reviews/capterra", {
+        mode: "reviews",
+        product: product,
+        slug: slug,
+        page: page,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Capterra software reviews.
+    #
+    # Given a Capterra `product` (numeric id like `135003`, `id/slug` like `135003/Slack`, or a
+    # capterra.com/p/<id>/<slug>/ URL), returns the product summary (`name`, `vendor`, `rating`,
+    # `reviewCount`, sub-`ratings` `easeOfUse`, `customerSupport` (Capterra's "Customer Service"
+    # rating), `features` and `valueForMoney`, `categories`, `description`, `pricing`) and its
+    # `reviews`: `title`, `rating`, the same sub-`ratings` with `likelihoodToRecommend` (0-10),
+    # `date`, `reviewer` (job title, industry, company size, time used, validations),
+    # `comments`, `pros`, `cons`, `reasonsForChoosing`, `reasonsForSwitching` with
+    # `alternativesConsidered` / `switchedFrom`, `advice`, the incentive badges (`incentive`,
+    # `incentivized`, `vendorReferred`, `reviewSource`), `source` (Capterra, GetApp or Software
+    # Advice) and `vendorResponse`. Pages through Capterra's review pages up to `max_results`
+    # (25 per page, at most 100 pages, in Capterra's "Most Helpful" order). A product with only
+    # a few reviews has no review pages; its reviews come from its profile in one page. A
+    # product without reviews answers 200 with an empty `reviews` list. `mode=search&query=`
+    # searches Capterra's product catalog (one page of up to 20 products, plus matching
+    # categories). A bare product id costs one extra fetch the first time a page past the first
+    # is asked for (Capterra redirects it to the canonical slug); `id/slug` (echoed in `query`)
+    # avoids it. Billed one unit per page fetched (`pagesFetched`).
+    #
+    # @param query [String] Product name or keyword to search for (mode=search), e.g. 'crm'.
+    # @param max_results [Integer] How many reviews to collect across pages (1-500, default 25);
+    # each page fetched is one billed unit. With mode=search, how many products (1-20, default
+    # 20; one page).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the country chosen for the site.
+    # Calls POST /reviews/capterra.
+    def capterra_search(query, max_results: nil, proxy_country: nil)
+      post_json("/reviews/capterra", {
+        mode: "search",
+        query: query,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Product Hunt launches, products, search and topics.
+    #
+    # Turns Product Hunt into JSON. `mode=leaderboard` returns a day's ranked launches
+    # (`date`=YYYY-MM-DD, or today) with votes, comments, topics and rank; `mode=search` returns
+    # products matching `query`; `mode=topic` returns products under a `topic` slug;
+    # `mode=detail` returns one product by `slug` with description, website, socials, review
+    # rating, followers and categories. Set `max_results` for the list modes.
+    #
+    # @param mode [String] What to fetch: leaderboard, search, topic, detail. API default:
+    # leaderboard.
+    # @param query [String] Search terms (mode=search), e.g. 'ai chatbot'.
+    # @param date [String] Leaderboard day as YYYY-MM-DD (mode=leaderboard). Omit for today.
+    # Past days are finalised and ranked; today's board is live and not ranked yet.
+    # @param topic [String] Topic slug (mode=topic), e.g. 'artificial-intelligence'.
+    # @param slug [String] Product slug (mode=detail), e.g. 'notion'.
+    # @param max_results [Integer] Max products to return for list modes
+    # (leaderboard/search/topic). API default: 30.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank - Product Hunt is global and a forced country only hurts.
+    # Calls POST /products/producthunt.
+    def product_hunt(mode: nil, query: nil, date: nil, topic: nil, slug: nil, max_results: nil, proxy_country: nil)
+      post_json("/products/producthunt", {
+        mode: mode,
+        query: query,
+        date: date,
+        topic: topic,
+        slug: slug,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a Crunchbase company profile, or search companies by name.
+    #
+    # With `organization` (a Crunchbase slug like 'stripe' or a crunchbase.com/organization/...
+    # URL) returns the organization as JSON: `name`, `slug`, `uuid`, `url`, `legalName`,
+    # `aliases`, `shortDescription`, `description`, `logo`, `website`, `headquarters` (city,
+    # region, country, continent), `operatingStatus`, `companyType`, `ipoStatus`, `stockSymbol`
+    # + `stockExchange`, `employeeRange`, `industries`, `industryGroups`, `hubTags`, CB `rank`
+    # with `rankDelta90d` (Crunchbase's 90-day trend score for the rank, from -10 to 10:
+    # positive means the company moved up the ranking, toward #1), `growthScore` and `heatScore`
+    # (0-100) with `growthScoreDelta90d` and `heatScoreDelta90d` (their change in points over 90
+    # days), `founders`, `lastFundingType`, counts (`numFundingRounds`, `numInvestors`,
+    # `numAcquisitions`, `numInvestments`, `numEmployeeProfiles` ...), `acquiredBy`, `owner`,
+    # the latest `fundingRounds` (type, investors, lead investors, each with `name`, `slug`,
+    # `url`, `type` and `image` like every other company or person reference), `investors`,
+    # `acquisitions`, `investments`, `exits`, `subOrganizations`, `keyPeople` (title, start
+    # date), `boardMembers`, `similarCompanies`, `products`, `contactEmail`, `phone`,
+    # `socialLinks`, `webTraffic` (`monthlyVisits`, and `monthlyVisitsChange`, the month-over-
+    # month change as a fraction: 0.069 = +6.9%, -0.2 = -20%), `technology`, `predictions`,
+    # `events` (product launches, partnerships, awards, layoffs, key employee changes, legal
+    # proceedings, each with its press source), `offices` and recent `news`. Every one of the
+    # record's 73 keys is always present. Data Crunchbase shows only to paying users (founded /
+    # closed / IPO dates, funding totals, round dates and amounts, acquisition prices, exits,
+    # valuation) is null, and `paywalledFields` names the ones Crunchbase holds for this
+    # organization. With `query` instead, searches organizations by name and returns up to
+    # `max_results` (max 25) matches with `name`, `slug`, `url`, `shortDescription` and `logo`,
+    # plus the total `count` of matches. No Crunchbase login required.
+    #
+    # @param organization [String] Crunchbase organization slug (the part after /organization/
+    # in its profile URL, e.g. 'stripe' or 'tesla-motors') or the full profile URL. Either
+    # organization or query is required.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /companies/crunchbase.
+    def crunchbase_company(organization, proxy_country: nil)
+      post_json("/companies/crunchbase", {
+        organization: organization,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a Crunchbase company profile, or search companies by name.
+    #
+    # With `organization` (a Crunchbase slug like 'stripe' or a crunchbase.com/organization/...
+    # URL) returns the organization as JSON: `name`, `slug`, `uuid`, `url`, `legalName`,
+    # `aliases`, `shortDescription`, `description`, `logo`, `website`, `headquarters` (city,
+    # region, country, continent), `operatingStatus`, `companyType`, `ipoStatus`, `stockSymbol`
+    # + `stockExchange`, `employeeRange`, `industries`, `industryGroups`, `hubTags`, CB `rank`
+    # with `rankDelta90d` (Crunchbase's 90-day trend score for the rank, from -10 to 10:
+    # positive means the company moved up the ranking, toward #1), `growthScore` and `heatScore`
+    # (0-100) with `growthScoreDelta90d` and `heatScoreDelta90d` (their change in points over 90
+    # days), `founders`, `lastFundingType`, counts (`numFundingRounds`, `numInvestors`,
+    # `numAcquisitions`, `numInvestments`, `numEmployeeProfiles` ...), `acquiredBy`, `owner`,
+    # the latest `fundingRounds` (type, investors, lead investors, each with `name`, `slug`,
+    # `url`, `type` and `image` like every other company or person reference), `investors`,
+    # `acquisitions`, `investments`, `exits`, `subOrganizations`, `keyPeople` (title, start
+    # date), `boardMembers`, `similarCompanies`, `products`, `contactEmail`, `phone`,
+    # `socialLinks`, `webTraffic` (`monthlyVisits`, and `monthlyVisitsChange`, the month-over-
+    # month change as a fraction: 0.069 = +6.9%, -0.2 = -20%), `technology`, `predictions`,
+    # `events` (product launches, partnerships, awards, layoffs, key employee changes, legal
+    # proceedings, each with its press source), `offices` and recent `news`. Every one of the
+    # record's 73 keys is always present. Data Crunchbase shows only to paying users (founded /
+    # closed / IPO dates, funding totals, round dates and amounts, acquisition prices, exits,
+    # valuation) is null, and `paywalledFields` names the ones Crunchbase holds for this
+    # organization. With `query` instead, searches organizations by name and returns up to
+    # `max_results` (max 25) matches with `name`, `slug`, `url`, `shortDescription` and `logo`,
+    # plus the total `count` of matches. No Crunchbase login required.
+    #
+    # @param query [String] Company name to search for, e.g. 'Revolut'. Returns the matching
+    # organizations with their slugs instead of one full profile.
+    # @param max_results [Integer] Search matches to return with query (1-25). API default: 10.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /companies/crunchbase.
+    def crunchbase_search(query, max_results: nil, proxy_country: nil)
+      post_json("/companies/crunchbase", {
+        query: query,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Yelp businesses (search + detail).
+    #
+    # Two modes. **Search** (`mode=search`): give `find_desc` (a keyword or category) and
+    # `find_loc` (a city/area) and get the businesses as JSON - `name`, `rating`, `reviewCount`,
+    # `priceRange`, `categories`, `address`, `neighborhoods`, `url`, `businessId`, `image` and
+    # `isAd`. Filter with `sort`, `price` (1-4) and `open_now`, and collect up to `max_results`
+    # across pages. **Detail** (`mode=detail`): give a business `url` and get a rich object -
+    # phone, full address, website, hours, attributes, categories, specialties, review
+    # highlights, photos and popular dishes.
+    #
+    # @param find_desc [String] Search keyword or category, e.g. 'coffee' or 'plumbers'.
+    # @param find_loc [String] Location to search, e.g. 'San Francisco, CA' or '94109'.
+    # @param sort [String] Search ordering: recommended, rating, review_count, distance. API
+    # default: recommended.
+    # @param price [String] Price filter 1-4 ($ to $$$$); combine like '1,2'.
+    # @param open_now [Boolean] Search: only businesses open now. API default: false.
+    # @param max_results [Integer] Search: how many businesses to collect across pages (10 per
+    # page). API default: 30.
+    # @param start [Integer] Search: result offset to start from. API default: 0.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /local/yelp.
+    def yelp_search(find_desc, find_loc, sort: nil, price: nil, open_now: nil, max_results: nil, start: nil, proxy_country: nil)
+      post_json("/local/yelp", {
+        mode: "search",
+        find_desc: find_desc,
+        find_loc: find_loc,
+        sort: sort,
+        price: price,
+        open_now: open_now,
+        max_results: max_results,
+        start: start,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Yelp businesses (search + detail).
+    #
+    # Two modes. **Search** (`mode=search`): give `find_desc` (a keyword or category) and
+    # `find_loc` (a city/area) and get the businesses as JSON - `name`, `rating`, `reviewCount`,
+    # `priceRange`, `categories`, `address`, `neighborhoods`, `url`, `businessId`, `image` and
+    # `isAd`. Filter with `sort`, `price` (1-4) and `open_now`, and collect up to `max_results`
+    # across pages. **Detail** (`mode=detail`): give a business `url` and get a rich object -
+    # phone, full address, website, hours, attributes, categories, specialties, review
+    # highlights, photos and popular dishes.
+    #
+    # @param url [String] Detail mode: a Yelp business URL or /biz alias, e.g.
+    # 'https://www.yelp.com/biz/gary-danko-san-francisco'.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /local/yelp.
+    def yelp_business(url, proxy_country: nil)
+      post_json("/local/yelp", {
+        mode: "detail",
+        url: url,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Yelp business reviews.
+    #
+    # Given a Yelp `business` (page URL, alias or business id), returns the `business` summary
+    # (`businessId`, `alias`, `name`, `url`, `rating`, `reviewCount`, `ratingHistogram`,
+    # `reviewsCountByLanguage`, `categories`, `city`, `region`) and its `reviews`: `id`, `url`,
+    # `rating`, `text`, `language`, `publishedDate`, `date`, `user` (`name`, `location`,
+    # `reviewCount`, `friendCount`, `photoCount`, `isElite`, `eliteYear`), `photos`, `videos`,
+    # `reactions` (`helpful`, `thanks`, `loveThis`, `ohNo`), `ownerResponse`, `checkIns` and the
+    # author's `previousReviews`. Sort like yelp.com (`relevance`, `newest`, `oldest`,
+    # `highest`, `lowest`, `elites`), filter by `language`, star `rating`, a search `query` or
+    # `since` a date, and page with `page` / `start` up to `max_reviews` per call. To continue,
+    # call again with `start` = `nextStart` while `hasMore` is true: `nextStart` is the exact
+    # offset where this call stopped. `nextPage` is only set when that offset falls on a page
+    # boundary (a multiple of 10) and is null otherwise, because a page number would repeat
+    # reviews already returned. Counts: `business.reviewCount` is the review count Yelp shows
+    # for the business; `business.ratingHistogram` and `business.reviewsCountByLanguage` count
+    # the reviews in every language, and Yelp updates them separately from `reviewCount`, so
+    # their sums can differ from it by a few; `totalResults` is how many reviews match this
+    # call's `language`, `rating` and `query` (the total that `start` pages through). A business
+    # with no reviews returns an empty list; an unknown alias or URL is a 404. Billed one unit
+    # per 10 reviews returned (`pagesFetched`).
+    #
+    # @param business [String] The business: its Yelp page URL (https://www.yelp.com/biz/gary-
+    # danko-san-francisco), its alias (gary-danko-san-francisco) or its business id
+    # (WavvLdfdP6g8aZTtbBQHTw, the `businessId` of /local/yelp results). An id is answered
+    # fastest; a URL or alias costs one business-page fetch first.
+    # @param max_reviews [Integer] How many reviews to return (1-500). API default: 20.
+    # @param page [Integer] 1-based Yelp review page to start from (10 reviews per page, like
+    # yelp.com's own pages; 1-1000). To continue a previous response, pass its `nextStart` as
+    # `start`. API default: 1.
+    # @param start [Integer] 0-based review offset to start from instead of `page`. Pass
+    # `nextStart` from a previous response to continue exactly where it stopped.
+    # @param sort [String] Review order, as yelp.com's "Sort by" menu: relevance, newest,
+    # oldest, highest, lowest, elites. `relevance` is Yelp's default order. API default:
+    # relevance.
+    # @param language [String] Reviews written in this language (two-letter code: en, fr, de,
+    # es, ...). Yelp lists one language at a time. Default: the language most of the business's
+    # reviews are in; `business.reviewsCountByLanguage` lists the others.
+    # @param rating [String] Only reviews with these star ratings, comma-separated (e.g. `1,2`).
+    # @param query [String] Only reviews that mention this phrase (yelp.com's review search).
+    # @param since [String] Only reviews written on or after this date (YYYY-MM-DD). With
+    # `sort=newest` paging stops at the first older review.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank: Yelp serves reviews the same to every country.
+    # Calls POST /local/yelp-reviews.
+    def yelp_reviews(business, max_reviews: nil, page: nil, start: nil, sort: nil, language: nil, rating: nil, query: nil, since: nil, proxy_country: nil)
+      post_json("/local/yelp-reviews", {
+        business: business,
+        max_reviews: max_reviews,
+        page: page,
+        start: start,
+        sort: sort,
+        language: language,
+        rating: rating,
+        query: query,
+        since: since,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Naver Map places.
+    #
+    # Naver Map (Naver Place), Korea's main local search. `mode=search&query=` returns up to 50
+    # places (`results`): `id`, `name`, `category`, `businessType`, `address` / `roadAddress` /
+    # `jibunAddress`, `phone`, `latitude` / `longitude`, `rating`, `visitorReviewCount`,
+    # `blogReviewCount`, opening `status`, `microReview`, `popularMenus`, `options`, images,
+    # booking and Naver Pay flags, `hotelMinPrice` (stays), `representativePrice` (salons) and
+    # the place's Naver Map `url`, plus `totalResults`. `longitude` / `latitude` move the search
+    # centre (each place then carries its `distance`). `mode=details&place=<id or Naver Map
+    # link>` returns the `place` - addresses, phone, coordinates, `businessHours` per day,
+    # `description`, `directions`, `conveniences`, `facilities`, `keywords`, `menus` with
+    # prices, `photos`, `homepage` and `links`, `bookingUrl`, `subwayStations` and `reviewStats`
+    # (average rating, star distribution, keyword votes, themes) - with its first ten visitor
+    # `reviews` (`body`, `rating`, `created` / `createdDate`, `visitedAt`, `verifiedBy`,
+    # `keywords`, `media`, `reactions`, `author` stats, `ownerReply`) and its first
+    # `blogReviews` (blog and cafe posts). `sort=recent` returns the newest visitor reviews.
+    # Korean text is returned as is. One page per call, billed one unit.
+    #
+    # @param query [String] What to search for (mode=search), in Korean or English: a category,
+    # a place name or both, e.g. '강남 맛집', '홍대 카페', '부산 호텔', 'Gangnam cafe'.
+    # @param longitude [Float] Search centre longitude (mode=search, with `latitude`), e.g.
+    # 127.0276. Naver ranks places around the centre, and each result then carries its
+    # `distance` from it.
+    # @param latitude [Float] Search centre latitude (mode=search, with `longitude`), e.g.
+    # 37.4979.
+    # @param max_results [Integer] How many places to return (mode=search, 1-50). Naver answers
+    # one page of up to 50 places per search; move the search centre to reach other places. API
+    # default: 50.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'KR',
+    # 'US'). Leave blank for the country chosen for the site.
+    # Calls POST /maps/naver-place.
+    def naver_place_search(query, longitude: nil, latitude: nil, max_results: nil, proxy_country: nil)
+      post_json("/maps/naver-place", {
+        mode: "search",
+        query: query,
+        longitude: longitude,
+        latitude: latitude,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Naver Map places.
+    #
+    # Naver Map (Naver Place), Korea's main local search. `mode=search&query=` returns up to 50
+    # places (`results`): `id`, `name`, `category`, `businessType`, `address` / `roadAddress` /
+    # `jibunAddress`, `phone`, `latitude` / `longitude`, `rating`, `visitorReviewCount`,
+    # `blogReviewCount`, opening `status`, `microReview`, `popularMenus`, `options`, images,
+    # booking and Naver Pay flags, `hotelMinPrice` (stays), `representativePrice` (salons) and
+    # the place's Naver Map `url`, plus `totalResults`. `longitude` / `latitude` move the search
+    # centre (each place then carries its `distance`). `mode=details&place=<id or Naver Map
+    # link>` returns the `place` - addresses, phone, coordinates, `businessHours` per day,
+    # `description`, `directions`, `conveniences`, `facilities`, `keywords`, `menus` with
+    # prices, `photos`, `homepage` and `links`, `bookingUrl`, `subwayStations` and `reviewStats`
+    # (average rating, star distribution, keyword votes, themes) - with its first ten visitor
+    # `reviews` (`body`, `rating`, `created` / `createdDate`, `visitedAt`, `verifiedBy`,
+    # `keywords`, `media`, `reactions`, `author` stats, `ownerReply`) and its first
+    # `blogReviews` (blog and cafe posts). `sort=recent` returns the newest visitor reviews.
+    # Korean text is returned as is. One page per call, billed one unit.
+    #
+    # @param place [String] The place (mode=details): its Naver place id ('2097258400'), a Naver
+    # Map link (https://map.naver.com/p/entry/place/2097258400) or a Naver Place link
+    # (https://m.place.naver.com/restaurant/2097258400/home).
+    # @param sort [String] Visitor review order (mode=details): 'relevance' (Naver's default) or
+    # 'recent' (newest first). API default: relevance.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'KR',
+    # 'US'). Leave blank for the country chosen for the site.
+    # Calls POST /maps/naver-place.
+    def naver_place_details(place, sort: nil, proxy_country: nil)
+      post_json("/maps/naver-place", {
+        mode: "details",
+        place: place,
+        sort: sort,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Play app details and search.
+    #
+    # Scrapes the Google Play Store. `mode=app` with `app_id` (e.g. `com.whatsapp`) returns one
+    # app's full detail as JSON: title, developer and contact, category,
+    # `score`/`ratings`/`reviews` and the star `histogram`, `installs`, price / in-app
+    # purchases, content rating, description, screenshots, icon, `version`, `updated`, what's
+    # new and similar apps. `mode=search` with `q` returns matching apps (package id, title,
+    # developer, score, installs, icon, price). `hl`/`gl` set language and store country.
+    #
+    # @param app_id [String] Play package id for mode=app, e.g. 'com.whatsapp'.
+    # @param hl [String] Language code (ISO), e.g. 'en'. API default: en.
+    # @param gl [String] Store country (ISO-2), e.g. 'us'. API default: us.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /apps/google-play.
+    def google_play_app(app_id, hl: nil, gl: nil, proxy_country: nil)
+      post_json("/apps/google-play", {
+        mode: "app",
+        app_id: app_id,
+        hl: hl,
+        gl: gl,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Google Play app details and search.
+    #
+    # Scrapes the Google Play Store. `mode=app` with `app_id` (e.g. `com.whatsapp`) returns one
+    # app's full detail as JSON: title, developer and contact, category,
+    # `score`/`ratings`/`reviews` and the star `histogram`, `installs`, price / in-app
+    # purchases, content rating, description, screenshots, icon, `version`, `updated`, what's
+    # new and similar apps. `mode=search` with `q` returns matching apps (package id, title,
+    # developer, score, installs, icon, price). `hl`/`gl` set language and store country.
+    #
+    # @param q [String] Search term for mode=search, e.g. 'vpn'.
+    # @param max_results [Integer] How many apps to return for mode=search (one page). API
+    # default: 30.
+    # @param hl [String] Language code (ISO), e.g. 'en'. API default: en.
+    # @param gl [String] Store country (ISO-2), e.g. 'us'. API default: us.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /apps/google-play.
+    def google_play_search(q, max_results: nil, hl: nil, gl: nil, proxy_country: nil)
+      post_json("/apps/google-play", {
+        mode: "search",
+        q: q,
+        max_results: max_results,
+        hl: hl,
+        gl: gl,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Apple App Store app details, search and reviews.
+    #
+    # Scrapes the Apple App Store. `mode=app` with `app_id` (numeric id, `id310633997`, an
+    # apps.apple.com URL or a bundle id) returns one app's full detail: title, `subtitle`,
+    # developer (id, store page, website), price / currency / `free`, `rating`, `ratingsCount`
+    # and the star `histogram`, `contentRating`, genres, `releaseDate`, `updated`, `version`,
+    # `releaseNotes` and `versionHistory`, `size` in bytes, `minimumOsVersion`, `languages`,
+    # description, screenshots, icon, `inAppPurchases`, `privacy` labels, `chartRank` and
+    # `similarApps`. `mode=search` with `q` returns matching apps (up to 200). `mode=reviews`
+    # returns customer reviews (title, text, rating, author, date, app version, helpful votes),
+    # newest or most helpful first; Apple serves 50 per page and 500 per country. `country`
+    # picks the storefront. mode=reviews is billed one request per review page fetched
+    # (`pagesFetched`).
+    #
+    # @param app_id [String] App for mode=app / mode=reviews: the numeric App Store id
+    # ('310633997'), 'id310633997', an apps.apple.com app URL, or a bundle id
+    # ('net.whatsapp.WhatsApp').
+    # @param country [String] App Store country (ISO-2), e.g. 'us', 'gb', 'de'. Prices, ratings
+    # and reviews are per country. Default: the country in an app URL, else 'us'.
+    # @param lang [String] Listing language for mode=app / mode=search, e.g. 'fr' or 'fr-CA'
+    # (for countries whose store has several languages). Default: the store's own.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /apps/app-store.
+    def app_store_app(app_id, country: nil, lang: nil, proxy_country: nil)
+      post_json("/apps/app-store", {
+        mode: "app",
+        app_id: app_id,
+        country: country,
+        lang: lang,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Apple App Store app details, search and reviews.
+    #
+    # Scrapes the Apple App Store. `mode=app` with `app_id` (numeric id, `id310633997`, an
+    # apps.apple.com URL or a bundle id) returns one app's full detail: title, `subtitle`,
+    # developer (id, store page, website), price / currency / `free`, `rating`, `ratingsCount`
+    # and the star `histogram`, `contentRating`, genres, `releaseDate`, `updated`, `version`,
+    # `releaseNotes` and `versionHistory`, `size` in bytes, `minimumOsVersion`, `languages`,
+    # description, screenshots, icon, `inAppPurchases`, `privacy` labels, `chartRank` and
+    # `similarApps`. `mode=search` with `q` returns matching apps (up to 200). `mode=reviews`
+    # returns customer reviews (title, text, rating, author, date, app version, helpful votes),
+    # newest or most helpful first; Apple serves 50 per page and 500 per country. `country`
+    # picks the storefront. mode=reviews is billed one request per review page fetched
+    # (`pagesFetched`).
+    #
+    # @param q [String] Search term for mode=search, e.g. 'vpn'.
+    # @param country [String] App Store country (ISO-2), e.g. 'us', 'gb', 'de'. Prices, ratings
+    # and reviews are per country. Default: the country in an app URL, else 'us'.
+    # @param lang [String] Listing language for mode=app / mode=search, e.g. 'fr' or 'fr-CA'
+    # (for countries whose store has several languages). Default: the store's own.
+    # @param max_results [Integer] mode=search: apps to return (1-200). mode=reviews: reviews to
+    # collect (1-500); Apple serves 50 per page and at most 10 pages per country, each page
+    # billed as one request. API default: 50.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /apps/app-store.
+    def app_store_search(q, country: nil, lang: nil, max_results: nil, proxy_country: nil)
+      post_json("/apps/app-store", {
+        mode: "search",
+        q: q,
+        country: country,
+        lang: lang,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Apple App Store app details, search and reviews.
+    #
+    # Scrapes the Apple App Store. `mode=app` with `app_id` (numeric id, `id310633997`, an
+    # apps.apple.com URL or a bundle id) returns one app's full detail: title, `subtitle`,
+    # developer (id, store page, website), price / currency / `free`, `rating`, `ratingsCount`
+    # and the star `histogram`, `contentRating`, genres, `releaseDate`, `updated`, `version`,
+    # `releaseNotes` and `versionHistory`, `size` in bytes, `minimumOsVersion`, `languages`,
+    # description, screenshots, icon, `inAppPurchases`, `privacy` labels, `chartRank` and
+    # `similarApps`. `mode=search` with `q` returns matching apps (up to 200). `mode=reviews`
+    # returns customer reviews (title, text, rating, author, date, app version, helpful votes),
+    # newest or most helpful first; Apple serves 50 per page and 500 per country. `country`
+    # picks the storefront. mode=reviews is billed one request per review page fetched
+    # (`pagesFetched`).
+    #
+    # @param app_id [String] App for mode=app / mode=reviews: the numeric App Store id
+    # ('310633997'), 'id310633997', an apps.apple.com app URL, or a bundle id
+    # ('net.whatsapp.WhatsApp').
+    # @param country [String] App Store country (ISO-2), e.g. 'us', 'gb', 'de'. Prices, ratings
+    # and reviews are per country. Default: the country in an app URL, else 'us'.
+    # @param max_results [Integer] mode=search: apps to return (1-200). mode=reviews: reviews to
+    # collect (1-500); Apple serves 50 per page and at most 10 pages per country, each page
+    # billed as one request. API default: 50.
+    # @param sort [String] Review order for mode=reviews: mostrecent, mosthelpful. API default:
+    # mostrecent.
+    # @param page [Integer] mode=reviews: review page to start from (1-10). Use `nextPage` of a
+    # previous response to continue. When the last page was only partly used, `nextPage` points
+    # at it again, so skip reviews whose `id` you already have. API default: 1.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /apps/app-store.
+    def app_store_reviews(app_id, country: nil, max_results: nil, sort: nil, page: nil, proxy_country: nil)
+      post_json("/apps/app-store", {
+        mode: "reviews",
+        app_id: app_id,
+        country: country,
+        max_results: max_results,
+        sort: sort,
+        page: page,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a YouTube channel's videos.
+    #
+    # Returns a YouTube channel's recent videos as JSON: `videoId`, `title`, `views`,
+    # `published`, `thumbnail` and a watch `url`, plus a `channel` summary (name, id). Pass a
+    # handle (`@mkbhd`), a channel id (`UC...`) or a channel URL. Returns the channel's first
+    # page of videos (about 30).
+    #
+    # @param channel [String] Channel handle (@mkbhd), channel id (UC...) or a channel URL.
+    # @param tab [String] Which tab: videos, shorts, streams. API default: videos.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE').
+    # @param limit [Integer] Max videos to return (1-200). Honoured on the 'videos' tab; other
+    # tabs return a single scraped page. API default: 30.
+    # Calls POST /content/youtube-channel.
+    def youtube_channel(channel, tab: nil, proxy_country: nil, limit: nil)
+      post_json("/content/youtube-channel", {
+        channel: channel,
+        tab: tab,
+        proxy_country: proxy_country,
+        limit: limit,
+      })
+    end
+
+    # Search YouTube.
+    #
+    # Searches YouTube for `query` and returns the results as JSON. For each video: `videoId`,
+    # `title`, `url`, `channel` (name/id/url), `publishedText`, `viewCount` (+ text),
+    # `lengthSeconds` (+ text), `thumbnails`, `descriptionSnippet`, `badges`, `verified` and
+    # `isLive`. Filter with `type` (video / channel / playlist / all) and `sort` (relevance /
+    # date / views / rating), and collect up to `max_results` across pages.
+    #
+    # @param query [String] Search terms.
+    # @param max_results [Integer] How many results to collect across pages (~20 per page). API
+    # default: 20.
+    # @param type [String] Result type: video, channel, playlist, movie, all. API default:
+    # video.
+    # @param sort [String] Ordering: relevance, rating, date, views. API default: relevance.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Defaults to US.
+    # Calls POST /content/youtube-search.
+    def youtube_search(query, max_results: nil, type: nil, sort: nil, proxy_country: nil)
+      post_json("/content/youtube-search", {
+        query: query,
+        max_results: max_results,
+        type: type,
+        sort: sort,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a YouTube video's comments.
+    #
+    # Returns a YouTube video's comments as JSON. For each comment: `commentId`, `author`,
+    # `authorChannelId`, `authorThumbnail`, `text`, `likeCount`, `publishedTimeText`,
+    # `replyCount`, and the `isPinned`, `isHearted`, `isAuthorVerified` and `isUploader` flags,
+    # plus the video `title` and total `commentCount`. Sort by `top` or `newest` and collect up
+    # to `max_results` across pages.
+    #
+    # @param video [String] Video id (dQw4w9WgXcQ) or any YouTube video URL.
+    # @param sort [String] Comment order: top, newest. API default: top.
+    # @param max_results [Integer] How many comments to collect across pages (~20 per page). API
+    # default: 20.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE') for the watch page. Defaults to US.
+    # Calls POST /content/youtube-comments.
+    def youtube_comments(video, sort: nil, max_results: nil, proxy_country: nil)
+      post_json("/content/youtube-comments", {
+        video: video,
+        sort: sort,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Get a YouTube video transcript.
+    #
+    # Returns a YouTube video's captions as JSON: timestamped `segments` (`start`, `dur`,
+    # `text`) and a joined `text`, plus `availableLanguages`, the picked `language`,
+    # `isAutoGenerated`, and the video's `title`, `author` and `lengthSeconds`. Pass a video id
+    # or any YouTube video URL; choose a caption language with `lang`. Ideal for LLM/RAG
+    # pipelines, subtitles and content analysis.
+    #
+    # @param video [String] Video id (dQw4w9WgXcQ) or any YouTube video URL.
+    # @param lang [String] Preferred caption language code, e.g. 'en'. Omit for the
+    # default/first track. A prefix like 'en' matches 'en-US'.
+    # @param format [String] Output shape: segments, text. 'segments' returns timestamps; 'text'
+    # returns only the joined plaintext. API default: segments.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE') for the watch page. Defaults to US.
+    # Calls POST /content/youtube-transcript.
+    def youtube_transcript(video, lang: nil, format: nil, proxy_country: nil)
+      post_json("/content/youtube-transcript", {
+        video: video,
+        lang: lang,
+        format: format,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Spotify artists, albums, tracks, playlists and search.
+    #
+    # Returns Spotify catalog data as JSON, including the play counts and audience numbers the
+    # official Web API does not expose. `type=artist`: `artist` (`followers`,
+    # `monthlyListeners`, `worldRank`, `topCities`, `biography`, `externalLinks`, images,
+    # `verified`), `topTracks` with `playcount` (a top track's `album` carries `name` and
+    # `releaseDate` when Spotify lists that album among the artist's releases), `discography`
+    # groups (popular releases, albums, singles, compilations with totals), `relatedArtists`,
+    # `appearsOn`, `featuredOn` / `discoveredOn` playlists; `discography=true` adds the full
+    # `releases` list, paged. `type=album`: `album` (type, release date, label, copyright,
+    # artists, cover) and `tracks` with `playcount`, paged. `type=track`: `track` with
+    # `playcount`, duration, explicit flag, album and every credited artist. `type=playlist`:
+    # `playlist` (name, description, `followers`, owner, cover, `totalTracks`) and `tracks` with
+    # `playcount`, `addedAt`, `bpm` and `key`, paged. `type=search&query=`: `results` of
+    # `search_type` tracks, artists, albums or playlists, paged; a search with no match answers
+    # 200 with empty `results`. `playcount` comes only on artist, album, track and playlist
+    # lookups: Spotify's search does not return it, so search track results have no `playcount`
+    # key (look a track up with `type=track` for its count). `id` takes an open.spotify.com URL,
+    # a Spotify URI or a bare id. Lists page with `offset` / `max_results` and answer `hasMore`
+    # / `nextOffset`; each page fetched is one billed unit (`pagesFetched`).
+    #
+    # @param query [String] Search text for type=search, e.g. 'daft punk'.
+    # @param search_type [String] What a search returns: tracks, artists, albums, playlists. API
+    # default: tracks.
+    # @param offset [Integer] 0-based position to start from in the list being paged: album
+    # tracks, playlist tracks, search results, or the full discography with discography=true.
+    # Use the `nextOffset` of a previous response to continue. Spotify serves search results up
+    # to position 1000. API default: 0.
+    # @param max_results [Integer] How many list items to collect. Album tracks: 1-1000 (default
+    # 100, 100 per page). Playlist tracks: 1-2000 (default 100, 100 per page). Search: 1-1000
+    # (default 20, 50 per page). Artist releases with discography=true: 1-1000 (default 50, 50
+    # per page). Each page fetched is one billed unit.
+    # @param proxy_country [String] Country the request is sent from (ISO-2, e.g. 'DE', 'GB').
+    # Spotify's market follows it, which can change `playable` and search order; play counts are
+    # the same everywhere. Leave blank for any.
+    # Calls POST /music/spotify.
+    def spotify_search(query, search_type: nil, offset: nil, max_results: nil, proxy_country: nil)
+      post_json("/music/spotify", {
+        type: "search",
+        query: query,
+        search_type: search_type,
+        offset: offset,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Spotify artists, albums, tracks, playlists and search.
+    #
+    # Returns Spotify catalog data as JSON, including the play counts and audience numbers the
+    # official Web API does not expose. `type=artist`: `artist` (`followers`,
+    # `monthlyListeners`, `worldRank`, `topCities`, `biography`, `externalLinks`, images,
+    # `verified`), `topTracks` with `playcount` (a top track's `album` carries `name` and
+    # `releaseDate` when Spotify lists that album among the artist's releases), `discography`
+    # groups (popular releases, albums, singles, compilations with totals), `relatedArtists`,
+    # `appearsOn`, `featuredOn` / `discoveredOn` playlists; `discography=true` adds the full
+    # `releases` list, paged. `type=album`: `album` (type, release date, label, copyright,
+    # artists, cover) and `tracks` with `playcount`, paged. `type=track`: `track` with
+    # `playcount`, duration, explicit flag, album and every credited artist. `type=playlist`:
+    # `playlist` (name, description, `followers`, owner, cover, `totalTracks`) and `tracks` with
+    # `playcount`, `addedAt`, `bpm` and `key`, paged. `type=search&query=`: `results` of
+    # `search_type` tracks, artists, albums or playlists, paged; a search with no match answers
+    # 200 with empty `results`. `playcount` comes only on artist, album, track and playlist
+    # lookups: Spotify's search does not return it, so search track results have no `playcount`
+    # key (look a track up with `type=track` for its count). `id` takes an open.spotify.com URL,
+    # a Spotify URI or a bare id. Lists page with `offset` / `max_results` and answer `hasMore`
+    # / `nextOffset`; each page fetched is one billed unit (`pagesFetched`).
+    #
+    # @param id [String] The artist, album, track or playlist: an open.spotify.com URL
+    # (https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02), a Spotify URI
+    # (spotify:artist:06HL4z0CvFAxyc27GXpf02) or a bare 22-character id (then set `type`).
+    # @param discography [Boolean] type=artist only: also return the artist's full release list
+    # (albums, singles, compilations, newest first) in `releases`, paged by offset /
+    # max_results. API default: false.
+    # @param proxy_country [String] Country the request is sent from (ISO-2, e.g. 'DE', 'GB').
+    # Spotify's market follows it, which can change `playable` and search order; play counts are
+    # the same everywhere. Leave blank for any.
+    # Calls POST /music/spotify.
+    def spotify_artist(id, discography: nil, proxy_country: nil)
+      post_json("/music/spotify", {
+        type: "artist",
+        id: id,
+        discography: discography,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Spotify artists, albums, tracks, playlists and search.
+    #
+    # Returns Spotify catalog data as JSON, including the play counts and audience numbers the
+    # official Web API does not expose. `type=artist`: `artist` (`followers`,
+    # `monthlyListeners`, `worldRank`, `topCities`, `biography`, `externalLinks`, images,
+    # `verified`), `topTracks` with `playcount` (a top track's `album` carries `name` and
+    # `releaseDate` when Spotify lists that album among the artist's releases), `discography`
+    # groups (popular releases, albums, singles, compilations with totals), `relatedArtists`,
+    # `appearsOn`, `featuredOn` / `discoveredOn` playlists; `discography=true` adds the full
+    # `releases` list, paged. `type=album`: `album` (type, release date, label, copyright,
+    # artists, cover) and `tracks` with `playcount`, paged. `type=track`: `track` with
+    # `playcount`, duration, explicit flag, album and every credited artist. `type=playlist`:
+    # `playlist` (name, description, `followers`, owner, cover, `totalTracks`) and `tracks` with
+    # `playcount`, `addedAt`, `bpm` and `key`, paged. `type=search&query=`: `results` of
+    # `search_type` tracks, artists, albums or playlists, paged; a search with no match answers
+    # 200 with empty `results`. `playcount` comes only on artist, album, track and playlist
+    # lookups: Spotify's search does not return it, so search track results have no `playcount`
+    # key (look a track up with `type=track` for its count). `id` takes an open.spotify.com URL,
+    # a Spotify URI or a bare id. Lists page with `offset` / `max_results` and answer `hasMore`
+    # / `nextOffset`; each page fetched is one billed unit (`pagesFetched`).
+    #
+    # @param id [String] The artist, album, track or playlist: an open.spotify.com URL
+    # (https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02), a Spotify URI
+    # (spotify:artist:06HL4z0CvFAxyc27GXpf02) or a bare 22-character id (then set `type`).
+    # @param offset [Integer] 0-based position to start from in the list being paged: album
+    # tracks, playlist tracks, search results, or the full discography with discography=true.
+    # Use the `nextOffset` of a previous response to continue. Spotify serves search results up
+    # to position 1000. API default: 0.
+    # @param max_results [Integer] How many list items to collect. Album tracks: 1-1000 (default
+    # 100, 100 per page). Playlist tracks: 1-2000 (default 100, 100 per page). Search: 1-1000
+    # (default 20, 50 per page). Artist releases with discography=true: 1-1000 (default 50, 50
+    # per page). Each page fetched is one billed unit.
+    # @param proxy_country [String] Country the request is sent from (ISO-2, e.g. 'DE', 'GB').
+    # Spotify's market follows it, which can change `playable` and search order; play counts are
+    # the same everywhere. Leave blank for any.
+    # Calls POST /music/spotify.
+    def spotify_album(id, offset: nil, max_results: nil, proxy_country: nil)
+      post_json("/music/spotify", {
+        type: "album",
+        id: id,
+        offset: offset,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Spotify artists, albums, tracks, playlists and search.
+    #
+    # Returns Spotify catalog data as JSON, including the play counts and audience numbers the
+    # official Web API does not expose. `type=artist`: `artist` (`followers`,
+    # `monthlyListeners`, `worldRank`, `topCities`, `biography`, `externalLinks`, images,
+    # `verified`), `topTracks` with `playcount` (a top track's `album` carries `name` and
+    # `releaseDate` when Spotify lists that album among the artist's releases), `discography`
+    # groups (popular releases, albums, singles, compilations with totals), `relatedArtists`,
+    # `appearsOn`, `featuredOn` / `discoveredOn` playlists; `discography=true` adds the full
+    # `releases` list, paged. `type=album`: `album` (type, release date, label, copyright,
+    # artists, cover) and `tracks` with `playcount`, paged. `type=track`: `track` with
+    # `playcount`, duration, explicit flag, album and every credited artist. `type=playlist`:
+    # `playlist` (name, description, `followers`, owner, cover, `totalTracks`) and `tracks` with
+    # `playcount`, `addedAt`, `bpm` and `key`, paged. `type=search&query=`: `results` of
+    # `search_type` tracks, artists, albums or playlists, paged; a search with no match answers
+    # 200 with empty `results`. `playcount` comes only on artist, album, track and playlist
+    # lookups: Spotify's search does not return it, so search track results have no `playcount`
+    # key (look a track up with `type=track` for its count). `id` takes an open.spotify.com URL,
+    # a Spotify URI or a bare id. Lists page with `offset` / `max_results` and answer `hasMore`
+    # / `nextOffset`; each page fetched is one billed unit (`pagesFetched`).
+    #
+    # @param id [String] The artist, album, track or playlist: an open.spotify.com URL
+    # (https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02), a Spotify URI
+    # (spotify:artist:06HL4z0CvFAxyc27GXpf02) or a bare 22-character id (then set `type`).
+    # @param proxy_country [String] Country the request is sent from (ISO-2, e.g. 'DE', 'GB').
+    # Spotify's market follows it, which can change `playable` and search order; play counts are
+    # the same everywhere. Leave blank for any.
+    # Calls POST /music/spotify.
+    def spotify_track(id, proxy_country: nil)
+      post_json("/music/spotify", {
+        type: "track",
+        id: id,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Spotify artists, albums, tracks, playlists and search.
+    #
+    # Returns Spotify catalog data as JSON, including the play counts and audience numbers the
+    # official Web API does not expose. `type=artist`: `artist` (`followers`,
+    # `monthlyListeners`, `worldRank`, `topCities`, `biography`, `externalLinks`, images,
+    # `verified`), `topTracks` with `playcount` (a top track's `album` carries `name` and
+    # `releaseDate` when Spotify lists that album among the artist's releases), `discography`
+    # groups (popular releases, albums, singles, compilations with totals), `relatedArtists`,
+    # `appearsOn`, `featuredOn` / `discoveredOn` playlists; `discography=true` adds the full
+    # `releases` list, paged. `type=album`: `album` (type, release date, label, copyright,
+    # artists, cover) and `tracks` with `playcount`, paged. `type=track`: `track` with
+    # `playcount`, duration, explicit flag, album and every credited artist. `type=playlist`:
+    # `playlist` (name, description, `followers`, owner, cover, `totalTracks`) and `tracks` with
+    # `playcount`, `addedAt`, `bpm` and `key`, paged. `type=search&query=`: `results` of
+    # `search_type` tracks, artists, albums or playlists, paged; a search with no match answers
+    # 200 with empty `results`. `playcount` comes only on artist, album, track and playlist
+    # lookups: Spotify's search does not return it, so search track results have no `playcount`
+    # key (look a track up with `type=track` for its count). `id` takes an open.spotify.com URL,
+    # a Spotify URI or a bare id. Lists page with `offset` / `max_results` and answer `hasMore`
+    # / `nextOffset`; each page fetched is one billed unit (`pagesFetched`).
+    #
+    # @param id [String] The artist, album, track or playlist: an open.spotify.com URL
+    # (https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02), a Spotify URI
+    # (spotify:artist:06HL4z0CvFAxyc27GXpf02) or a bare 22-character id (then set `type`).
+    # @param offset [Integer] 0-based position to start from in the list being paged: album
+    # tracks, playlist tracks, search results, or the full discography with discography=true.
+    # Use the `nextOffset` of a previous response to continue. Spotify serves search results up
+    # to position 1000. API default: 0.
+    # @param max_results [Integer] How many list items to collect. Album tracks: 1-1000 (default
+    # 100, 100 per page). Playlist tracks: 1-2000 (default 100, 100 per page). Search: 1-1000
+    # (default 20, 50 per page). Artist releases with discography=true: 1-1000 (default 50, 50
+    # per page). Each page fetched is one billed unit.
+    # @param proxy_country [String] Country the request is sent from (ISO-2, e.g. 'DE', 'GB').
+    # Spotify's market follows it, which can change `playable` and search order; play counts are
+    # the same everywhere. Leave blank for any.
+    # Calls POST /music/spotify.
+    def spotify_playlist(id, offset: nil, max_results: nil, proxy_country: nil)
+      post_json("/music/spotify", {
+        type: "playlist",
+        id: id,
+        offset: offset,
+        max_results: max_results,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape a public Telegram channel: info and posts.
+    #
+    # Reads a public Telegram channel's web preview. Returns `channel` (`username`, `title`,
+    # `description`, `avatar`, `verified`, `subscribers` and the other `counters`) and `posts`,
+    # newest first: `id`, `url`, `date` (ISO-8601 UTC), `text` (plain), `textHtml`, `views`,
+    # `author` (signature), `edited`, `forwardedFrom`, `replyTo`, `media` (photo / video /
+    # animation / round_video / voice / audio / document / sticker, with CDN `url`, `thumbnail`,
+    # `duration`), `poll`, `linkPreview`, `reactions` (a custom-emoji reaction has its
+    # `customEmojiId`, plus the standard `emoji` and `image` Telegram falls back to when the
+    # page shows that emoji anywhere), `buttons`, `links`, `hashtags` (the tags Telegram links;
+    # a bare '#7' is text) and `mentions`. One page (about 20 posts) by default; `max_posts` (up
+    # to 500) pages back through history; `before`, `after` and `since` bound the range, `q`
+    # searches inside the channel and `post_id` returns one post. `nextBefore` continues a
+    # capped answer. Only channels have a public preview: users, bots, groups and private
+    # channels answer 404. Billed one request per page fetched (`pagesFetched`).
+    #
+    # @param channel [String] Public channel: username ('durov'), '@durov', or a t.me link
+    # ('https://t.me/durov', 'https://t.me/s/durov'). A post link ('https://t.me/durov/400')
+    # returns that one post.
+    # @param max_posts [Integer] Posts to collect, newest first (1-500), paging back through the
+    # channel's history; each page fetched is billed as one request. Omit it for one page,
+    # billed once: the newest posts (a page has 20 message slots and an album fills one per
+    # photo, so it can hold fewer posts).
+    # @param before [Integer] Only posts with an id below this one. Pass `nextBefore` of a
+    # previous response to continue where it stopped.
+    # @param after [Integer] Stop at this post id: only posts with a higher id are returned.
+    # @param since [String] Stop at this date: only posts published on or after it (YYYY-MM-DD
+    # or an ISO-8601 datetime, UTC when no offset is given).
+    # @param q [String] Search inside the channel: only posts matching this text.
+    # @param post_id [Integer] Return only this post (a post id of the channel).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank to let the API pick.
+    # Calls POST /social/telegram-channel.
+    def telegram_channel(channel, max_posts: nil, before: nil, after: nil, since: nil, q: nil, post_id: nil, proxy_country: nil)
+      post_json("/social/telegram-channel", {
+        channel: channel,
+        max_posts: max_posts,
+        before: before,
+        after: after,
+        since: since,
+        q: q,
+        post_id: post_id,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Quora questions, answers and profiles.
+    #
+    # Given a Quora `question` (URL or slug), returns the `question` (`qid`, `title`, `url`,
+    # `answerCount`, `allRelatedCount`, `followerCount`, `commentCount`, `topics`) and its
+    # `answers`: `id`, `url`, `relation` (`answer`, `merged` for an answer to a question Quora
+    # merged into this one, `related` with `include_related=true`), the answered `question`,
+    # `author` (`name`, `uid`, `profileUrl`, `imageUrl`, `credential`, `isVerified`,
+    # `isAnonymous`), the full `text` with `images` and `links`, `upvotes`, `views`, `shares`,
+    # `comments`, `createdAt`, `updatedAt` and `isAiGenerated`; plus `relatedQuestions`. Answers
+    # are in Quora's own order, up to `max_answers` (10 per page after the first few), unique
+    # within a call. `nextCursor` as `cursor` continues, best-effort: Quora re-ranks the list on
+    # every visit, so a continuation can repeat or skip answers of earlier calls (dedupe by
+    # `id`); for a complete list ask for a larger `max_answers` in one call (up to 300).
+    # `mode=profile&profile=` returns a public `profile` (`name`, `headline`, `description`,
+    # follower / following / answer / question / post counts, `contentViews`, `credentials`,
+    # `knowsAbout`, `spaces`, `topWriterYears`, `joinedAt`) with its newest `answers`. No login:
+    # only what Quora shows an anonymous visitor - Quora's search is not available that way, and
+    # Quora lists only a profile's newest few dozen answers to logged-out visitors
+    # (`pagingStopped`: `quora_logged_out_limit`). `pagingStopped` otherwise names why paging
+    # ended early (`blocked`, `time`, `unavailable`). Billed one unit per page fetched
+    # (`pagesFetched`); a `cursor` continuation bills only its GraphQL pages.
+    #
+    # @param question [String] Quora question URL (https://www.quora.com/What-is-the-best-way-
+    # to-learn-programming), an answer URL on it, or the question slug (What-is-the-best-way-to-
+    # learn-programming). Language editions such as es.quora.com are accepted as URLs. Required
+    # with mode=question.
+    # @param max_answers [Integer] Answers to return: 1-300 with mode=question (default 20),
+    # 0-200 with mode=profile (default 10; 0 = profile only). Answers come 10 per page after the
+    # first few; each page is one billed unit.
+    # @param include_related [Boolean] mode=question: also return the answers Quora shows from
+    # related questions (its 'All related' view, `relation`='related'). By default only answers
+    # to this question and to questions merged into it. API default: false.
+    # @param cursor [String] Continue after a previous call: pass its `nextCursor`. Best-effort:
+    # each call is a new Quora visit and Quora re-ranks the list per visit, so a continuation
+    # can repeat or skip answers of earlier calls - dedupe by answer `id`. For a complete list
+    # ask for a larger `max_answers` in one call (up to 300).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the countries chosen for the site.
+    # Calls POST /social/quora.
+    def quora_question(question, max_answers: nil, include_related: nil, cursor: nil, proxy_country: nil)
+      post_json("/social/quora", {
+        mode: "question",
+        question: question,
+        max_answers: max_answers,
+        include_related: include_related,
+        cursor: cursor,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Scrape Quora questions, answers and profiles.
+    #
+    # Given a Quora `question` (URL or slug), returns the `question` (`qid`, `title`, `url`,
+    # `answerCount`, `allRelatedCount`, `followerCount`, `commentCount`, `topics`) and its
+    # `answers`: `id`, `url`, `relation` (`answer`, `merged` for an answer to a question Quora
+    # merged into this one, `related` with `include_related=true`), the answered `question`,
+    # `author` (`name`, `uid`, `profileUrl`, `imageUrl`, `credential`, `isVerified`,
+    # `isAnonymous`), the full `text` with `images` and `links`, `upvotes`, `views`, `shares`,
+    # `comments`, `createdAt`, `updatedAt` and `isAiGenerated`; plus `relatedQuestions`. Answers
+    # are in Quora's own order, up to `max_answers` (10 per page after the first few), unique
+    # within a call. `nextCursor` as `cursor` continues, best-effort: Quora re-ranks the list on
+    # every visit, so a continuation can repeat or skip answers of earlier calls (dedupe by
+    # `id`); for a complete list ask for a larger `max_answers` in one call (up to 300).
+    # `mode=profile&profile=` returns a public `profile` (`name`, `headline`, `description`,
+    # follower / following / answer / question / post counts, `contentViews`, `credentials`,
+    # `knowsAbout`, `spaces`, `topWriterYears`, `joinedAt`) with its newest `answers`. No login:
+    # only what Quora shows an anonymous visitor - Quora's search is not available that way, and
+    # Quora lists only a profile's newest few dozen answers to logged-out visitors
+    # (`pagingStopped`: `quora_logged_out_limit`). `pagingStopped` otherwise names why paging
+    # ended early (`blocked`, `time`, `unavailable`). Billed one unit per page fetched
+    # (`pagesFetched`); a `cursor` continuation bills only its GraphQL pages.
+    #
+    # @param profile [String] Quora profile URL (https://www.quora.com/profile/Adam-DAngelo) or
+    # profile slug (Adam-DAngelo). Required with mode=profile.
+    # @param max_answers [Integer] Answers to return: 1-300 with mode=question (default 20),
+    # 0-200 with mode=profile (default 10; 0 = profile only). Answers come 10 per page after the
+    # first few; each page is one billed unit.
+    # @param cursor [String] Continue after a previous call: pass its `nextCursor`. Best-effort:
+    # each call is a new Quora visit and Quora re-ranks the list per visit, so a continuation
+    # can repeat or skip answers of earlier calls - dedupe by answer `id`. For a complete list
+    # ask for a larger `max_answers` in one call (up to 300).
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Leave blank for the countries chosen for the site.
+    # Calls POST /social/quora.
+    def quora_profile(profile, max_answers: nil, cursor: nil, proxy_country: nil)
+      post_json("/social/quora", {
+        mode: "profile",
+        profile: profile,
+        max_answers: max_answers,
+        cursor: cursor,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Get a website's Similarweb traffic overview.
+    #
+    # Returns Similarweb's public traffic overview for `domain` as JSON: `globalRank`,
+    # `countryRank` (with `country`), `categoryRank` (with `category`) and their month-over-
+    # month changes; `totalVisits` for the latest month with `visitsChangePercent`;
+    # `bounceRate`, `pagesPerVisit`, `avgVisitDuration`/`avgVisitDurationSeconds`;
+    # `visitsHistory` (the last 3 months - earlier months are derived from Similarweb's own
+    # month-over-month change) and `rankHistory`; `trafficSources` (channel shares -
+    # Similarweb's free page reveals only some, the rest are null); `topCountries`;
+    # `demographics` (gender, age groups); `competitors` (similar sites with affinity); `search`
+    # (organic/paid split and top keywords); `socialNetworks`, `referrals`, `outgoingLinks`,
+    # `displayAds`; `technologies`; `audienceInterests`; and the `company` profile.
+    # `snapshotDate` is the month the data describes. A domain Similarweb has no page for
+    # returns `found: false` with the same keys set to null/empty; a known domain too small to
+    # estimate returns `hasTrafficData: false`.
+    #
+    # @param domain [String] Website to look up: a bare domain ('github.com'), a URL
+    # ('https://www.github.com/about'), or a Similarweb page URL. A leading 'www.' is dropped;
+    # other subdomains ('docs.python.org') are kept.
+    # @param proxy_country [String] Proxy country the request is sent from (ISO-2, e.g. 'US',
+    # 'DE'). Optional.
+    # Calls POST /seo/similarweb.
+    def similarweb_overview(domain, proxy_country: nil)
+      post_json("/seo/similarweb", {
+        domain: domain,
+        proxy_country: proxy_country,
+      })
+    end
+
+    # Run Ahrefs' free SEO tools (DR, backlinks, traffic, keywords, KD, SERP).
+    #
+    # Ahrefs' free SEO tools as JSON, without an Ahrefs account.
+    # `tool=authority&target=<domain>`: `domainRating`, `backlinks`, `referringDomains`,
+    # `dofollowBacklinksPercent`, `dofollowReferringDomainsPercent`. `tool=backlinks`: the same
+    # plus `topBacklinks` (`urlFrom`, `urlTo`, `title`, `anchor`, `textBefore`/`textAfter`,
+    # `domainRating`). `tool=traffic`: `organicTraffic`, `trafficValueUsd`, `trafficHistory`,
+    # `topPages`, `topCountries`, `topKeywords` (`country` narrows it to one market).
+    # `tool=broken-links`: `inbound` broken backlinks and `outbound` broken links on the site's
+    # pages. `tool=keyword-difficulty&keyword=<phrase>`: `difficulty` (0-100),
+    # `referringDomainsToRank` and the SERP `results`. `tool=keywords`: `ideas` and
+    # `questionIdeas` with `difficulty` and `volume` buckets, plus totals (Google). `tool=serp`:
+    # the top Google `results` (organic with `metrics` - DR, UR, backlinks, referring domains,
+    # traffic, value, keywords - plus AI overview, questions, shopping, local and news blocks).
+    # Domain tools take `mode` (subdomains, domain, prefix, exact). One call, one unit.
+    #
+    # @param tool [String] Which Ahrefs free tool to run: 'authority' (Domain Rating),
+    # 'backlinks', 'traffic', 'broken-links' (these take `target`), 'keyword-difficulty',
+    # 'keywords' (keyword ideas), 'serp' (these take `keyword`).
+    # @param target [String] Domain or URL for the domain tools, e.g. 'github.com' or
+    # 'https://github.com/features'.
+    # @param keyword [String] Search phrase for the keyword tools, e.g. 'running shoes'.
+    # @param country [String] Two-letter market code. Keyword tools: the search market (default
+    # 'us'). traffic: limits the estimate to that country (default: worldwide). Not used by the
+    # other domain tools.
+    # @param mode [String] Target scope for the domain tools: 'subdomains' (the domain with all
+    # its subdomains), 'domain' (without subdomains), 'prefix' (everything under the URL) or
+    # 'exact' (that URL only). API default: subdomains.
+    # @param protocol [String] traffic only: 'both', 'http' or 'https'. API default: both.
+    # @param questions [Boolean] keywords only: also return question ideas. API default: true.
+    # Calls POST /seo/ahrefs.
+    def ahrefs(tool, target: nil, keyword: nil, country: nil, mode: nil, protocol: nil, questions: nil)
+      post_json("/seo/ahrefs", {
+        tool: tool,
+        target: target,
+        keyword: keyword,
+        country: country,
+        mode: mode,
+        protocol: protocol,
+        questions: questions,
+      })
+    end
+
+    # Get a website's Semrush overview (Authority Score, traffic, backlinks).
+    #
+    # Semrush's public website data for `domain`, without a Semrush account. `report=overview`
+    # (default): `authorityScore`, `globalRank`, `countryRank`, `categoryRank`, `visits` with
+    # `visitsChangePercent` and `visitsHistory` (desktop/mobile), `pagesPerVisit`,
+    # `timeOnSiteSeconds`, `bounceRate`, `searchTraffic` (organic and paid with history),
+    # `backlinks` (backlinks, referring domains, Google penalty risk, history), `topKeywords`
+    # (position, search volume, CPC, traffic share, intent), `topCountries`, `competitors`,
+    # `trafficSources` (incoming and outgoing) and `aiTraffic` (visits from AI assistants).
+    # `report=competitors`: the domain's competitors, each with Authority Score, ranks, visits
+    # and engagement. Semrush publishes these pages for about 200k of the most visited sites;
+    # any other domain returns `found: false`. One call, one unit.
+    #
+    # @param domain [String] Website to look up: a domain ('github.com'), a URL
+    # ('https://www.github.com/about') or a Semrush website page URL. A leading 'www.' is
+    # dropped; other subdomains are kept.
+    # @param report [String] 'overview' (traffic, rank, search traffic, backlinks, keywords,
+    # countries, competitors, sources) or 'competitors' (the competitor list with each one's
+    # ranks, visits and engagement). API default: overview.
+    # Calls POST /seo/semrush.
+    def semrush_overview(domain, report: nil)
+      post_json("/seo/semrush", {
+        domain: domain,
+        report: report,
+      })
+    end
+
+    private
+
+    def plugin_join(value, sep)
+      value.is_a?(Array) ? value.join(sep) : value
+    end
+  end
+end