webscraping_ai 1.0.0 → 2.0.0

data/lib/webscraping_ai.rb

@@ -1,12 +1,12 @@
 =begin
 #WebScraping.AI
 
-#A client for https://webscraping.ai API. It provides Chrome JS rendering, rotating proxies and HTML parsing for web scraping.
-
-The version of the OpenAPI document: 1.0.0
+#A client for https://webscraping.ai API. It provides a web scaping automation API with Chrome JS rendering, rotating proxies and builtin HTML parsing.
 
+The version of the OpenAPI document: 2.0.0
+Contact: support@webscraping.ai
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 4.2.3
+OpenAPI Generator version: 4.3.1
 
 =end
 
@@ -17,10 +17,12 @@ require 'webscraping_ai/version'
 require 'webscraping_ai/configuration'
 
 # Models
-require 'webscraping_ai/models/scrapped_page'
+require 'webscraping_ai/models/error'
+require 'webscraping_ai/models/page_error'
 
 # APIs
 require 'webscraping_ai/api/html_api'
+require 'webscraping_ai/api/selected_html_api'
 
 module WebScrapingAI
   class << self

data/lib/webscraping_ai/api/html_api.rb

@@ -1,71 +1,82 @@
 =begin
 #WebScraping.AI
 
-#A client for https://webscraping.ai API. It provides Chrome JS rendering, rotating proxies and HTML parsing for web scraping.
-
-The version of the OpenAPI document: 1.0.0
+#A client for https://webscraping.ai API. It provides a web scaping automation API with Chrome JS rendering, rotating proxies and builtin HTML parsing.
 
+The version of the OpenAPI document: 2.0.0
+Contact: support@webscraping.ai
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 4.2.3
+OpenAPI Generator version: 4.3.1
 
 =end
 
 require 'cgi'
 
 module WebScrapingAI
-  class HtmlApi
+  class HTMLApi
     attr_accessor :api_client
 
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
-    # Get page HTML by URL (renders JS in Chrome and uses rotating proxies)
-    # @param url [String] URL of the page to get
+    # Page HTML by URL
+    # Returns just HTML on success, JSON on error
+    # @param url [String] URL of the target page
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :selector CSS selector to get a part of the page (null by default, returns whole page HTML)
-    # @option opts [Boolean] :outer_html Return outer HTML of the selected element (false by default, returns inner HTML)
-    # @option opts [String] :proxy Proxy country code, for geotargeting (US by default)
-    # @option opts [Boolean] :disable_js Disable JS execution (false by default)
-    # @option opts [Boolean] :inline_css Inline included CSS files to make page viewable on other domains (false by default)
-    # @return [ScrappedPage]
-    def get_page(url, opts = {})
-      data, _status_code, _headers = get_page_with_http_info(url, opts)
-      data
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [nil]
+    def get_html(url, opts = {})
+      get_html_with_http_info(url, opts)
+      nil
     end
 
-    # Get page HTML by URL (renders JS in Chrome and uses rotating proxies)
-    # @param url [String] URL of the page to get
+    # Page HTML by URL
+    # Returns just HTML on success, JSON on error
+    # @param url [String] URL of the target page
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :selector CSS selector to get a part of the page (null by default, returns whole page HTML)
-    # @option opts [Boolean] :outer_html Return outer HTML of the selected element (false by default, returns inner HTML)
-    # @option opts [String] :proxy Proxy country code, for geotargeting (US by default)
-    # @option opts [Boolean] :disable_js Disable JS execution (false by default)
-    # @option opts [Boolean] :inline_css Inline included CSS files to make page viewable on other domains (false by default)
-    # @return [Array<(ScrappedPage, Integer, Hash)>] ScrappedPage data, response status code and response headers
-    def get_page_with_http_info(url, opts = {})
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_html_with_http_info(url, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: HtmlApi.get_page ...'
+        @api_client.config.logger.debug 'Calling API: HTMLApi.get_html ...'
       end
       # verify the required parameter 'url' is set
       if @api_client.config.client_side_validation && url.nil?
-        fail ArgumentError, "Missing the required parameter 'url' when calling HtmlApi.get_page"
+        fail ArgumentError, "Missing the required parameter 'url' when calling HTMLApi.get_html"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling HTMLApi.get_html, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling HTMLApi.get_html, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/'
+      local_var_path = '/html'
 
       # query parameters
       query_params = opts[:query_params] || {}
       query_params[:'url'] = url
-      query_params[:'selector'] = opts[:'selector'] if !opts[:'selector'].nil?
-      query_params[:'outer_html'] = opts[:'outer_html'] if !opts[:'outer_html'].nil?
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
       query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
-      query_params[:'disable_js'] = opts[:'disable_js'] if !opts[:'disable_js'].nil?
-      query_params[:'inline_css'] = opts[:'inline_css'] if !opts[:'inline_css'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/html'])
 
       # form parameters
       form_params = opts[:form_params] || {}
@@ -74,7 +85,7 @@ module WebScrapingAI
       post_body = opts[:body] 
 
       # return_type
-      return_type = opts[:return_type] || 'ScrappedPage' 
+      return_type = opts[:return_type] 
 
       # auth_names
       auth_names = opts[:auth_names] || ['api_key']
@@ -90,7 +101,94 @@ module WebScrapingAI
 
       data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
       if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: HtmlApi#get_page\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+        @api_client.config.logger.debug "API called: HTMLApi#get_html\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Page HTML by URL with POST request to the target page
+    # Returns just HTML on success, JSON on error. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [nil]
+    def post_html(url, opts = {})
+      post_html_with_http_info(url, opts)
+      nil
+    end
+
+    # Page HTML by URL with POST request to the target page
+    # Returns just HTML on success, JSON on error. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_html_with_http_info(url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: HTMLApi.post_html ...'
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling HTMLApi.post_html"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling HTMLApi.post_html, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling HTMLApi.post_html, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/html'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
+      query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/html'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['api_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: HTMLApi#post_html\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end
       return data, status_code, headers
     end

data/lib/webscraping_ai/api/selected_html_api.rb

@@ -0,0 +1,382 @@
+=begin
+#WebScraping.AI
+
+#A client for https://webscraping.ai API. It provides a web scaping automation API with Chrome JS rendering, rotating proxies and builtin HTML parsing.
+
+The version of the OpenAPI document: 2.0.0
+Contact: support@webscraping.ai
+Generated by: https://openapi-generator.tech
+OpenAPI Generator version: 4.3.1
+
+=end
+
+require 'cgi'
+
+module WebScrapingAI
+  class SelectedHTMLApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # HTML of a selected page area by URL and CSS selector
+    # Returns just HTML on success, JSON on error
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :selector CSS selector (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [nil]
+    def get_selected(url, opts = {})
+      get_selected_with_http_info(url, opts)
+      nil
+    end
+
+    # HTML of a selected page area by URL and CSS selector
+    # Returns just HTML on success, JSON on error
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :selector CSS selector (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def get_selected_with_http_info(url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SelectedHTMLApi.get_selected ...'
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling SelectedHTMLApi.get_selected"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.get_selected, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.get_selected, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/selected'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+      query_params[:'selector'] = opts[:'selector'] if !opts[:'selector'].nil?
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
+      query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/html'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['api_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SelectedHTMLApi#get_selected\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # HTML of multiple page areas by URL and CSS selectors
+    # Always returns JSON
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :selectors Multiple CSS selectors (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [Array<String>]
+    def get_selected_multiple(url, opts = {})
+      data, _status_code, _headers = get_selected_multiple_with_http_info(url, opts)
+      data
+    end
+
+    # HTML of multiple page areas by URL and CSS selectors
+    # Always returns JSON
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :selectors Multiple CSS selectors (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(Array<String>, Integer, Hash)>] Array<String> data, response status code and response headers
+    def get_selected_multiple_with_http_info(url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SelectedHTMLApi.get_selected_multiple ...'
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling SelectedHTMLApi.get_selected_multiple"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.get_selected_multiple, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.get_selected_multiple, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/selected-multiple'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+      query_params[:'selectors'] = @api_client.build_collection_param(opts[:'selectors'], :multi) if !opts[:'selectors'].nil?
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
+      query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] || 'Array<String>' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['api_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SelectedHTMLApi#get_selected_multiple\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # HTML of a selected page areas by URL and CSS selector, with POST request to the target page
+    # Returns just HTML on success, JSON on error. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :selector CSS selector (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [nil]
+    def post_selected(url, opts = {})
+      post_selected_with_http_info(url, opts)
+      nil
+    end
+
+    # HTML of a selected page areas by URL and CSS selector, with POST request to the target page
+    # Returns just HTML on success, JSON on error. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :selector CSS selector (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def post_selected_with_http_info(url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SelectedHTMLApi.post_selected ...'
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling SelectedHTMLApi.post_selected"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.post_selected, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.post_selected, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/selected'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+      query_params[:'selector'] = opts[:'selector'] if !opts[:'selector'].nil?
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
+      query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/html'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['api_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SelectedHTMLApi#post_selected\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # HTML of multiple page areas by URL and CSS selectors, with POST request to the target page
+    # Always returns JSON. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :selectors Multiple CSS selectors (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000) (default to 5000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests (default to true)
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default) (default to 'datacenter')
+    # @return [Array<String>]
+    def post_selected_multiple(url, opts = {})
+      data, _status_code, _headers = post_selected_multiple_with_http_info(url, opts)
+      data
+    end
+
+    # HTML of multiple page areas by URL and CSS selectors, with POST request to the target page
+    # Always returns JSON. Request body will be passed to the target page.
+    # @param url [String] URL of the target page
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<String>] :selectors Multiple CSS selectors (null by default, returns whole page HTML)
+    # @option opts [Hash<String, String>] :headers HTTP headers to pass to the target page. Can be specified either via a nested query parameter (...&amp;headers[One]&#x3D;value1&amp;headers&#x3D;[Another]&#x3D;value2) or as a JSON encoded object (...&amp;headers&#x3D;{\&quot;One\&quot;: \&quot;value1\&quot;, \&quot;Another\&quot;: \&quot;value2\&quot;})
+    # @option opts [Integer] :timeout Maximum processing time in ms. Increase it in case of timeout errors (5000 by default, maximum is 30000)
+    # @option opts [Boolean] :js Execute on-page JavaScript using a headless browser (true by default), costs 2 requests
+    # @option opts [String] :proxy Type of proxy, use residential proxies if your site restricts traffic from datacenters (datacenter by default)
+    # @return [Array<(Array<String>, Integer, Hash)>] Array<String> data, response status code and response headers
+    def post_selected_multiple_with_http_info(url, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SelectedHTMLApi.post_selected_multiple ...'
+      end
+      # verify the required parameter 'url' is set
+      if @api_client.config.client_side_validation && url.nil?
+        fail ArgumentError, "Missing the required parameter 'url' when calling SelectedHTMLApi.post_selected_multiple"
+      end
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] > 30000
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.post_selected_multiple, must be smaller than or equal to 30000.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'timeout'].nil? && opts[:'timeout'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"timeout"]" when calling SelectedHTMLApi.post_selected_multiple, must be greater than or equal to 1.'
+      end
+
+      allowable_values = ["datacenter", "residential"]
+      if @api_client.config.client_side_validation && opts[:'proxy'] && !allowable_values.include?(opts[:'proxy'])
+        fail ArgumentError, "invalid value for \"proxy\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/selected-multiple'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'url'] = url
+      query_params[:'selectors'] = @api_client.build_collection_param(opts[:'selectors'], :multi) if !opts[:'selectors'].nil?
+      query_params[:'headers'] = opts[:'headers'] if !opts[:'headers'].nil?
+      query_params[:'timeout'] = opts[:'timeout'] if !opts[:'timeout'].nil?
+      query_params[:'js'] = opts[:'js'] if !opts[:'js'].nil?
+      query_params[:'proxy'] = opts[:'proxy'] if !opts[:'proxy'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] 
+
+      # return_type
+      return_type = opts[:return_type] || 'Array<String>' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['api_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SelectedHTMLApi#post_selected_multiple\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end