aylien_news_api 4.3.0 → 5.0.0

data/docs/DeprecatedEntities.md

@@ -0,0 +1,19 @@
+# AylienNewsApi::DeprecatedEntities
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**body** | [**Array<DeprecatedEntity>**](DeprecatedEntity.md) | An array of extracted entities from the story body | [optional] 
+**title** | [**Array<DeprecatedEntity>**](DeprecatedEntity.md) | An array of extracted entities from the story title | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedEntities.new(body: null,
+                                 title: null)
+```
+
+

data/docs/DeprecatedEntity.md

@@ -0,0 +1,33 @@
+# AylienNewsApi::DeprecatedEntity
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** | The unique ID of the entity | [optional] 
+**indices** | **Array<Array<Integer>>** | The indices of the entity text | [optional] 
+**links** | [**EntityLinks**](EntityLinks.md) |  | [optional] 
+**text** | **String** | The entity text | [optional] 
+**stock_ticker** | **String** | The stock_ticker of the entity (might be null) | [optional] 
+**types** | **Array<String>** | An array of the entity types | [optional] 
+**sentiment** | [**EntitySentiment**](EntitySentiment.md) |  | [optional] 
+**surface_forms** | [**Array<DeprecatedEntitySurfaceForm>**](DeprecatedEntitySurfaceForm.md) |  | [optional] 
+**prominence_score** | **Float** | Describes how relevant an entity is to the article | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedEntity.new(id: null,
+                                 indices: null,
+                                 links: null,
+                                 text: null,
+                                 stock_ticker: null,
+                                 types: null,
+                                 sentiment: null,
+                                 surface_forms: null,
+                                 prominence_score: null)
+```
+
+

data/docs/DeprecatedEntitySurfaceForm.md

@@ -0,0 +1,21 @@
+# AylienNewsApi::DeprecatedEntitySurfaceForm
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**text** | **String** | The entity text | [optional] 
+**indices** | **Array<Array<Integer>>** | The indices of the entity text | [optional] 
+**frequency** | **Integer** | Amount of entity surface form mentions in the article | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedEntitySurfaceForm.new(text: null,
+                                 indices: null,
+                                 frequency: null)
+```
+
+

data/docs/DeprecatedRelatedStories.md

@@ -0,0 +1,27 @@
+# AylienNewsApi::DeprecatedRelatedStories
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**related_stories** | [**Array<DeprecatedStory>**](DeprecatedStory.md) | An array of related stories for the input story | [optional] 
+**story_body** | **String** | The input story body | [optional] 
+**story_language** | **String** | The input story language | [optional] 
+**story_title** | **String** | The input story title | [optional] 
+**published_at_end** | **DateTime** | The end of a period in which searched stories were published | [optional] 
+**published_at_start** | **DateTime** | The start of a period in which searched stories were published | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedRelatedStories.new(related_stories: null,
+                                 story_body: null,
+                                 story_language: null,
+                                 story_title: null,
+                                 published_at_end: null,
+                                 published_at_start: null)
+```
+
+

data/docs/DeprecatedStories.md

@@ -0,0 +1,25 @@
+# AylienNewsApi::DeprecatedStories
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**next_page_cursor** | **String** | The next page cursor | [optional] 
+**stories** | [**Array<DeprecatedStory>**](DeprecatedStory.md) | An array of stories | [optional] 
+**published_at_end** | **DateTime** | The end of a period in which searched stories were published | [optional] 
+**published_at_start** | **DateTime** | The start of a period in which searched stories were published | [optional] 
+**warnings** | [**Array<Warning>**](Warning.md) | Notifies about possible issues that occurred when searching for stories | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedStories.new(next_page_cursor: null,
+                                 stories: null,
+                                 published_at_end: null,
+                                 published_at_start: null,
+                                 warnings: null)
+```
+
+

data/docs/DeprecatedStory.md

@@ -0,0 +1,61 @@
+# AylienNewsApi::DeprecatedStory
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**author** | [**Author**](Author.md) |  | [optional] 
+**body** | **String** | Body of the story | [optional] 
+**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** | [**DeprecatedEntities**](DeprecatedEntities.md) |  | [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] 
+**language** | **String** | Language of the story | [optional] 
+**links** | [**StoryLinks**](StoryLinks.md) |  | [optional] 
+**media** | [**Array<Media>**](Media.md) | An array of extracted media such as images and videos | [optional] 
+**paragraphs_count** | **Integer** | Paragraph count of the story body | [optional] 
+**published_at** | **DateTime** | Published date of the story | [optional] 
+**sentences_count** | **Integer** | Sentence count of the story body | [optional] 
+**sentiment** | [**Sentiments**](Sentiments.md) |  | [optional] 
+**social_shares_count** | [**ShareCounts**](ShareCounts.md) |  | [optional] 
+**source** | [**Source**](Source.md) |  | [optional] 
+**summary** | [**Summary**](Summary.md) |  | [optional] 
+**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
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::DeprecatedStory.new(author: null,
+                                 body: null,
+                                 categories: null,
+                                 characters_count: null,
+                                 clusters: null,
+                                 entities: null,
+                                 hashtags: null,
+                                 id: null,
+                                 keywords: null,
+                                 language: null,
+                                 links: null,
+                                 media: null,
+                                 paragraphs_count: null,
+                                 published_at: null,
+                                 sentences_count: null,
+                                 sentiment: null,
+                                 social_shares_count: null,
+                                 source: null,
+                                 summary: null,
+                                 title: null,
+                                 translations: null,
+                                 words_count: null,
+                                 license_type: null)
+```
+
+

data/docs/Entity.md

@@ -5,13 +5,14 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **id** | **String** | The unique ID of the entity | [optional] 
-**indices** | **Array<Array<Integer>>** | The indices of the entity text | [optional] 
 **links** | [**EntityLinks**](EntityLinks.md) |  | [optional] 
-**text** | **String** | The entity text | [optional] 
-**stock_ticker** | **String** | The stock_ticker of the entity (might be null) | [optional] 
+**stock_tickers** | **Array<String>** | The stock tickers of the entity (might be empty) | [optional] 
 **types** | **Array<String>** | An array of the entity types | [optional] 
-**sentiment** | [**EntitySentiment**](EntitySentiment.md) |  | [optional] 
-**surface_forms** | [**Array<EntitySurfaceForm>**](EntitySurfaceForm.md) |  | [optional] 
+**overall_sentiment** | [**EntitySentiment**](EntitySentiment.md) |  | [optional] 
+**overall_prominence** | **Float** | Describes how relevant an entity is to the article | [optional] 
+**overall_frequency** | **Integer** | Amount of entity surface form mentions in the article | [optional] 
+**body** | [**EntityInText**](EntityInText.md) |  | [optional] 
+**title** | [**EntityInText**](EntityInText.md) |  | [optional] 
 
 ## Code Sample
 
@@ -19,13 +20,14 @@ Name | Type | Description | Notes
 require 'AylienNewsApi'
 
 instance = AylienNewsApi::Entity.new(id: null,
-                                 indices: null,
                                  links: null,
-                                 text: null,
-                                 stock_ticker: null,
+                                 stock_tickers: null,
                                  types: null,
-                                 sentiment: null,
-                                 surface_forms: null)
+                                 overall_sentiment: null,
+                                 overall_prominence: null,
+                                 overall_frequency: null,
+                                 body: null,
+                                 title: null)
 ```
 
 

data/docs/EntityInText.md

@@ -0,0 +1,19 @@
+# AylienNewsApi::EntityInText
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sentiment** | [**EntitySentiment**](EntitySentiment.md) |  | [optional] 
+**surface_forms** | [**Array<EntitySurfaceForm>**](EntitySurfaceForm.md) |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::EntityInText.new(sentiment: null,
+                                 surface_forms: null)
+```
+
+

data/docs/EntityMention.md

@@ -0,0 +1,19 @@
+# AylienNewsApi::EntityMention
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**index** | [**EntityMentionIndex**](EntityMentionIndex.md) |  | [optional] 
+**sentiment** | [**EntitySentiment**](EntitySentiment.md) |  | [optional] 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::EntityMention.new(index: null,
+                                 sentiment: null)
+```
+
+

data/docs/EntityMentionIndex.md

@@ -0,0 +1,19 @@
+# AylienNewsApi::EntityMentionIndex
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**start** | **Integer** | Start index of a single entity mention in the text (counting from 0) | 
+**_end** | **Integer** | End index of a single entity mention in the text (counting from 0) | 
+
+## Code Sample
+
+```ruby
+require 'AylienNewsApi'
+
+instance = AylienNewsApi::EntityMentionIndex.new(start: null,
+                                 _end: null)
+```
+
+

data/docs/EntitySurfaceForm.md

@@ -5,7 +5,8 @@
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **text** | **String** | The entity text | [optional] 
-**indices** | **Array<Array<Integer>>** | The indices of the entity text | [optional] 
+**frequency** | **Integer** | Amount of entity surface form mentions in the article | [optional] 
+**mentions** | [**Array<EntityMention>**](EntityMention.md) | Mentions of the entity text | [optional] 
 
 ## Code Sample
 
@@ -13,7 +14,8 @@ Name | Type | Description | Notes
 require 'AylienNewsApi'
 
 instance = AylienNewsApi::EntitySurfaceForm.new(text: null,
-                                 indices: null)
+                                 frequency: null,
+                                 mentions: null)
 ```
 
 

data/docs/Parameter.md

@@ -13,12 +13,12 @@ Name | Type | Description | Notes
 **categories_taxonomy** | [**Query**](Query.md) |  | [optional] 
 **clusters** | [**Query**](Query.md) |  | [optional] 
 **links_permalink** | [**Query**](Query.md) |  | [optional] 
-**entities_body_links_dbpedia** | [**Query**](Query.md) |  | [optional] 
-**entities_body_text** | [**Query**](Query.md) |  | [optional] 
-**entities_body_type** | [**Query**](Query.md) |  | [optional] 
-**entities_title_links_dbpedia** | [**Query**](Query.md) |  | [optional] 
-**entities_title_text** | [**Query**](Query.md) |  | [optional] 
-**entities_title_type** | [**Query**](Query.md) |  | [optional] 
+**entities_id** | [**Query**](Query.md) |  | [optional] 
+**entities_surface_forms_text** | [**Query**](Query.md) |  | [optional] 
+**entities_links_wikipedia** | [**Query**](Query.md) |  | [optional] 
+**entities_links_wikidata** | [**Query**](Query.md) |  | [optional] 
+**entities_title_surface_forms_text** | [**Query**](Query.md) |  | [optional] 
+**entities_body_surface_forms_text** | [**Query**](Query.md) |  | [optional] 
 **id** | [**Query**](Query.md) |  | [optional] 
 **language** | [**Query**](Query.md) |  | [optional] 
 **media_images_content_length_max** | [**Query**](Query.md) |  | [optional] 
@@ -75,12 +75,12 @@ instance = AylienNewsApi::Parameter.new(author_id: null,
                                  categories_taxonomy: null,
                                  clusters: null,
                                  links_permalink: null,
-                                 entities_body_links_dbpedia: null,
-                                 entities_body_text: null,
-                                 entities_body_type: null,
-                                 entities_title_links_dbpedia: null,
-                                 entities_title_text: null,
-                                 entities_title_type: null,
+                                 entities_id: null,
+                                 entities_surface_forms_text: null,
+                                 entities_links_wikipedia: null,
+                                 entities_links_wikidata: null,
+                                 entities_title_surface_forms_text: null,
+                                 entities_body_surface_forms_text: null,
                                  id: null,
                                  language: null,
                                  media_images_content_length_max: 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] 

data/lib/aylien_news_api.rb

@@ -3,7 +3,7 @@
 
 #The AYLIEN News API is the most powerful way of sourcing, searching and syndicating analyzed and enriched news content. It is accessed by sending HTTP requests to our server, which returns information to your client. 
 
-The version of the OpenAPI document: 3.0
+The version of the OpenAPI document: 5.0
 Contact: support@aylien.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.0.0-SNAPSHOT
@@ -26,9 +26,11 @@ 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/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'

data/lib/aylien_news_api/api/default_api.rb

@@ -3,7 +3,7 @@
 
 #The AYLIEN News API is the most powerful way of sourcing, searching and syndicating analyzed and enriched news content. It is accessed by sending HTTP requests to our server, which returns information to your client. 
 
-The version of the OpenAPI document: 3.0
+The version of the OpenAPI document: 5.0
 Contact: support@aylien.com
 Generated by: https://openapi-generator.tech
 OpenAPI Generator version: 5.0.0-SNAPSHOT
@@ -154,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
@@ -381,38 +381,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -467,6 +450,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. 
@@ -502,38 +488,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -588,6 +557,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. 
@@ -760,38 +732,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -846,6 +801,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?
@@ -907,38 +865,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -998,6 +939,9 @@ 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)
@@ -1030,38 +974,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -1121,6 +1048,9 @@ 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. 
@@ -1308,38 +1238,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -1399,6 +1312,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?
@@ -1459,38 +1375,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -1550,6 +1449,9 @@ 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)
@@ -1582,38 +1484,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -1673,6 +1558,9 @@ 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. 
@@ -1860,38 +1748,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -1951,6 +1822,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?
@@ -2013,38 +1887,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -2100,6 +1957,9 @@ 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 '*')
@@ -2135,38 +1995,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -2222,6 +2065,9 @@ 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). 
@@ -2410,38 +2256,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -2497,6 +2326,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?
@@ -2556,38 +2388,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -2642,6 +2457,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')
@@ -2672,38 +2490,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -2758,6 +2559,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). 
@@ -2921,38 +2725,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -3007,6 +2794,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?
@@ -3070,38 +2860,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -3156,6 +2929,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)
@@ -3188,38 +2964,21 @@ 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_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 entities &#x60;id&#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_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 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>] :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 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_stock_ticker This parameter is used to exclude stories based on the specified entities &#x60;stock_ticker&#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_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 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_wikipedia This parameter is used to exclude stories based on the specified entities Wikipedia 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_wikidata This parameter is used to find stories based on the specified entities Wikidata 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_wikidata This parameter is used to exclude stories based on the specified entities Wikidata 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_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 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>] :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>] :not_entities_body_surface_forms_text This parameter is used to exclude 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_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 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>] :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 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>] :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 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>] :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 [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>] :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 [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. 
@@ -3274,6 +3033,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
@@ -3284,7 +3046,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", "entities.title.sentiment", "entities.body.sentiment", "entities.sentiment", "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.body.surface_forms.text", "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
@@ -3448,38 +3210,21 @@ 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.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.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.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[:'entities_body_surface_forms_text'] if !opts[:'entities_body_surface_forms_text'].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?
@@ -3534,6 +3279,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] || {}