RubyGems - aylien_news_api - Versions diffs - 0.1.0 → 0.2.0 - Mend

aylien_news_api 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

checksums.yaml +4 -4
data/Gemfile.lock +2 -4
data/README.md +8 -7
data/aylien_news_api.gemspec +15 -2
data/docs/CategoryLinks.md +2 -2
data/docs/Coverages.md +1 -0
data/docs/DefaultApi.md +315 -252
data/docs/Media.md +1 -1
data/docs/RelatedStories.md +1 -0
data/docs/Scope.md +4 -4
data/docs/Story.md +5 -5
data/lib/aylien_news_api/api/default_api.rb +615 -549
data/lib/aylien_news_api/api_client.rb +2 -2
data/lib/aylien_news_api/configuration.rb +8 -0
data/lib/aylien_news_api/models/author.rb +25 -6
data/lib/aylien_news_api/models/autocomplete.rb +23 -5
data/lib/aylien_news_api/models/autocompletes.rb +21 -4
data/lib/aylien_news_api/models/category.rb +57 -12
data/lib/aylien_news_api/models/category_links.rb +25 -7
data/lib/aylien_news_api/models/coverages.rb +45 -12
data/lib/aylien_news_api/models/entities.rb +23 -5
data/lib/aylien_news_api/models/entity.rb +49 -8
data/lib/aylien_news_api/models/entity_links.rb +21 -4
data/lib/aylien_news_api/models/error.rb +31 -9
data/lib/aylien_news_api/models/error_links.rb +21 -4
data/lib/aylien_news_api/models/errors.rb +21 -4
data/lib/aylien_news_api/models/histogram_interval.rb +23 -5
data/lib/aylien_news_api/models/histograms.rb +29 -8
data/lib/aylien_news_api/models/location.rb +25 -6
data/lib/aylien_news_api/models/media.rb +50 -9
data/lib/aylien_news_api/models/related_stories.rb +43 -11
data/lib/aylien_news_api/models/scope.rb +57 -14
data/lib/aylien_news_api/models/sentiment.rb +69 -8
data/lib/aylien_news_api/models/sentiments.rb +23 -5
data/lib/aylien_news_api/models/share_count.rb +23 -5
data/lib/aylien_news_api/models/share_counts.rb +27 -7
data/lib/aylien_news_api/models/source.rb +31 -9
data/lib/aylien_news_api/models/stories.rb +25 -6
data/lib/aylien_news_api/models/story.rb +64 -28
data/lib/aylien_news_api/models/story_cluster.rb +29 -8
data/lib/aylien_news_api/models/story_links.rb +25 -6
data/lib/aylien_news_api/models/summary.rb +21 -4
data/lib/aylien_news_api/models/time_series.rb +23 -5
data/lib/aylien_news_api/models/time_series_list.rb +27 -7
data/lib/aylien_news_api/models/trend.rb +23 -5
data/lib/aylien_news_api/models/trends.rb +23 -5
data/lib/aylien_news_api/version.rb +1 -1
data/spec/api_client_spec.rb +306 -0
data/spec/configuration_spec.rb +39 -0
data/spec/spec_helper.rb +113 -0
metadata +34 -49
data/Rakefile +0 -8
data/aylien_news_api-0.0.1.gem +0 -0

data/docs/Media.md CHANGED

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**type** | **String** | Type of the media | [optional]
+**type** | **String** | The type of media | [optional]
 **url** | **String** | A URL which points to the media file | [optional]

data/docs/RelatedStories.md CHANGED

@@ -7,5 +7,6 @@ Name | Type | Description | Notes
 **story_body** | **String** | The input story body | [optional]
 **story_language** | **String** | The input story language | [optional]
 **related_stories** | [**Array&lt;Story&gt;**](Story.md) | An array of related stories for the input story | [optional]
+**clusters** | [**Array&lt;StoryCluster&gt;**](StoryCluster.md) | An array of clusters | [optional]

data/docs/Scope.md CHANGED

@@ -3,9 +3,9 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**country** | **String** | The country code of the scope. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. | [optional]
-**state** | **String** | The state of the scope | [optional]
-**city** | **String** | The city of the scope | [optional]
-**level** | **String** | The level of the scope | [optional]
+**country** | **String** | The source scope by country code. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. | [optional]
+**state** | **String** | The scope by state | [optional]
+**city** | **String** | The scope by city | [optional]
+**level** | **String** | The scope by level | [optional]

data/docs/Story.md CHANGED

@@ -3,7 +3,7 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **Integer** | ID of the story which is unique identification | [optional]
+**id** | **Integer** | ID of the story which is a unique identification | [optional]
 **title** | **String** | Title of the story | [optional]
 **body** | **String** | Body of the story | [optional]
 **summary** | [**Summary**](Summary.md) | The suggested story summary | [optional]
@@ -12,10 +12,10 @@ Name | Type | Description | Notes
 **entities** | [**Entities**](Entities.md) | Extracted entities from the story title or body | [optional]
 **keywords** | **Array&lt;String&gt;** | Extracted keywords mentioned in the story title or body | [optional]
 **hashtags** | **Array&lt;String&gt;** | An array of suggested Story hashtags | [optional]
-**characters_count** | **Integer** | Characters count of the story body | [optional]
-**words_count** | **Integer** | Words count of the story body | [optional]
-**sentences_count** | **Integer** | Sentences count of the story body | [optional]
-**paragraphs_count** | **Integer** | Paragraphs count of the story body | [optional]
+**characters_count** | **Integer** | Character count of the story body | [optional]
+**words_count** | **Integer** | Word count of the story body | [optional]
+**sentences_count** | **Integer** | Sentence count of the story body | [optional]
+**paragraphs_count** | **Integer** | Paragraph count of the story body | [optional]
 **categories** | [**Array&lt;Category&gt;**](Category.md) | Suggested categories for the story | [optional]
 **social_shares_count** | [**ShareCounts**](ShareCounts.md) | Social shares count for the story | [optional]
 **media** | [**Array&lt;Media&gt;**](Media.md) | An array of extracted media such as images and videos | [optional]

data/lib/aylien_news_api/api/default_api.rb CHANGED

@@ -25,10 +25,10 @@ module AylienNewsApi
     # List autocompletes
     # This endpoint is used for getting list of autocompletes by providing a specific term and type.
     # @param type This parameter is used for defining the type of autocompletes.
-    # @param term This parameter is used for finding autocomplete objects whose contains the specified value.
+    # @param term This parameter is used for finding autocomplete objects that contain the specified value.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :language This parameter is used for autocompletes whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to en)
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page. (default to 3)
     # @return [Autocompletes]
     def list_autocompletes(type, term, opts = {})
       data, _status_code, _headers = list_autocompletes_with_http_info(type, term, opts)
@@ -38,29 +38,28 @@ module AylienNewsApi
     # List autocompletes
     # This endpoint is used for getting list of autocompletes by providing a specific term and type.
     # @param type This parameter is used for defining the type of autocompletes.
-    # @param term This parameter is used for finding autocomplete objects whose contains the specified value.
+    # @param term This parameter is used for finding autocomplete objects that contain the specified value.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :language This parameter is used for autocompletes whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page.
     # @return [Array<(Autocompletes, Fixnum, Hash)>] Autocompletes data, response status code and response headers
     def list_autocompletes_with_http_info(type, term, opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_autocompletes ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_autocompletes ..."
       end
       # verify the required parameter 'type' is set
-      fail "Missing the required parameter 'type' when calling list_autocompletes" if type.nil?
+      fail ArgumentError, "Missing the required parameter 'type' when calling DefaultApi.list_autocompletes" if type.nil?
+      # verify enum value
       unless ['source_names', 'source_domains', 'entity_types', 'dbpedia_resources'].include?(type)
-        fail "invalid value for 'type', must be one of source_names, source_domains, entity_types, dbpedia_resources"
+        fail ArgumentError, "invalid value for 'type', must be one of source_names, source_domains, entity_types, dbpedia_resources"
       end
       # verify the required parameter 'term' is set
-      fail "Missing the required parameter 'term' when calling list_autocompletes" if term.nil?
+      fail ArgumentError, "Missing the required parameter 'term' when calling DefaultApi.list_autocompletes" if term.nil?
       if opts[:'language'] && !['en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'language'])
-        fail 'invalid value for "language", must be one of en, de, fr, it, es, pt'
+        fail ArgumentError, 'invalid value for "language", must be one of en, de, fr, it, es, pt'
       end
       # resource path
       local_var_path = "/autocompletes".sub('{format}','json')
@@ -68,8 +67,8 @@ module AylienNewsApi
       query_params = {}
       query_params[:'type'] = type
       query_params[:'term'] = term
-      query_params[:'language'] = opts[:'language'] if opts[:'language']
-      query_params[:'per_page'] = opts[:'per_page'] if opts[:'per_page']
+      query_params[:'language'] = opts[:'language'] if !opts[:'language'].nil?
+      query_params[:'per_page'] = opts[:'per_page'] if !opts[:'per_page'].nil?
       # header parameters
       header_params = {}
@@ -87,7 +86,7 @@ module AylienNewsApi
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -102,47 +101,53 @@ module AylienNewsApi
     end
     # List coverages
-    # This endpoint is used for finding story coverages based on provided parameters. The number of coverages to return, up to a maximum of 100.
+    # This endpoint is used for finding story coverages based on the parameters provided. The maximum number of related stories returned is 100.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes  is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes  is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories. (default to false)
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms. (default to lingo)
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
     # @option opts [Integer] :story_id A story id
     # @option opts [String] :story_url An article or webpage
     # @option opts [String] :story_title Title of the article
     # @option opts [String] :story_body Body of the article
-    # @option opts [DateTime] :story_published_at Publish date of the article. If you use url or title and body for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
-    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @option opts [DateTime] :story_published_at Publish date of the article. If you use a url or title and body of an article for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
+    # @option opts [String] :story_language This parameter is used for setting the language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page. (default to 3)
     # @return [Coverages]
     def list_coverages(opts = {})
       data, _status_code, _headers = list_coverages_with_http_info(opts)
@@ -150,69 +155,75 @@ module AylienNewsApi
     end
     # List coverages
-    # This endpoint is used for finding story coverages based on provided parameters. The number of coverages to return, up to a maximum of 100.
+    # This endpoint is used for finding story coverages based on the parameters provided. The maximum number of related stories returned is 100.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes  is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes  is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories.
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms.
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
     # @option opts [Integer] :story_id A story id
     # @option opts [String] :story_url An article or webpage
     # @option opts [String] :story_title Title of the article
     # @option opts [String] :story_body Body of the article
-    # @option opts [DateTime] :story_published_at Publish date of the article. If you use url or title and body for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
-    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @option opts [DateTime] :story_published_at Publish date of the article. If you use a url or title and body of an article for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
+    # @option opts [String] :story_language This parameter is used for setting the language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page.
     # @return [Array<(Coverages, Fixnum, Hash)>] Coverages data, response status code and response headers
     def list_coverages_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_coverages ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_coverages ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      if opts[:'cluster_algorithm'] && !['stc', 'lingo', 'kmeans'].include?(opts[:'cluster_algorithm'])
+        fail ArgumentError, 'invalid value for "cluster_algorithm", must be one of stc, lingo, kmeans'
       end
       if opts[:'story_language'] && !['auto', 'en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'story_language'])
-        fail 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
+        fail ArgumentError, 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
       end
       # resource path
       local_var_path = "/coverages".sub('{format}','json')
@@ -232,49 +243,55 @@ module AylienNewsApi
       # form parameters
       form_params = {}
-      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      form_params["title"] = opts[:'title'] if opts[:'title']
-      form_params["body"] = opts[:'body'] if opts[:'body']
-      form_params["text"] = opts[:'text'] if opts[:'text']
-      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      form_params["published_at.start"] = opts[:'published_at_start'] if opts[:'published_at_start']
-      form_params["published_at.end"] = opts[:'published_at_end'] if opts[:'published_at_end']
-      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      form_params["categories.confident"] = opts[:'categories_confident'] if opts[:'categories_confident']
-      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      form_params["author.name"] = opts[:'author_name'] if opts[:'author_name']
-      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      form_params["return[]"] = @api_client.build_collection_param(opts[:'_return'], :multi) if opts[:'_return']
-      form_params["story_id"] = opts[:'story_id'] if opts[:'story_id']
-      form_params["story_url"] = opts[:'story_url'] if opts[:'story_url']
-      form_params["story_title"] = opts[:'story_title'] if opts[:'story_title']
-      form_params["story_body"] = opts[:'story_body'] if opts[:'story_body']
-      form_params["story_published_at"] = opts[:'story_published_at'] if opts[:'story_published_at']
-      form_params["story_language"] = opts[:'story_language'] if opts[:'story_language']
-      form_params["per_page"] = opts[:'per_page'] if opts[:'per_page']
+      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      form_params["title"] = opts[:'title'] if !opts[:'title'].nil?
+      form_params["body"] = opts[:'body'] if !opts[:'body'].nil?
+      form_params["text"] = opts[:'text'] if !opts[:'text'].nil?
+      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      form_params["published_at.start"] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      form_params["published_at.end"] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      form_params["categories.confident"] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      form_params["media.images.count.min"] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      form_params["media.images.count.max"] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      form_params["media.videos.count.min"] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      form_params["media.videos.count.max"] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      form_params["author.name"] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      form_params["cluster"] = opts[:'cluster'] if !opts[:'cluster'].nil?
+      form_params["cluster.algorithm"] = opts[:'cluster_algorithm'] if !opts[:'cluster_algorithm'].nil?
+      form_params["return[]"] = @api_client.build_collection_param(opts[:'_return'], :multi) if !opts[:'_return'].nil?
+      form_params["story_id"] = opts[:'story_id'] if !opts[:'story_id'].nil?
+      form_params["story_url"] = opts[:'story_url'] if !opts[:'story_url'].nil?
+      form_params["story_title"] = opts[:'story_title'] if !opts[:'story_title'].nil?
+      form_params["story_body"] = opts[:'story_body'] if !opts[:'story_body'].nil?
+      form_params["story_published_at"] = opts[:'story_published_at'] if !opts[:'story_published_at'].nil?
+      form_params["story_language"] = opts[:'story_language'] if !opts[:'story_language'].nil?
+      form_params["per_page"] = opts[:'per_page'] if !opts[:'per_page'].nil?
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -289,39 +306,43 @@ module AylienNewsApi
     end
     # List histograms
-    # This endpoint is used for getting histograms based on the field parameter is passed.
+    # This endpoint is used for getting histograms based on the `field` parameter passed to the API.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [Integer] :interval_start This parameter is used for setting the start data point of histogram intervals.
     # @option opts [Integer] :interval_end This parameter is used for setting the end data point of histogram intervals.
     # @option opts [Integer] :interval_width This parameter is used for setting the width of histogram intervals.
@@ -333,39 +354,43 @@ module AylienNewsApi
     end
     # List histograms
-    # This endpoint is used for getting histograms based on the field parameter is passed.
+    # This endpoint is used for getting histograms based on the &#x60;field&#x60; parameter passed to the API.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [Integer] :interval_start This parameter is used for setting the start data point of histogram intervals.
     # @option opts [Integer] :interval_end This parameter is used for setting the end data point of histogram intervals.
     # @option opts [Integer] :interval_width This parameter is used for setting the width of histogram intervals.
@@ -373,65 +398,65 @@ module AylienNewsApi
     # @return [Array<(Histograms, Fixnum, Hash)>] Histograms data, response status code and response headers
     def list_histograms_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_histograms ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_histograms ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
       end
-      if opts[:'field'] && !['social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.reddit', 'social_shares_count.google_plus', 'characters_count', 'words_count', 'sentences_count', 'paragraphs_count'].include?(opts[:'field'])
-        fail 'invalid value for "field", must be one of social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.reddit, social_shares_count.google_plus, characters_count, words_count, sentences_count, paragraphs_count'
+      if opts[:'field'] && !['social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.reddit', 'social_shares_count.google_plus', 'characters_count', 'words_count', 'sentences_count', 'paragraphs_count', 'media.images.count', 'media.videos.count'].include?(opts[:'field'])
+        fail ArgumentError, 'invalid value for "field", must be one of social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.reddit, social_shares_count.google_plus, characters_count, words_count, sentences_count, paragraphs_count, media.images.count, media.videos.count'
       end
       # resource path
       local_var_path = "/histograms".sub('{format}','json')
       # query parameters
       query_params = {}
-      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      query_params[:'title'] = opts[:'title'] if opts[:'title']
-      query_params[:'body'] = opts[:'body'] if opts[:'body']
-      query_params[:'text'] = opts[:'text'] if opts[:'text']
-      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
-      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
-      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
-      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
-      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      query_params[:'interval.start'] = opts[:'interval_start'] if opts[:'interval_start']
-      query_params[:'interval.end'] = opts[:'interval_end'] if opts[:'interval_end']
-      query_params[:'interval.width'] = opts[:'interval_width'] if opts[:'interval_width']
-      query_params[:'field'] = opts[:'field'] if opts[:'field']
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      query_params[:'title'] = opts[:'title'] if !opts[:'title'].nil?
+      query_params[:'body'] = opts[:'body'] if !opts[:'body'].nil?
+      query_params[:'text'] = opts[:'text'] if !opts[:'text'].nil?
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      query_params[:'media.images.count.min'] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      query_params[:'media.images.count.max'] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      query_params[:'media.videos.count.min'] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      query_params[:'media.videos.count.max'] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      query_params[:'author.name'] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      query_params[:'interval.start'] = opts[:'interval_start'] if !opts[:'interval_start'].nil?
+      query_params[:'interval.end'] = opts[:'interval_end'] if !opts[:'interval_end'].nil?
+      query_params[:'interval.width'] = opts[:'interval_width'] if !opts[:'interval_width'].nil?
+      query_params[:'field'] = opts[:'field'] if !opts[:'field'].nil?
       # header parameters
       header_params = {}
@@ -449,7 +474,7 @@ module AylienNewsApi
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -464,47 +489,53 @@ module AylienNewsApi
     end
     # List related stories
-    # This endpoint is used for finding related stories based on provided parameters. The number of related stories to return, up to a maximum of 100.
+    # This endpoint is used for finding related stories based on the parameters provided. The maximum number of related stories returned is 100.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes  is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes  is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories. (default to false)
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms. (default to lingo)
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
     # @option opts [Integer] :story_id A story id
     # @option opts [String] :story_url An article or webpage
     # @option opts [String] :story_title Title of the article
     # @option opts [String] :story_body Body of the article
-    # @option opts [String] :boost_by This parameter is used for boosting result by the specified value.
-    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @option opts [String] :boost_by This parameter is used for boosting the result by the specified value.
+    # @option opts [String] :story_language This parameter is used for setting the language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page. (default to 3)
     # @return [RelatedStories]
     def list_related_stories(opts = {})
       data, _status_code, _headers = list_related_stories_with_http_info(opts)
@@ -512,73 +543,78 @@ module AylienNewsApi
     end
     # List related stories
-    # This endpoint is used for finding related stories based on provided parameters. The number of related stories to return, up to a maximum of 100.
+    # This endpoint is used for finding related stories based on the parameters provided. The maximum number of related stories returned is 100.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes  is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes  is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories.
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms.
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
     # @option opts [Integer] :story_id A story id
     # @option opts [String] :story_url An article or webpage
     # @option opts [String] :story_title Title of the article
     # @option opts [String] :story_body Body of the article
-    # @option opts [String] :boost_by This parameter is used for boosting result by the specified value.
-    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @option opts [String] :boost_by This parameter is used for boosting the result by the specified value.
+    # @option opts [String] :story_language This parameter is used for setting the language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page.
     # @return [Array<(RelatedStories, Fixnum, Hash)>] RelatedStories data, response status code and response headers
     def list_related_stories_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_related_stories ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_related_stories ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      if opts[:'cluster_algorithm'] && !['stc', 'lingo', 'kmeans'].include?(opts[:'cluster_algorithm'])
+        fail ArgumentError, 'invalid value for "cluster_algorithm", must be one of stc, lingo, kmeans'
       end
       if opts[:'boost_by'] && !['recency', 'popularity'].include?(opts[:'boost_by'])
-        fail 'invalid value for "boost_by", must be one of recency, popularity'
+        fail ArgumentError, 'invalid value for "boost_by", must be one of recency, popularity'
       end
       if opts[:'story_language'] && !['auto', 'en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'story_language'])
-        fail 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
+        fail ArgumentError, 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
       end
       # resource path
       local_var_path = "/related_stories".sub('{format}','json')
@@ -598,49 +634,55 @@ module AylienNewsApi
       # form parameters
       form_params = {}
-      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      form_params["title"] = opts[:'title'] if opts[:'title']
-      form_params["body"] = opts[:'body'] if opts[:'body']
-      form_params["text"] = opts[:'text'] if opts[:'text']
-      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      form_params["published_at.start"] = opts[:'published_at_start'] if opts[:'published_at_start']
-      form_params["published_at.end"] = opts[:'published_at_end'] if opts[:'published_at_end']
-      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      form_params["categories.confident"] = opts[:'categories_confident'] if opts[:'categories_confident']
-      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      form_params["author.name"] = opts[:'author_name'] if opts[:'author_name']
-      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      form_params["return[]"] = @api_client.build_collection_param(opts[:'_return'], :multi) if opts[:'_return']
-      form_params["story_id"] = opts[:'story_id'] if opts[:'story_id']
-      form_params["story_url"] = opts[:'story_url'] if opts[:'story_url']
-      form_params["story_title"] = opts[:'story_title'] if opts[:'story_title']
-      form_params["story_body"] = opts[:'story_body'] if opts[:'story_body']
-      form_params["boost_by"] = opts[:'boost_by'] if opts[:'boost_by']
-      form_params["story_language"] = opts[:'story_language'] if opts[:'story_language']
-      form_params["per_page"] = opts[:'per_page'] if opts[:'per_page']
+      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      form_params["title"] = opts[:'title'] if !opts[:'title'].nil?
+      form_params["body"] = opts[:'body'] if !opts[:'body'].nil?
+      form_params["text"] = opts[:'text'] if !opts[:'text'].nil?
+      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      form_params["published_at.start"] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      form_params["published_at.end"] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      form_params["categories.confident"] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      form_params["media.images.count.min"] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      form_params["media.images.count.max"] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      form_params["media.videos.count.min"] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      form_params["media.videos.count.max"] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      form_params["author.name"] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      form_params["cluster"] = opts[:'cluster'] if !opts[:'cluster'].nil?
+      form_params["cluster.algorithm"] = opts[:'cluster_algorithm'] if !opts[:'cluster_algorithm'].nil?
+      form_params["return[]"] = @api_client.build_collection_param(opts[:'_return'], :multi) if !opts[:'_return'].nil?
+      form_params["story_id"] = opts[:'story_id'] if !opts[:'story_id'].nil?
+      form_params["story_url"] = opts[:'story_url'] if !opts[:'story_url'].nil?
+      form_params["story_title"] = opts[:'story_title'] if !opts[:'story_title'].nil?
+      form_params["story_body"] = opts[:'story_body'] if !opts[:'story_body'].nil?
+      form_params["boost_by"] = opts[:'boost_by'] if !opts[:'boost_by'].nil?
+      form_params["story_language"] = opts[:'story_language'] if !opts[:'story_language'].nil?
+      form_params["per_page"] = opts[:'per_page'] if !opts[:'per_page'].nil?
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:POST, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -655,46 +697,50 @@ module AylienNewsApi
     end
     # List Stories
-    # This endpoint is used for getting list of stories.
+    # This endpoint is used for getting a list of stories.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories. (default to false)
-    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms. (default to lingo)
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms. (default to lingo)
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
-    # @option opts [String] :sort_by This parameter is used for changing the order column of the result. (default to published_at)
+    # @option opts [String] :sort_by This parameter is used for changing the order column of the results. (default to published_at)
     # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. (default to desc)
     # @option opts [String] :cursor This parameter is used for finding a specific page. (default to *)
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 10)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page. (default to 10)
     # @return [Stories]
     def list_stories(opts = {})
       data, _status_code, _headers = list_stories_with_http_info(opts)
@@ -702,119 +748,122 @@ module AylienNewsApi
     end
     # List Stories
-    # This endpoint is used for getting list of stories.
+    # This endpoint is used for getting a list of stories.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories.
-    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms.
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm you wish to use. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms.
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
-    # @option opts [String] :sort_by This parameter is used for changing the order column of the result.
+    # @option opts [String] :sort_by This parameter is used for changing the order column of the results.
     # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result.
     # @option opts [String] :cursor This parameter is used for finding a specific page.
-    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page.
     # @return [Array<(Stories, Fixnum, Hash)>] Stories data, response status code and response headers
     def list_stories_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_stories ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_stories ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'cluster_algorithm'] && !['stc', 'lingo', 'kmeans'].include?(opts[:'cluster_algorithm'])
-        fail 'invalid value for "cluster_algorithm", must be one of stc, lingo, kmeans'
+        fail ArgumentError, 'invalid value for "cluster_algorithm", must be one of stc, lingo, kmeans'
       end
-      if opts[:'sort_by'] && !['relevance', 'recency', 'hotness', 'published_at', 'social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.google_plus', 'social_shares_count.reddit'].include?(opts[:'sort_by'])
-        fail 'invalid value for "sort_by", must be one of relevance, recency, hotness, published_at, social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.google_plus, social_shares_count.reddit'
+      if opts[:'sort_by'] && !['relevance', 'recency', 'hotness', 'published_at', 'social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.google_plus', 'social_shares_count.reddit', 'media.images.count', 'media.videos.count'].include?(opts[:'sort_by'])
+        fail ArgumentError, 'invalid value for "sort_by", must be one of relevance, recency, hotness, published_at, social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.google_plus, social_shares_count.reddit, media.images.count, media.videos.count'
       end
       if opts[:'sort_direction'] && !['asc', 'desc'].include?(opts[:'sort_direction'])
-        fail 'invalid value for "sort_direction", must be one of asc, desc'
+        fail ArgumentError, 'invalid value for "sort_direction", must be one of asc, desc'
       end
       # resource path
       local_var_path = "/stories".sub('{format}','json')
       # query parameters
       query_params = {}
-      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      query_params[:'title'] = opts[:'title'] if opts[:'title']
-      query_params[:'body'] = opts[:'body'] if opts[:'body']
-      query_params[:'text'] = opts[:'text'] if opts[:'text']
-      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
-      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
-      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
-      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
-      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      query_params[:'cluster'] = opts[:'cluster'] if opts[:'cluster']
-      query_params[:'cluster.algorithm'] = opts[:'cluster_algorithm'] if opts[:'cluster_algorithm']
-      query_params[:'return[]'] = @api_client.build_collection_param(opts[:'_return'], :multi) if opts[:'_return']
-      query_params[:'sort_by'] = opts[:'sort_by'] if opts[:'sort_by']
-      query_params[:'sort_direction'] = opts[:'sort_direction'] if opts[:'sort_direction']
-      query_params[:'cursor'] = opts[:'cursor'] if opts[:'cursor']
-      query_params[:'per_page'] = opts[:'per_page'] if opts[:'per_page']
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      query_params[:'title'] = opts[:'title'] if !opts[:'title'].nil?
+      query_params[:'body'] = opts[:'body'] if !opts[:'body'].nil?
+      query_params[:'text'] = opts[:'text'] if !opts[:'text'].nil?
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      query_params[:'media.images.count.min'] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      query_params[:'media.images.count.max'] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      query_params[:'media.videos.count.min'] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      query_params[:'media.videos.count.max'] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      query_params[:'author.name'] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      query_params[:'cluster'] = opts[:'cluster'] if !opts[:'cluster'].nil?
+      query_params[:'cluster.algorithm'] = opts[:'cluster_algorithm'] if !opts[:'cluster_algorithm'].nil?
+      query_params[:'return[]'] = @api_client.build_collection_param(opts[:'_return'], :multi) if !opts[:'_return'].nil?
+      query_params[:'sort_by'] = opts[:'sort_by'] if !opts[:'sort_by'].nil?
+      query_params[:'sort_direction'] = opts[:'sort_direction'] if !opts[:'sort_direction'].nil?
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'per_page'] = opts[:'per_page'] if !opts[:'per_page'].nil?
       # header parameters
       header_params = {}
@@ -832,7 +881,7 @@ module AylienNewsApi
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -854,33 +903,37 @@ module AylienNewsApi
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW-7DAYS/DAY)
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW/DAY)
-    # @option opts [String] :period The size of each date range expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math). (default to +1DAY)
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW-7DAYS/DAY)
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW/DAY)
+    # @option opts [String] :period The size of each date range is expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math). (default to +1DAY)
     # @return [TimeSeriesList]
     def list_time_series(opts = {})
       data, _status_code, _headers = list_time_series_with_http_info(opts)
@@ -895,88 +948,93 @@ module AylienNewsApi
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :period The size of each date range expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math).
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :period The size of each date range is expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math).
     # @return [Array<(TimeSeriesList, Fixnum, Hash)>] TimeSeriesList data, response status code and response headers
     def list_time_series_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_time_series ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_time_series ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
       end
       # resource path
       local_var_path = "/time_series".sub('{format}','json')
       # query parameters
       query_params = {}
-      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      query_params[:'title'] = opts[:'title'] if opts[:'title']
-      query_params[:'body'] = opts[:'body'] if opts[:'body']
-      query_params[:'text'] = opts[:'text'] if opts[:'text']
-      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
-      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
-      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
-      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
-      query_params[:'period'] = opts[:'period'] if opts[:'period']
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      query_params[:'title'] = opts[:'title'] if !opts[:'title'].nil?
+      query_params[:'body'] = opts[:'body'] if !opts[:'body'].nil?
+      query_params[:'text'] = opts[:'text'] if !opts[:'text'].nil?
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      query_params[:'media.images.count.min'] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      query_params[:'media.images.count.max'] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      query_params[:'media.videos.count.min'] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      query_params[:'media.videos.count.max'] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      query_params[:'author.name'] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      query_params[:'period'] = opts[:'period'] if !opts[:'period'].nil?
       # header parameters
       header_params = {}
@@ -994,7 +1052,7 @@ module AylienNewsApi
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,
@@ -1009,39 +1067,43 @@ module AylienNewsApi
     end
     # List trends
-    # This endpoint is used for finding news trendings based on stories resource.
+    # This endpoint is used for finding trends based on stories.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [String] :field This parameter is used to specify the trend field.
     # @return [Trends]
     def list_trends(opts = {})
@@ -1050,99 +1112,103 @@ module AylienNewsApi
     end
     # List trends
-    # This endpoint is used for finding news trendings based on stories resource.
+    # This endpoint is used for finding trends based on stories.
     # @param [Hash] opts the optional parameters
     # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
     # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
     # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
-    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
-    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at time is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at time is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining the type of the taxonomy for the rest of the categories queries.
     # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
-    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
-    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
-    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
-    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
-    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
-    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
-    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
-    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories by categories id.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level.
+    # @option opts [Array<String>] :entities_title_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in story titles.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in story titles.
+    # @option opts [Array<String>] :entities_body_text This parameter is used to find stories based on the specified entities &#x60;text&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_type This parameter is used to find stories based on the specified entities &#x60;type&#x60; in the body of stories.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used to find stories based on the specified entities dbpedia URL in the body of stories.
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
     # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Integer] :media_images_count_min This parameter is used for finding stories whose number of images is greater than or equal to the specified value.
+    # @option opts [Integer] :media_images_count_max This parameter is used for finding stories whose number of images is less than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_min This parameter is used for finding stories whose number of videos is greater than or equal to the specified value.
+    # @option opts [Integer] :media_videos_count_max This parameter is used for finding stories whose number of videos is less than or equal to the specified value.
     # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
     # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
     # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
     # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
     # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
-    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
-    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
-    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
-    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
-    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
-    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes is the specified country value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes is the specified state/province value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes is the specified city value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes is the specified level value. [Here](https://newsapi.aylien.com/docs/working-with-locations) you can find more information about how [to work with locations](https://newsapi.aylien.com/docs/working-with-locations).
     # @option opts [String] :field This parameter is used to specify the trend field.
     # @return [Array<(Trends, Fixnum, Hash)>] Trends data, response status code and response headers
     def list_trends_with_http_info(opts = {})
       if @api_client.config.debugging
-        @api_client.config.logger.debug "Calling API: DefaultApi#list_trends ..."
+        @api_client.config.logger.debug "Calling API: DefaultApi.list_trends ..."
       end
       if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
-        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+        fail ArgumentError, 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
       end
       if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
-        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
-        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+        fail ArgumentError, 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
       end
       if opts[:'field'] && !['author.name', 'source.name', 'source.domain', 'keywords', 'entities.title.text', 'entities.title.type', 'entities.title.links.dbpedia', 'entities.body.text', 'entities.body.type', 'entities.body.links.dbpedia', 'hashtags', 'categories.id', 'sentiment.title.polarity', 'sentiment.body.polarity'].include?(opts[:'field'])
-        fail 'invalid value for "field", must be one of author.name, source.name, source.domain, keywords, entities.title.text, entities.title.type, entities.title.links.dbpedia, entities.body.text, entities.body.type, entities.body.links.dbpedia, hashtags, categories.id, sentiment.title.polarity, sentiment.body.polarity'
+        fail ArgumentError, 'invalid value for "field", must be one of author.name, source.name, source.domain, keywords, entities.title.text, entities.title.type, entities.title.links.dbpedia, entities.body.text, entities.body.type, entities.body.links.dbpedia, hashtags, categories.id, sentiment.title.polarity, sentiment.body.polarity'
       end
       # resource path
       local_var_path = "/trends".sub('{format}','json')
       # query parameters
       query_params = {}
-      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
-      query_params[:'title'] = opts[:'title'] if opts[:'title']
-      query_params[:'body'] = opts[:'body'] if opts[:'body']
-      query_params[:'text'] = opts[:'text'] if opts[:'text']
-      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
-      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
-      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
-      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
-      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
-      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
-      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
-      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
-      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
-      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
-      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
-      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
-      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
-      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
-      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
-      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
-      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
-      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
-      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
-      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
-      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
-      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
-      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
-      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
-      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
-      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
-      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
-      query_params[:'field'] = opts[:'field'] if opts[:'field']
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if !opts[:'id'].nil?
+      query_params[:'title'] = opts[:'title'] if !opts[:'title'].nil?
+      query_params[:'body'] = opts[:'body'] if !opts[:'body'].nil?
+      query_params[:'text'] = opts[:'text'] if !opts[:'text'].nil?
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if !opts[:'language'].nil?
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if !opts[:'published_at_start'].nil?
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if !opts[:'published_at_end'].nil?
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if !opts[:'categories_taxonomy'].nil?
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if !opts[:'categories_confident'].nil?
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if !opts[:'categories_id'].nil?
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if !opts[:'categories_level'].nil?
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if !opts[:'entities_title_text'].nil?
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if !opts[:'entities_title_type'].nil?
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if !opts[:'entities_title_links_dbpedia'].nil?
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if !opts[:'entities_body_text'].nil?
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if !opts[:'entities_body_type'].nil?
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if !opts[:'entities_body_links_dbpedia'].nil?
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
+      query_params[:'media.images.count.min'] = opts[:'media_images_count_min'] if !opts[:'media_images_count_min'].nil?
+      query_params[:'media.images.count.max'] = opts[:'media_images_count_max'] if !opts[:'media_images_count_max'].nil?
+      query_params[:'media.videos.count.min'] = opts[:'media_videos_count_min'] if !opts[:'media_videos_count_min'].nil?
+      query_params[:'media.videos.count.max'] = opts[:'media_videos_count_max'] if !opts[:'media_videos_count_max'].nil?
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if !opts[:'author_id'].nil?
+      query_params[:'author.name'] = opts[:'author_name'] if !opts[:'author_name'].nil?
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if !opts[:'source_id'].nil?
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if !opts[:'source_name'].nil?
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if !opts[:'source_domain'].nil?
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if !opts[:'source_locations_country'].nil?
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if !opts[:'source_locations_state'].nil?
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if !opts[:'source_locations_city'].nil?
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if !opts[:'source_scopes_country'].nil?
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if !opts[:'source_scopes_state'].nil?
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if !opts[:'source_scopes_city'].nil?
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if !opts[:'source_scopes_level'].nil?
+      query_params[:'field'] = opts[:'field'] if !opts[:'field'].nil?
       # header parameters
       header_params = {}
@@ -1160,7 +1226,7 @@ module AylienNewsApi
       # http body (model)
       post_body = nil
-            auth_names = ['app_key', 'app_id']
+      auth_names = ['app_key', 'app_id']
       data, status_code, headers = @api_client.call_api(:GET, local_var_path,
         :header_params => header_params,
         :query_params => query_params,