aylien_news_api 4.1.1 → 4.5.0

data/docs/Query.md

@@ -0,0 +1,31 @@
+# AylienNewsApi::Query
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**eq** | [**OneOfstringnumber**](OneOfstringnumber.md) |  | [optional] 
+**text** | [**OneOfstringnumber**](OneOfstringnumber.md) |  | [optional] 
+**_in** | [**Array<OneOfstringnumber>**](OneOfstringnumber.md) |  | [optional] 
+**gt** | **Float** |  | [optional] 
+**gte** | **Float** |  | [optional] 
+**lt** | **Float** |  | [optional] 
+**lte** | **Float** |  | [optional] 
+**boost** | **Float** |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::Query.new(eq: null,
+                                 text: null,
+                                 _in: null,
+                                 gt: null,
+                                 gte: null,
+                                 lt: null,
+                                 lte: null,
+                                 boost: null)
+```
+
+

data/docs/Story.md

@@ -9,7 +9,7 @@ Name | Type | Description | Notes
 **categories** | [**Array<Category>**](Category.md) | Suggested categories for the story | [optional] 
 **characters_count** | **Integer** | Character count of the story body | [optional] 
 **clusters** | **Array<Integer>** | An array of clusters the story is associated with | [optional] 
-**entities** | [**Entities**](Entities.md) |  | [optional] 
+**entities** | [**Array<Entity>**](Entity.md) | An array of entities | [optional] 
 **hashtags** | **Array<String>** | An array of suggested Story hashtags | [optional] 
 **id** | **Integer** | ID of the story which is a unique identification | [optional] 
 **keywords** | **Array<String>** | Extracted keywords mentioned in the story title or body | [optional] 
@@ -26,6 +26,7 @@ Name | Type | Description | Notes
 **title** | **String** | Title of the story | [optional] 
 **translations** | [**StoryTranslations**](StoryTranslations.md) |  | [optional] 
 **words_count** | **Integer** | Word count of the story body | [optional] 
+**license_type** | **Integer** | License type of the story | [optional] 
 
 ## Code Sample
 
@@ -53,7 +54,8 @@ instance = AylienNewsApi::Story.new(author: null,
                                  summary: null,
                                  title: null,
                                  translations: null,
-                                 words_count: null)
+                                 words_count: null,
+                                 license_type: null)
 ```
 
 

data/docs/TimeSeries.md

@@ -6,6 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **count** | **Integer** | The count of time series bin | [optional] 
 **published_at** | **DateTime** | The published date of the time series bin | [optional] 
+**sentiment** | [**AggregatedSentiment**](AggregatedSentiment.md) |  | [optional] 
 
 ## Code Sample
 
@@ -13,7 +14,8 @@ Name | Type | Description | Notes
 require 'AylienNewsApi'
 
 instance = AylienNewsApi::TimeSeries.new(count: null,
-                                 published_at: null)
+                                 published_at: null,
+                                 sentiment: null)
 ```
 
 

data/docs/Trend.md

@@ -6,6 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **count** | **Integer** | The count of the trend | [optional] 
 **value** | **String** | The value of the trend | [optional] 
+**sentiment** | [**AggregatedSentiment**](AggregatedSentiment.md) |  | [optional] 
 
 ## Code Sample
 
@@ -13,7 +14,8 @@ Name | Type | Description | Notes
 require 'AylienNewsApi'
 
 instance = AylienNewsApi::Trend.new(count: null,
-                                 value: null)
+                                 value: null,
+                                 sentiment: null)
 ```
 
 

data/lib/aylien_news_api.rb

@@ -17,6 +17,7 @@ require 'aylien_news_api/version'
 require 'aylien_news_api/configuration'
 
 # Models
+require 'aylien_news_api/models/aggregated_sentiment'
 require 'aylien_news_api/models/author'
 require 'aylien_news_api/models/autocomplete'
 require 'aylien_news_api/models/autocompletes'
@@ -25,18 +26,32 @@ require 'aylien_news_api/models/category_links'
 require 'aylien_news_api/models/category_taxonomy'
 require 'aylien_news_api/models/cluster'
 require 'aylien_news_api/models/clusters'
-require 'aylien_news_api/models/entities'
+require 'aylien_news_api/models/deprecated_entities'
+require 'aylien_news_api/models/deprecated_entity'
+require 'aylien_news_api/models/deprecated_entity_surface_form'
+require 'aylien_news_api/models/deprecated_related_stories'
+require 'aylien_news_api/models/deprecated_stories'
+require 'aylien_news_api/models/deprecated_story'
 require 'aylien_news_api/models/entity'
+require 'aylien_news_api/models/entity_in_text'
 require 'aylien_news_api/models/entity_links'
+require 'aylien_news_api/models/entity_mention'
+require 'aylien_news_api/models/entity_mention_index'
+require 'aylien_news_api/models/entity_sentiment'
+require 'aylien_news_api/models/entity_surface_form'
 require 'aylien_news_api/models/error'
 require 'aylien_news_api/models/error_links'
 require 'aylien_news_api/models/errors'
 require 'aylien_news_api/models/histogram_interval'
 require 'aylien_news_api/models/histograms'
 require 'aylien_news_api/models/location'
+require 'aylien_news_api/models/logicals'
 require 'aylien_news_api/models/media'
 require 'aylien_news_api/models/media_format'
 require 'aylien_news_api/models/media_type'
+require 'aylien_news_api/models/nested_entity'
+require 'aylien_news_api/models/parameter'
+require 'aylien_news_api/models/query'
 require 'aylien_news_api/models/rank'
 require 'aylien_news_api/models/rankings'
 require 'aylien_news_api/models/related_stories'

data/lib/aylien_news_api/api/default_api.rb

@@ -19,6 +19,111 @@ module AylienNewsApi
     def initialize(api_client = ApiClient.default)
       @api_client = api_client
     end
+    # List Stories
+    # The stories endpoint is used to return stories based on the json query you set in your request body. The News API crawler gathers articles in near real-time and stores information about them, or metadata. Below you can see all of the query parameters, and JSON schema for the body, which you can use to narrow down your query. 
+    # @param unknown_base_type [UNKNOWN_BASE_TYPE] /stories body schema to perform an advanced search with logical operators and nested objects. 
+    # @param [Hash] opts the optional parameters
+    # @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 [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 results. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results).  (default to 'published_at')
+    # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results).  (default to 'desc')
+    # @option opts [String] :cursor This parameter is used for finding a specific page. You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results).  (default to '*')
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results)  (default to 10)
+    # @return [OneOfStoriesDeprecatedStories]
+    def advanced_list_stories(unknown_base_type, opts = {})
+      data, _status_code, _headers = advanced_list_stories_with_http_info(unknown_base_type, opts)
+      data
+    end
+
+    # List Stories
+    # The stories endpoint is used to return stories based on the json query you set in your request body. The News API crawler gathers articles in near real-time and stores information about them, or metadata. Below you can see all of the query parameters, and JSON schema for the body, which you can use to narrow down your query. 
+    # @param unknown_base_type [UNKNOWN_BASE_TYPE] /stories body schema to perform an advanced search with logical operators and nested objects. 
+    # @param [Hash] opts the optional parameters
+    # @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 [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 results. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results). 
+    # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results). 
+    # @option opts [String] :cursor This parameter is used for finding a specific page. You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results). 
+    # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results) 
+    # @return [Array<(OneOfStoriesDeprecatedStories, Integer, Hash)>] OneOfStoriesDeprecatedStories data, response status code and response headers
+    def advanced_list_stories_with_http_info(unknown_base_type, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DefaultApi.advanced_list_stories ...'
+      end
+      # verify the required parameter 'unknown_base_type' is set
+      if @api_client.config.client_side_validation && unknown_base_type.nil?
+        fail ArgumentError, "Missing the required parameter 'unknown_base_type' when calling DefaultApi.advanced_list_stories"
+      end
+      allowable_values = ["id", "title", "body", "summary", "source", "author", "entities", "keywords", "hashtags", "characters_count", "words_count", "sentences_count", "paragraphs_count", "categories", "social_shares_count", "media", "sentiment", "language", "published_at", "links"]
+      if @api_client.config.client_side_validation && opts[:'_return'] && !opts[:'_return'].all? { |item| allowable_values.include?(item) }
+        fail ArgumentError, "invalid value for \"_return\", must include one of #{allowable_values}"
+      end
+      allowable_values = ["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", "source.links_in_count", "source.rankings.alexa.rank", "source.rankings.alexa.rank.AF", "source.rankings.alexa.rank.AX", "source.rankings.alexa.rank.AL", "source.rankings.alexa.rank.DZ", "source.rankings.alexa.rank.AS", "source.rankings.alexa.rank.AD", "source.rankings.alexa.rank.AO", "source.rankings.alexa.rank.AI", "source.rankings.alexa.rank.AQ", "source.rankings.alexa.rank.AG", "source.rankings.alexa.rank.AR", "source.rankings.alexa.rank.AM", "source.rankings.alexa.rank.AW", "source.rankings.alexa.rank.AU", "source.rankings.alexa.rank.AT", "source.rankings.alexa.rank.AZ", "source.rankings.alexa.rank.BS", "source.rankings.alexa.rank.BH", "source.rankings.alexa.rank.BD", "source.rankings.alexa.rank.BB", "source.rankings.alexa.rank.BY", "source.rankings.alexa.rank.BE", "source.rankings.alexa.rank.BZ", "source.rankings.alexa.rank.BJ", "source.rankings.alexa.rank.BM", "source.rankings.alexa.rank.BT", "source.rankings.alexa.rank.BO", "source.rankings.alexa.rank.BQ", "source.rankings.alexa.rank.BA", "source.rankings.alexa.rank.BW", "source.rankings.alexa.rank.BV", "source.rankings.alexa.rank.BR", "source.rankings.alexa.rank.IO", "source.rankings.alexa.rank.BN", "source.rankings.alexa.rank.BG", "source.rankings.alexa.rank.BF", "source.rankings.alexa.rank.BI", "source.rankings.alexa.rank.KH", "source.rankings.alexa.rank.CM", "source.rankings.alexa.rank.CA", "source.rankings.alexa.rank.CV", "source.rankings.alexa.rank.KY", "source.rankings.alexa.rank.CF", "source.rankings.alexa.rank.TD", "source.rankings.alexa.rank.CL", "source.rankings.alexa.rank.CN", "source.rankings.alexa.rank.CX", "source.rankings.alexa.rank.CC", "source.rankings.alexa.rank.CO", "source.rankings.alexa.rank.KM", "source.rankings.alexa.rank.CG", "source.rankings.alexa.rank.CD", "source.rankings.alexa.rank.CK", "source.rankings.alexa.rank.CR", "source.rankings.alexa.rank.CI", "source.rankings.alexa.rank.HR", "source.rankings.alexa.rank.CU", "source.rankings.alexa.rank.CW", "source.rankings.alexa.rank.CY", "source.rankings.alexa.rank.CZ", "source.rankings.alexa.rank.DK", "source.rankings.alexa.rank.DJ", "source.rankings.alexa.rank.DM", "source.rankings.alexa.rank.DO", "source.rankings.alexa.rank.EC", "source.rankings.alexa.rank.EG", "source.rankings.alexa.rank.SV", "source.rankings.alexa.rank.GQ", "source.rankings.alexa.rank.ER", "source.rankings.alexa.rank.EE", "source.rankings.alexa.rank.ET", "source.rankings.alexa.rank.FK", "source.rankings.alexa.rank.FO", "source.rankings.alexa.rank.FJ", "source.rankings.alexa.rank.FI", "source.rankings.alexa.rank.FR", "source.rankings.alexa.rank.GF", "source.rankings.alexa.rank.PF", "source.rankings.alexa.rank.TF", "source.rankings.alexa.rank.GA", "source.rankings.alexa.rank.GM", "source.rankings.alexa.rank.GE", "source.rankings.alexa.rank.DE", "source.rankings.alexa.rank.GH", "source.rankings.alexa.rank.GI", "source.rankings.alexa.rank.GR", "source.rankings.alexa.rank.GL", "source.rankings.alexa.rank.GD", "source.rankings.alexa.rank.GP", "source.rankings.alexa.rank.GU", "source.rankings.alexa.rank.GT", "source.rankings.alexa.rank.GG", "source.rankings.alexa.rank.GN", "source.rankings.alexa.rank.GW", "source.rankings.alexa.rank.GY", "source.rankings.alexa.rank.HT", "source.rankings.alexa.rank.HM", "source.rankings.alexa.rank.VA", "source.rankings.alexa.rank.HN", "source.rankings.alexa.rank.HK", "source.rankings.alexa.rank.HU", "source.rankings.alexa.rank.IS", "source.rankings.alexa.rank.IN", "source.rankings.alexa.rank.ID", "source.rankings.alexa.rank.IR", "source.rankings.alexa.rank.IQ", "source.rankings.alexa.rank.IE", "source.rankings.alexa.rank.IM", "source.rankings.alexa.rank.IL", "source.rankings.alexa.rank.IT", "source.rankings.alexa.rank.JM", "source.rankings.alexa.rank.JP", "source.rankings.alexa.rank.JE", "source.rankings.alexa.rank.JO", "source.rankings.alexa.rank.KZ", "source.rankings.alexa.rank.KE", "source.rankings.alexa.rank.KI", "source.rankings.alexa.rank.KP", "source.rankings.alexa.rank.KR", "source.rankings.alexa.rank.KW", "source.rankings.alexa.rank.KG", "source.rankings.alexa.rank.LA", "source.rankings.alexa.rank.LV", "source.rankings.alexa.rank.LB", "source.rankings.alexa.rank.LS", "source.rankings.alexa.rank.LR", "source.rankings.alexa.rank.LY", "source.rankings.alexa.rank.LI", "source.rankings.alexa.rank.LT", "source.rankings.alexa.rank.LU", "source.rankings.alexa.rank.MO", "source.rankings.alexa.rank.MK", "source.rankings.alexa.rank.MG", "source.rankings.alexa.rank.MW", "source.rankings.alexa.rank.MY", "source.rankings.alexa.rank.MV", "source.rankings.alexa.rank.ML", "source.rankings.alexa.rank.MT", "source.rankings.alexa.rank.MH", "source.rankings.alexa.rank.MQ", "source.rankings.alexa.rank.MR", "source.rankings.alexa.rank.MU", "source.rankings.alexa.rank.YT", "source.rankings.alexa.rank.MX", "source.rankings.alexa.rank.FM", "source.rankings.alexa.rank.MD", "source.rankings.alexa.rank.MC", "source.rankings.alexa.rank.MN", "source.rankings.alexa.rank.ME", "source.rankings.alexa.rank.MS", "source.rankings.alexa.rank.MA", "source.rankings.alexa.rank.MZ", "source.rankings.alexa.rank.MM", "source.rankings.alexa.rank.NA", "source.rankings.alexa.rank.NR", "source.rankings.alexa.rank.NP", "source.rankings.alexa.rank.NL", "source.rankings.alexa.rank.NC", "source.rankings.alexa.rank.NZ", "source.rankings.alexa.rank.NI", "source.rankings.alexa.rank.NE", "source.rankings.alexa.rank.NG", "source.rankings.alexa.rank.NU", "source.rankings.alexa.rank.NF", "source.rankings.alexa.rank.MP", "source.rankings.alexa.rank.NO", "source.rankings.alexa.rank.OM", "source.rankings.alexa.rank.PK", "source.rankings.alexa.rank.PW", "source.rankings.alexa.rank.PS", "source.rankings.alexa.rank.PA", "source.rankings.alexa.rank.PG", "source.rankings.alexa.rank.PY", "source.rankings.alexa.rank.PE", "source.rankings.alexa.rank.PH", "source.rankings.alexa.rank.PN", "source.rankings.alexa.rank.PL", "source.rankings.alexa.rank.PT", "source.rankings.alexa.rank.PR", "source.rankings.alexa.rank.QA", "source.rankings.alexa.rank.RE", "source.rankings.alexa.rank.RO", "source.rankings.alexa.rank.RU", "source.rankings.alexa.rank.RW", "source.rankings.alexa.rank.BL", "source.rankings.alexa.rank.SH", "source.rankings.alexa.rank.KN", "source.rankings.alexa.rank.LC", "source.rankings.alexa.rank.MF", "source.rankings.alexa.rank.PM", "source.rankings.alexa.rank.VC", "source.rankings.alexa.rank.WS", "source.rankings.alexa.rank.SM", "source.rankings.alexa.rank.ST", "source.rankings.alexa.rank.SA", "source.rankings.alexa.rank.SN", "source.rankings.alexa.rank.RS", "source.rankings.alexa.rank.SC", "source.rankings.alexa.rank.SL", "source.rankings.alexa.rank.SG", "source.rankings.alexa.rank.SX", "source.rankings.alexa.rank.SK", "source.rankings.alexa.rank.SI", "source.rankings.alexa.rank.SB", "source.rankings.alexa.rank.SO", "source.rankings.alexa.rank.ZA", "source.rankings.alexa.rank.GS", "source.rankings.alexa.rank.SS", "source.rankings.alexa.rank.ES", "source.rankings.alexa.rank.LK", "source.rankings.alexa.rank.SD", "source.rankings.alexa.rank.SR", "source.rankings.alexa.rank.SJ", "source.rankings.alexa.rank.SZ", "source.rankings.alexa.rank.SE", "source.rankings.alexa.rank.CH", "source.rankings.alexa.rank.SY", "source.rankings.alexa.rank.TW", "source.rankings.alexa.rank.TJ", "source.rankings.alexa.rank.TZ", "source.rankings.alexa.rank.TH", "source.rankings.alexa.rank.TL", "source.rankings.alexa.rank.TG", "source.rankings.alexa.rank.TK", "source.rankings.alexa.rank.TO", "source.rankings.alexa.rank.TT", "source.rankings.alexa.rank.TN", "source.rankings.alexa.rank.TR", "source.rankings.alexa.rank.TM", "source.rankings.alexa.rank.TC", "source.rankings.alexa.rank.TV", "source.rankings.alexa.rank.UG", "source.rankings.alexa.rank.UA", "source.rankings.alexa.rank.AE", "source.rankings.alexa.rank.GB", "source.rankings.alexa.rank.US", "source.rankings.alexa.rank.UM", "source.rankings.alexa.rank.UY", "source.rankings.alexa.rank.UZ", "source.rankings.alexa.rank.VU", "source.rankings.alexa.rank.VE", "source.rankings.alexa.rank.VN", "source.rankings.alexa.rank.VG", "source.rankings.alexa.rank.VI", "source.rankings.alexa.rank.WF", "source.rankings.alexa.rank.EH", "source.rankings.alexa.rank.YE", "source.rankings.alexa.rank.ZM", "source.rankings.alexa.rank.ZW"]
+      if @api_client.config.client_side_validation && opts[:'sort_by'] && !allowable_values.include?(opts[:'sort_by'])
+        fail ArgumentError, "invalid value for \"sort_by\", must be one of #{allowable_values}"
+      end
+      allowable_values = ["asc", "desc"]
+      if @api_client.config.client_side_validation && opts[:'sort_direction'] && !allowable_values.include?(opts[:'sort_direction'])
+        fail ArgumentError, "invalid value for \"sort_direction\", must be one of #{allowable_values}"
+      end
+      if @api_client.config.client_side_validation && !opts[:'per_page'].nil? && opts[:'per_page'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"per_page"]" when calling DefaultApi.advanced_list_stories, must be smaller than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && !opts[:'per_page'].nil? && opts[:'per_page'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"per_page"]" when calling DefaultApi.advanced_list_stories, must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/stories'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      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[:'return'] = opts[:'_return'] 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 = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'text/xml'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:body] || @api_client.object_to_http_body(unknown_base_type) 
+
+      # return_type
+      return_type = opts[:return_type] || 'OneOfStoriesDeprecatedStories' 
+
+      # auth_names
+      auth_names = opts[:auth_names] || ['app_id', 'app_key']
+
+      new_options = opts.merge(
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#advanced_list_stories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List autocompletes
     # The autocompletes endpoint a string of characters provided to it, and then returns suggested terms that are the most likely full words or strings. The terms returned by the News API are based on parameters the type parameters you can see below. For example, if you provide the autocompletes endpoint with the term `New York C` and select the type `dbpedia_resources`, the API will return links to the DBpedia resources `New_York_City`, `New_York_City_Subway`, `New_York_City_Police_Department`, and so on. 
     # @param type [String] This parameter is used for defining the type of autocompletes. 
@@ -49,7 +154,7 @@ module AylienNewsApi
         fail ArgumentError, "Missing the required parameter 'type' when calling DefaultApi.list_autocompletes"
       end
       # verify enum value
-      allowable_values = ["source_names", "source_domains", "entity_types", "dbpedia_resources"]
+      allowable_values = ["source_names", "source_domains", "entity_types", "dbpedia_resources", "aylien_entities_names", "aylien_entities_types"]
       if @api_client.config.client_side_validation && !allowable_values.include?(type)
         fail ArgumentError, "invalid value for \"type\", must be one of #{allowable_values}"
       end
@@ -276,18 +381,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -342,6 +478,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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. 
@@ -377,18 +516,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -443,6 +613,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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. 
@@ -615,18 +788,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -681,6 +885,9 @@ module AylienNewsApi
       query_params[:'social_shares_count.reddit.min'] = opts[:'social_shares_count_reddit_min'] if !opts[:'social_shares_count_reddit_min'].nil?
       query_params[:'social_shares_count.reddit.max'] = opts[:'social_shares_count_reddit_max'] if !opts[:'social_shares_count_reddit_max'].nil?
       query_params[:'clusters'] = opts[:'clusters'] if !opts[:'clusters'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].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?
@@ -742,18 +949,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -813,10 +1051,13 @@ module AylienNewsApi
     # @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] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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]
+    # @return [OneOfRelatedStoriesDeprecatedRelatedStories]
     def list_related_stories_get(opts = {})
       data, _status_code, _headers = list_related_stories_get_with_http_info(opts)
       data
@@ -845,18 +1086,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -916,10 +1188,13 @@ module AylienNewsApi
     # @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] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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, Integer, Hash)>] RelatedStories data, response status code and response headers
+    # @return [Array<(OneOfRelatedStoriesDeprecatedRelatedStories, Integer, Hash)>] OneOfRelatedStoriesDeprecatedRelatedStories data, response status code and response headers
     def list_related_stories_get_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: DefaultApi.list_related_stories_get ...'
@@ -1103,18 +1378,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -1174,6 +1480,9 @@ module AylienNewsApi
       query_params[:'story_url'] = opts[:'story_url'] if !opts[:'story_url'].nil?
       query_params[:'story_title'] = opts[:'story_title'] if !opts[:'story_title'].nil?
       query_params[:'story_body'] = opts[:'story_body'] if !opts[:'story_body'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
       query_params[:'boost_by'] = opts[:'boost_by'] if !opts[:'boost_by'].nil?
       query_params[:'story_language'] = opts[:'story_language'] if !opts[:'story_language'].nil?
       query_params[:'per_page'] = opts[:'per_page'] if !opts[:'per_page'].nil?
@@ -1190,7 +1499,7 @@ module AylienNewsApi
       post_body = opts[:body] 
 
       # return_type
-      return_type = opts[:return_type] || 'RelatedStories' 
+      return_type = opts[:return_type] || 'OneOfRelatedStoriesDeprecatedRelatedStories' 
 
       # auth_names
       auth_names = opts[:auth_names] || ['app_id', 'app_key']
@@ -1234,18 +1543,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -1305,10 +1645,13 @@ module AylienNewsApi
     # @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] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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]
+    # @return [OneOfRelatedStoriesDeprecatedRelatedStories]
     def list_related_stories_post(opts = {})
       data, _status_code, _headers = list_related_stories_post_with_http_info(opts)
       data
@@ -1337,18 +1680,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -1408,10 +1782,13 @@ module AylienNewsApi
     # @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] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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, Integer, Hash)>] RelatedStories data, response status code and response headers
+    # @return [Array<(OneOfRelatedStoriesDeprecatedRelatedStories, Integer, Hash)>] OneOfRelatedStoriesDeprecatedRelatedStories data, response status code and response headers
     def list_related_stories_post_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: DefaultApi.list_related_stories_post ...'
@@ -1595,18 +1972,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -1666,6 +2074,9 @@ module AylienNewsApi
       query_params[:'story_url'] = opts[:'story_url'] if !opts[:'story_url'].nil?
       query_params[:'story_title'] = opts[:'story_title'] if !opts[:'story_title'].nil?
       query_params[:'story_body'] = opts[:'story_body'] if !opts[:'story_body'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
       query_params[:'boost_by'] = opts[:'boost_by'] if !opts[:'boost_by'].nil?
       query_params[:'story_language'] = opts[:'story_language'] if !opts[:'story_language'].nil?
       query_params[:'per_page'] = opts[:'per_page'] if !opts[:'per_page'].nil?
@@ -1682,7 +2093,7 @@ module AylienNewsApi
       post_body = opts[:body] 
 
       # return_type
-      return_type = opts[:return_type] || 'RelatedStories' 
+      return_type = opts[:return_type] || 'OneOfRelatedStoriesDeprecatedRelatedStories' 
 
       # auth_names
       auth_names = opts[:auth_names] || ['app_id', 'app_key']
@@ -1728,18 +2139,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -1795,11 +2237,14 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @option opts [String] :sort_by This parameter is used for changing the order column of the results. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results).  (default to 'published_at')
     # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results).  (default to 'desc')
     # @option opts [String] :cursor This parameter is used for finding a specific page. You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results).  (default to '*')
     # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results)  (default to 10)
-    # @return [Stories]
+    # @return [OneOfStoriesDeprecatedStories]
     def list_stories(opts = {})
       data, _status_code, _headers = list_stories_with_http_info(opts)
       data
@@ -1830,18 +2275,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -1897,11 +2373,14 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
     # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @option opts [String] :sort_by This parameter is used for changing the order column of the results. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results). 
     # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. You can read about sorting results [here](https://newsapi.aylien.com/docs/sorting-results). 
     # @option opts [String] :cursor This parameter is used for finding a specific page. You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results). 
     # @option opts [Integer] :per_page This parameter is used for specifying number of items in each page You can read more about pagination of results [here](https://newsapi.aylien.com/docs/pagination-of-results) 
-    # @return [Array<(Stories, Integer, Hash)>] Stories data, response status code and response headers
+    # @return [Array<(OneOfStoriesDeprecatedStories, Integer, Hash)>] OneOfStoriesDeprecatedStories 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 ...'
@@ -2085,18 +2564,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -2152,6 +2662,9 @@ module AylienNewsApi
       query_params[:'social_shares_count.reddit.max'] = opts[:'social_shares_count_reddit_max'] if !opts[:'social_shares_count_reddit_max'].nil?
       query_params[:'clusters'] = opts[:'clusters'] if !opts[:'clusters'].nil?
       query_params[:'return'] = opts[:'_return'] if !opts[:'_return'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].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?
@@ -2169,7 +2682,7 @@ module AylienNewsApi
       post_body = opts[:body] 
 
       # return_type
-      return_type = opts[:return_type] || 'Stories' 
+      return_type = opts[:return_type] || 'OneOfStoriesDeprecatedStories' 
 
       # auth_names
       auth_names = opts[:auth_names] || ['app_id', 'app_key']
@@ -2211,18 +2724,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -2277,6 +2821,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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')
@@ -2307,18 +2854,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -2373,6 +2951,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @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). 
@@ -2536,18 +3117,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -2602,6 +3214,9 @@ module AylienNewsApi
       query_params[:'social_shares_count.reddit.min'] = opts[:'social_shares_count_reddit_min'] if !opts[:'social_shares_count_reddit_min'].nil?
       query_params[:'social_shares_count.reddit.max'] = opts[:'social_shares_count_reddit_max'] if !opts[:'social_shares_count_reddit_max'].nil?
       query_params[:'clusters'] = opts[:'clusters'] if !opts[:'clusters'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].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?
@@ -2665,18 +3280,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -2731,6 +3377,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query.  (default to 'text')
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @return [Trends]
     def list_trends(field, opts = {})
       data, _status_code, _headers = list_trends_with_http_info(field, opts)
@@ -2763,18 +3412,49 @@ module AylienNewsApi
     # @option opts [Array<String>] :not_categories_label This parameter is used for excluding stories by categories label. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
     # @option opts [Array<Integer>] :not_categories_level This parameter is used for excluding stories by categories level. You can read more about working with categories [here](https://newsapi.aylien.com/docs/working-with-categories). 
+    # @option opts [Array<String>] :entities_id This parameter is used to find stories based on the specified entities &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_types This parameter is used to find stories based on the specified entities &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_types This parameter is used to exclude stories based on the specified entity&#39;s &#x60;types&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_stock_tickers This parameter is used to find stories based on the specified entities &#x60;stock_tickers&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_tickers This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_tickers&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60;. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [String] :entities_title_surface_forms_text This parameter is used to find stories based on the specified entities &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_title_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in story titles. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_title_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_title_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the title of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_id This parameter is used to find stories based on the specified entities &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_id This parameter is used to exclude stories based on the specified entity&#39;s &#x60;id&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_surface_forms_text This parameter is used to exclude stories based on the specified entity&#39;s &#x60;surface_form&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_text This parameter is used to exclude stories based on the specified entities &#x60;text&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_type This parameter is used to exclude stories based on the specified entities &#x60;type&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_stock_ticker This parameter is used to find stories based on the specified entities &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_stock_ticker This parameter is used to exclude stories based on the specified entity&#39;s &#x60;stock_ticker&#x60; in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @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. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [Array<String>] :not_entities_body_links_dbpedia This parameter is used to exclude stories based on the specified entities dbpedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikipedia This parameter is used to find stories based on the specified entities wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikipedia This parameter is used to exclude stories based on the specified entity&#39;s Wikipedia URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :entities_body_links_wikidata This parameter is used to find stories based on the specified entities wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
+    # @option opts [Array<String>] :not_entities_body_links_wikidata This parameter is used to exclude stories based on the specified entity&#39;s Wikidata URL in the body of stories. You can read more about working with entities [here](https://newsapi.aylien.com/docs/working-with-entities). 
     # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value. 
     # @option opts [String] :not_sentiment_title_polarity This parameter is used for excluding 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. 
@@ -2829,6 +3509,9 @@ module AylienNewsApi
     # @option opts [Integer] :social_shares_count_reddit_min This parameter is used for finding stories whose Reddit social shares count is greater than or equal to the specified value. 
     # @option opts [Integer] :social_shares_count_reddit_max This parameter is used for finding stories whose Reddit social shares count is less than or equal to the specified value. 
     # @option opts [Array<String>] :clusters This parameter is used for finding stories with belonging to one of clusters in a specific set of clusters You can read more about working with clustering [here](https://newsapi.aylien.com/docs/working-with-clustering). 
+    # @option opts [String] :aql This parameter is used to supply a query in AYLIEN Query Language. 
+    # @option opts [String] :aql_default_field This parameter is used to supply an optional default field name used in the AQL query. 
+    # @option opts [String] :query This parameter is used to make an advanced query using $and, $or, $not logical operators and $eq for exact match, $text for a text search and $lt, $gt, $lte, $gte for range queries. value must be a json string. 
     # @return [Array<(Trends, Integer, Hash)>] Trends data, response status code and response headers
     def list_trends_with_http_info(field, opts = {})
       if @api_client.config.debugging
@@ -2839,7 +3522,7 @@ module AylienNewsApi
         fail ArgumentError, "Missing the required parameter 'field' when calling DefaultApi.list_trends"
       end
       # verify enum value
-      allowable_values = ["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", "clusters"]
+      allowable_values = ["author.name", "source.name", "source.domain", "keywords", "entities.id", "entities.surface_forms.text", "entities.links.wikipedia", "entities.links.wikidata", "entities.title.surface_forms.text", "entities.title.text", "entities.title.type", "entities.title.links.dbpedia", "entities.body.surface_forms.text", "entities.body.text", "entities.body.type", "entities.body.links.dbpedia", "hashtags", "categories.id", "sentiment.title.polarity", "sentiment.body.polarity", "clusters"]
       if @api_client.config.client_side_validation && !allowable_values.include?(field)
         fail ArgumentError, "invalid value for \"field\", must be one of #{allowable_values}"
       end
@@ -3003,18 +3686,49 @@ module AylienNewsApi
       query_params[:'!categories.label'] = opts[:'not_categories_label'] if !opts[:'not_categories_label'].nil?
       query_params[:'categories.level'] = opts[:'categories_level'] if !opts[:'categories_level'].nil?
       query_params[:'!categories.level'] = opts[:'not_categories_level'] if !opts[:'not_categories_level'].nil?
+      query_params[:'entities.id'] = opts[:'entities_id'] if !opts[:'entities_id'].nil?
+      query_params[:'!entities.id'] = opts[:'not_entities_id'] if !opts[:'not_entities_id'].nil?
+      query_params[:'entities.links.wikipedia'] = opts[:'entities_links_wikipedia'] if !opts[:'entities_links_wikipedia'].nil?
+      query_params[:'!entities.links.wikipedia'] = opts[:'not_entities_links_wikipedia'] if !opts[:'not_entities_links_wikipedia'].nil?
+      query_params[:'entities.links.wikidata'] = opts[:'entities_links_wikidata'] if !opts[:'entities_links_wikidata'].nil?
+      query_params[:'!entities.links.wikidata'] = opts[:'not_entities_links_wikidata'] if !opts[:'not_entities_links_wikidata'].nil?
+      query_params[:'entities.types'] = opts[:'entities_types'] if !opts[:'entities_types'].nil?
+      query_params[:'!entities.types'] = opts[:'not_entities_types'] if !opts[:'not_entities_types'].nil?
+      query_params[:'entities.stock_tickers'] = opts[:'entities_stock_tickers'] if !opts[:'entities_stock_tickers'].nil?
+      query_params[:'!entities.body.stock_tickers'] = opts[:'entities_body_stock_tickers'] if !opts[:'entities_body_stock_tickers'].nil?
+      query_params[:'entities.body.surface_forms.text'] = opts[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].nil?
+      query_params[:'!entities.surface_forms.text'] = opts[:'entities_surface_forms_text'] if !opts[:'entities_surface_forms_text'].nil?
+      query_params[:'entities.title.id'] = opts[:'entities_title_id'] if !opts[:'entities_title_id'].nil?
+      query_params[:'!entities.title.id'] = opts[:'not_entities_title_id'] if !opts[:'not_entities_title_id'].nil?
+      query_params[:'entities.title.surface_forms.text'] = opts[:'entities_title_surface_forms_text'] if !opts[:'entities_title_surface_forms_text'].nil?
+      query_params[:'!entities.title.surface_forms.text'] = opts[:'not_entities_title_surface_forms_text'] if !opts[:'not_entities_title_surface_forms_text'].nil?
       query_params[:'entities.title.text'] = opts[:'entities_title_text'] if !opts[:'entities_title_text'].nil?
       query_params[:'!entities.title.text'] = opts[:'not_entities_title_text'] if !opts[:'not_entities_title_text'].nil?
       query_params[:'entities.title.type'] = opts[:'entities_title_type'] if !opts[:'entities_title_type'].nil?
       query_params[:'!entities.title.type'] = opts[:'not_entities_title_type'] if !opts[:'not_entities_title_type'].nil?
+      query_params[:'entities.title.stock_ticker'] = opts[:'entities_title_stock_ticker'] if !opts[:'entities_title_stock_ticker'].nil?
+      query_params[:'!entities.title.stock_ticker'] = opts[:'not_entities_title_stock_ticker'] if !opts[:'not_entities_title_stock_ticker'].nil?
       query_params[:'entities.title.links.dbpedia'] = opts[:'entities_title_links_dbpedia'] if !opts[:'entities_title_links_dbpedia'].nil?
       query_params[:'!entities.title.links.dbpedia'] = opts[:'not_entities_title_links_dbpedia'] if !opts[:'not_entities_title_links_dbpedia'].nil?
+      query_params[:'entities.title.links.wikipedia'] = opts[:'entities_title_links_wikipedia'] if !opts[:'entities_title_links_wikipedia'].nil?
+      query_params[:'!entities.title.links.wikipedia'] = opts[:'not_entities_title_links_wikipedia'] if !opts[:'not_entities_title_links_wikipedia'].nil?
+      query_params[:'entities.title.links.wikidata'] = opts[:'entities_title_links_wikidata'] if !opts[:'entities_title_links_wikidata'].nil?
+      query_params[:'!entities.title.links.wikidata'] = opts[:'not_entities_title_links_wikidata'] if !opts[:'not_entities_title_links_wikidata'].nil?
+      query_params[:'entities.body.id'] = opts[:'entities_body_id'] if !opts[:'entities_body_id'].nil?
+      query_params[:'!entities.body.id'] = opts[:'not_entities_body_id'] if !opts[:'not_entities_body_id'].nil?
+      query_params[:'!entities.body.surface_forms.text'] = opts[:'not_entities_body_surface_forms_text'] if !opts[:'not_entities_body_surface_forms_text'].nil?
       query_params[:'entities.body.text'] = opts[:'entities_body_text'] if !opts[:'entities_body_text'].nil?
       query_params[:'!entities.body.text'] = opts[:'not_entities_body_text'] if !opts[:'not_entities_body_text'].nil?
       query_params[:'entities.body.type'] = opts[:'entities_body_type'] if !opts[:'entities_body_type'].nil?
       query_params[:'!entities.body.type'] = opts[:'not_entities_body_type'] if !opts[:'not_entities_body_type'].nil?
+      query_params[:'entities.body.stock_ticker'] = opts[:'entities_body_stock_ticker'] if !opts[:'entities_body_stock_ticker'].nil?
+      query_params[:'!entities.body.stock_ticker'] = opts[:'not_entities_body_stock_ticker'] if !opts[:'not_entities_body_stock_ticker'].nil?
       query_params[:'entities.body.links.dbpedia'] = opts[:'entities_body_links_dbpedia'] if !opts[:'entities_body_links_dbpedia'].nil?
       query_params[:'!entities.body.links.dbpedia'] = opts[:'not_entities_body_links_dbpedia'] if !opts[:'not_entities_body_links_dbpedia'].nil?
+      query_params[:'entities.body.links.wikipedia'] = opts[:'entities_body_links_wikipedia'] if !opts[:'entities_body_links_wikipedia'].nil?
+      query_params[:'!entities.body.links.wikipedia'] = opts[:'not_entities_body_links_wikipedia'] if !opts[:'not_entities_body_links_wikipedia'].nil?
+      query_params[:'entities.body.links.wikidata'] = opts[:'entities_body_links_wikidata'] if !opts[:'entities_body_links_wikidata'].nil?
+      query_params[:'!entities.body.links.wikidata'] = opts[:'not_entities_body_links_wikidata'] if !opts[:'not_entities_body_links_wikidata'].nil?
       query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if !opts[:'sentiment_title_polarity'].nil?
       query_params[:'!sentiment.title.polarity'] = opts[:'not_sentiment_title_polarity'] if !opts[:'not_sentiment_title_polarity'].nil?
       query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if !opts[:'sentiment_body_polarity'].nil?
@@ -3069,6 +3783,9 @@ module AylienNewsApi
       query_params[:'social_shares_count.reddit.min'] = opts[:'social_shares_count_reddit_min'] if !opts[:'social_shares_count_reddit_min'].nil?
       query_params[:'social_shares_count.reddit.max'] = opts[:'social_shares_count_reddit_max'] if !opts[:'social_shares_count_reddit_max'].nil?
       query_params[:'clusters'] = opts[:'clusters'] if !opts[:'clusters'].nil?
+      query_params[:'aql'] = opts[:'aql'] if !opts[:'aql'].nil?
+      query_params[:'aql_default_field'] = opts[:'aql_default_field'] if !opts[:'aql_default_field'].nil?
+      query_params[:'query'] = opts[:'query'] if !opts[:'query'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}