aylien_news_api 0.0.1

data/docs/Entities.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Entities
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**title** | [**Array<Entity>**](Entity.md) | An array of extracted entities from the story title | [optional] 
+**body** | [**Array<Entity>**](Entity.md) | An array of extracted entities from the story body | [optional] 
+
+

data/docs/Entity.md

@@ -0,0 +1,12 @@
+# AylienNewsApi::Entity
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**text** | **String** | The entity text | [optional] 
+**score** | **Float** | The entity score | [optional] 
+**types** | **Array<String>** | An array of the dbpedia types | [optional] 
+**links** | [**EntityLinks**](EntityLinks.md) | Related links to the entity | [optional] 
+**indices** | **Array<Array<Integer>>** | The indices of the entity text | [optional] 
+
+

data/docs/EntityLinks.md

@@ -0,0 +1,8 @@
+# AylienNewsApi::EntityLinks
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**dbpedia** | **String** | A dbpedia resource URL | [optional] 
+
+

data/docs/Error.md

@@ -0,0 +1,13 @@
+# AylienNewsApi::Error
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **String** |  | [optional] 
+**links** | [**ErrorLinks**](ErrorLinks.md) |  | [optional] 
+**status** | **String** |  | [optional] 
+**code** | **String** |  | [optional] 
+**title** | **String** |  | [optional] 
+**detail** | **String** |  | [optional] 
+
+

data/docs/ErrorLinks.md

@@ -0,0 +1,8 @@
+# AylienNewsApi::ErrorLinks
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**about** | **String** |  | [optional] 
+
+

data/docs/Errors.md

@@ -0,0 +1,8 @@
+# AylienNewsApi::Errors
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**errors** | [**Array<Error>**](Error.md) |  | [optional] 
+
+

data/docs/HistogramInterval.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::HistogramInterval
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**bin** | **Integer** | Histogram bin | [optional] 
+**count** | **Integer** | Histogram bin size | [optional] 
+
+

data/docs/Histograms.md

@@ -0,0 +1,12 @@
+# AylienNewsApi::Histograms
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**intervals** | [**Array<HistogramInterval>**](HistogramInterval.md) | The intervals of the histograms | [optional] 
+**interval_start** | **Integer** | The start interval of the histogram | [optional] 
+**interval_end** | **Integer** | The end interval of the histogram | [optional] 
+**interval_width** | **Integer** | The width of the histogram | [optional] 
+**field** | **String** |  | [optional] 
+
+

data/docs/Location.md

@@ -0,0 +1,10 @@
+# AylienNewsApi::Location
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**country** | **String** | The country code of the location. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes. | [optional] 
+**state** | **String** | The state of the location | [optional] 
+**city** | **String** | The city of the location | [optional] 
+
+

data/docs/Media.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Media
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**type** | **String** | Type of the media | [optional] 
+**url** | **String** | A URL which points to the media file | [optional] 
+
+

data/docs/RelatedStories.md

@@ -0,0 +1,11 @@
+# AylienNewsApi::RelatedStories
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**story_title** | **String** | The input story title | [optional] 
+**story_body** | **String** | The input story body | [optional] 
+**story_language** | **String** | The input story language | [optional] 
+**related_stories** | [**Array<Story>**](Story.md) | An array of related stories for the input story | [optional] 
+
+

data/docs/Scope.md

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

data/docs/Sentiment.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Sentiment
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**polarity** | **String** | Polarity of the sentiment | [optional] 
+**score** | **Float** | Polarity score of the sentiment | [optional] 
+
+

data/docs/Sentiments.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Sentiments
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**title** | [**Sentiment**](Sentiment.md) | The sentiment for the story title | [optional] 
+**body** | [**Sentiment**](Sentiment.md) | The sentiment for the story body | [optional] 
+
+

data/docs/ShareCount.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::ShareCount
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**count** | **Integer** | The number of shares | [optional] 
+**fetched_at** | **DateTime** | The fetched date of the shares | [optional] 
+
+

data/docs/ShareCounts.md

@@ -0,0 +1,11 @@
+# AylienNewsApi::ShareCounts
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**facebook** | [**Array<ShareCount>**](ShareCount.md) | Facebook shares count | [optional] 
+**google_plus** | [**Array<ShareCount>**](ShareCount.md) | Google Plus shares count | [optional] 
+**linkedin** | [**Array<ShareCount>**](ShareCount.md) | LinkedIn shares count | [optional] 
+**reddit** | [**Array<ShareCount>**](ShareCount.md) | Reddit shares count | [optional] 
+
+

data/docs/Source.md

@@ -0,0 +1,13 @@
+# AylienNewsApi::Source
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **Integer** | The source id which is a unique value | [optional] 
+**name** | **String** | The source name | [optional] 
+**domain** | **String** | Domain name of the source which is extracted from the source URL | [optional] 
+**logo_url** | **String** | A URL which points to the source logo | [optional] 
+**locations** | [**Array<Location>**](Location.md) | The source locations which are tend to be the physical locations of the source, e.g. BBC headquarter is located in London. | [optional] 
+**scopes** | [**Array<Scope>**](Scope.md) | The source scopes which is tend to be scope locations of the source, e.g. BBC scopes is international.  | [optional] 
+
+

data/docs/Stories.md

@@ -0,0 +1,10 @@
+# AylienNewsApi::Stories
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**stories** | [**Array<Story>**](Story.md) | An array of stories | [optional] 
+**clusters** | [**Array<StoryCluster>**](StoryCluster.md) | An array of clusters | [optional] 
+**next_page_cursor** | **String** | The next page cursor | [optional] 
+
+

data/docs/Story.md

@@ -0,0 +1,27 @@
+# AylienNewsApi::Story
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **Integer** | ID of the story which is unique identification | [optional] 
+**title** | **String** | Title of the story | [optional] 
+**body** | **String** | Body of the story | [optional] 
+**summary** | [**Summary**](Summary.md) | The suggested story summary | [optional] 
+**source** | [**Source**](Source.md) | The story source | [optional] 
+**author** | [**Author**](Author.md) | The story author | [optional] 
+**entities** | [**Entities**](Entities.md) | Extracted entities from the story title or body | [optional] 
+**keywords** | **Array<String>** | Extracted keywords mentioned in the story title or body | [optional] 
+**hashtags** | **Array<String>** | An array of suggested Story hashtags | [optional] 
+**characters_count** | **Integer** | Characters count of the story body | [optional] 
+**words_count** | **Integer** | Words count of the story body | [optional] 
+**sentences_count** | **Integer** | Sentences count of the story body | [optional] 
+**paragraphs_count** | **Integer** | Paragraphs count of the story body | [optional] 
+**categories** | [**Array<Category>**](Category.md) | Suggested categories for the story | [optional] 
+**social_shares_count** | [**ShareCounts**](ShareCounts.md) | Social shares count for the story | [optional] 
+**media** | [**Array<Media>**](Media.md) | An array of extracted media such as images and videos | [optional] 
+**sentiment** | [**Sentiments**](Sentiments.md) | Suggested sentiments for the story title or body | [optional] 
+**language** | **String** | Language of the story | [optional] 
+**published_at** | **DateTime** | Published date of the story | [optional] 
+**links** | [**StoryLinks**](StoryLinks.md) | Links which is related to the story | [optional] 
+
+

data/docs/StoryCluster.md

@@ -0,0 +1,12 @@
+# AylienNewsApi::StoryCluster
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **Integer** | A unique identification for the cluster | [optional] 
+**phrases** | **Array<String>** | Suggested labels for the cluster | [optional] 
+**size** | **Integer** | Size of the cluster | [optional] 
+**stories** | **Array<Integer>** | Story ids which are in the cluster | [optional] 
+**score** | **Float** | The cluster score | [optional] 
+
+

data/docs/StoryLinks.md

@@ -0,0 +1,10 @@
+# AylienNewsApi::StoryLinks
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**permalink** | **String** | The story permalink URL | [optional] 
+**related_stories** | **String** | The related stories URL | [optional] 
+**coverages** | **String** | The coverages URL | [optional] 
+
+

data/docs/Summary.md

@@ -0,0 +1,8 @@
+# AylienNewsApi::Summary
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**sentences** | **Array<String>** | An array of the suggested summary sentences | [optional] 
+
+

data/docs/TimeSeries.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::TimeSeries
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**published_at** | **DateTime** | The published date of the time series bin | [optional] 
+**count** | **Integer** | The count of time series bin | [optional] 
+
+

data/docs/TimeSeriesList.md

@@ -0,0 +1,11 @@
+# AylienNewsApi::TimeSeriesList
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**time_series** | [**Array<TimeSeries>**](TimeSeries.md) | An array of time series | [optional] 
+**period** | **String** | The size of each date range expressed as an interval to be added to the lower bound. | [optional] 
+**published_at_start** | **DateTime** | The start published date of the time series | [optional] 
+**published_at_end** | **DateTime** | The end published date of the time series | [optional] 
+
+

data/docs/Trend.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Trend
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**value** | **String** | The value of the trend | [optional] 
+**count** | **Integer** | The count of the trend | [optional] 
+
+

data/docs/Trends.md

@@ -0,0 +1,9 @@
+# AylienNewsApi::Trends
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**trends** | [**Array<Trend>**](Trend.md) | An array of trends | [optional] 
+**field** | **String** | The field of trends | [optional] 
+
+

data/lib/aylien_news_api.rb

@@ -0,0 +1,74 @@
+# Copyright 2016 Aylien, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common files
+require 'aylien_news_api/api_client'
+require 'aylien_news_api/api_error'
+require 'aylien_news_api/version'
+require 'aylien_news_api/configuration'
+
+# Models
+require 'aylien_news_api/models/author'
+require 'aylien_news_api/models/autocomplete'
+require 'aylien_news_api/models/autocompletes'
+require 'aylien_news_api/models/category'
+require 'aylien_news_api/models/category_links'
+require 'aylien_news_api/models/coverages'
+require 'aylien_news_api/models/entities'
+require 'aylien_news_api/models/entity'
+require 'aylien_news_api/models/entity_links'
+require 'aylien_news_api/models/error'
+require 'aylien_news_api/models/error_links'
+require 'aylien_news_api/models/errors'
+require 'aylien_news_api/models/histogram_interval'
+require 'aylien_news_api/models/histograms'
+require 'aylien_news_api/models/location'
+require 'aylien_news_api/models/media'
+require 'aylien_news_api/models/related_stories'
+require 'aylien_news_api/models/scope'
+require 'aylien_news_api/models/sentiment'
+require 'aylien_news_api/models/sentiments'
+require 'aylien_news_api/models/share_count'
+require 'aylien_news_api/models/share_counts'
+require 'aylien_news_api/models/source'
+require 'aylien_news_api/models/stories'
+require 'aylien_news_api/models/story'
+require 'aylien_news_api/models/story_cluster'
+require 'aylien_news_api/models/story_links'
+require 'aylien_news_api/models/summary'
+require 'aylien_news_api/models/time_series'
+require 'aylien_news_api/models/time_series_list'
+require 'aylien_news_api/models/trend'
+require 'aylien_news_api/models/trends'
+
+# APIs
+require 'aylien_news_api/api/default_api'
+
+module AylienNewsApi
+  class << self
+    # Customize default settings for the SDK using block.
+    #   AylienNewsApi.configure do |config|
+    #     config.username = "xxx"
+    #     config.password = "xxx"
+    #   end
+    # If no block given, return the default Configuration object.
+    def configure
+      if block_given?
+        yield(Configuration.default)
+      else
+        Configuration.default
+      end
+    end
+  end
+end

data/lib/aylien_news_api/api/default_api.rb

@@ -0,0 +1,1171 @@
+# Copyright 2016 Aylien, Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "uri"
+
+module AylienNewsApi
+  class DefaultApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # List autocompletes
+    # This endpoint is used for getting list of autocompletes by providing a specific term and type.
+    # @param type This parameter is used for defining the type of autocompletes.
+    # @param term This parameter is used for finding autocomplete objects whose contains the specified value.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :language This parameter is used for autocompletes whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to en)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @return [Autocompletes]
+    def list_autocompletes(type, term, opts = {})
+      data, _status_code, _headers = list_autocompletes_with_http_info(type, term, opts)
+      return data
+    end
+
+    # List autocompletes
+    # This endpoint is used for getting list of autocompletes by providing a specific term and type.
+    # @param type This parameter is used for defining the type of autocompletes.
+    # @param term This parameter is used for finding autocomplete objects whose contains the specified value.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :language This parameter is used for autocompletes whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @return [Array<(Autocompletes, Fixnum, Hash)>] Autocompletes data, response status code and response headers
+    def list_autocompletes_with_http_info(type, term, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_autocompletes ..."
+      end
+      
+      # verify the required parameter 'type' is set
+      fail "Missing the required parameter 'type' when calling list_autocompletes" if type.nil?
+      unless ['source_names', 'source_domains', 'entity_types', 'dbpedia_resources'].include?(type)
+        fail "invalid value for 'type', must be one of source_names, source_domains, entity_types, dbpedia_resources"
+      end
+      
+      # verify the required parameter 'term' is set
+      fail "Missing the required parameter 'term' when calling list_autocompletes" if term.nil?
+      
+      if opts[:'language'] && !['en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'language'])
+        fail 'invalid value for "language", must be one of en, de, fr, it, es, pt'
+      end
+      
+      # resource path
+      local_var_path = "/autocompletes".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'type'] = type
+      query_params[:'term'] = term
+      query_params[:'language'] = opts[:'language'] if opts[:'language']
+      query_params[:'per_page'] = opts[:'per_page'] if opts[:'per_page']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Autocompletes')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_autocompletes\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List coverages
+    # This endpoint is used for finding story coverages based on provided parameters. The number of coverages to return, up to a maximum of 100.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Integer] :story_id A story id
+    # @option opts [String] :story_url An article or webpage
+    # @option opts [String] :story_title Title of the article
+    # @option opts [String] :story_body Body of the article
+    # @option opts [DateTime] :story_published_at Publish date of the article. If you use url or title and body for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
+    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @return [Coverages]
+    def list_coverages(opts = {})
+      data, _status_code, _headers = list_coverages_with_http_info(opts)
+      return data
+    end
+
+    # List coverages
+    # This endpoint is used for finding story coverages based on provided parameters. The number of coverages to return, up to a maximum of 100.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Integer] :story_id A story id
+    # @option opts [String] :story_url An article or webpage
+    # @option opts [String] :story_title Title of the article
+    # @option opts [String] :story_body Body of the article
+    # @option opts [DateTime] :story_published_at Publish date of the article. If you use url or title and body for getting coverages, this parameter is required. The format used is a restricted form of the canonical representation of dateTime in the [XML Schema specification (ISO 8601)](https://www.w3.org/TR/xmlschema-2/#dateTime).
+    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @return [Array<(Coverages, Fixnum, Hash)>] Coverages data, response status code and response headers
+    def list_coverages_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_coverages ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'story_language'] && !['auto', 'en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'story_language'])
+        fail 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
+      end
+      
+      # resource path
+      local_var_path = "/coverages".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      form_params["title"] = opts[:'title'] if opts[:'title']
+      form_params["body"] = opts[:'body'] if opts[:'body']
+      form_params["text"] = opts[:'text'] if opts[:'text']
+      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      form_params["published_at.start"] = opts[:'published_at_start'] if opts[:'published_at_start']
+      form_params["published_at.end"] = opts[:'published_at_end'] if opts[:'published_at_end']
+      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      form_params["categories.confident"] = opts[:'categories_confident'] if opts[:'categories_confident']
+      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      form_params["author.name"] = opts[:'author_name'] if opts[:'author_name']
+      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      form_params["story_id"] = opts[:'story_id'] if opts[:'story_id']
+      form_params["story_url"] = opts[:'story_url'] if opts[:'story_url']
+      form_params["story_title"] = opts[:'story_title'] if opts[:'story_title']
+      form_params["story_body"] = opts[:'story_body'] if opts[:'story_body']
+      form_params["story_published_at"] = opts[:'story_published_at'] if opts[:'story_published_at']
+      form_params["story_language"] = opts[:'story_language'] if opts[:'story_language']
+      form_params["per_page"] = opts[:'per_page'] if opts[:'per_page']
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Coverages')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_coverages\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List histograms
+    # This endpoint is used for getting histograms based on the field parameter is passed.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [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.
+    # @option opts [String] :field This parameter is used for specifying the y-axis variable for the histogram. (default to social_shares_count)
+    # @return [Histograms]
+    def list_histograms(opts = {})
+      data, _status_code, _headers = list_histograms_with_http_info(opts)
+      return data
+    end
+
+    # List histograms
+    # This endpoint is used for getting histograms based on the field parameter is passed.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [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.
+    # @option opts [String] :field This parameter is used for specifying the y-axis variable for the histogram.
+    # @return [Array<(Histograms, Fixnum, Hash)>] Histograms data, response status code and response headers
+    def list_histograms_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_histograms ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'field'] && !['social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.reddit', 'social_shares_count.google_plus', 'characters_count', 'words_count', 'sentences_count', 'paragraphs_count'].include?(opts[:'field'])
+        fail 'invalid value for "field", must be one of social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.reddit, social_shares_count.google_plus, characters_count, words_count, sentences_count, paragraphs_count'
+      end
+      
+      # resource path
+      local_var_path = "/histograms".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      query_params[:'title'] = opts[:'title'] if opts[:'title']
+      query_params[:'body'] = opts[:'body'] if opts[:'body']
+      query_params[:'text'] = opts[:'text'] if opts[:'text']
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      query_params[:'interval.start'] = opts[:'interval_start'] if opts[:'interval_start']
+      query_params[:'interval.end'] = opts[:'interval_end'] if opts[:'interval_end']
+      query_params[:'interval.width'] = opts[:'interval_width'] if opts[:'interval_width']
+      query_params[:'field'] = opts[:'field'] if opts[:'field']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Histograms')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_histograms\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List related stories
+    # This endpoint is used for finding related stories based on provided parameters. The number of related stories to return, up to a maximum of 100.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Integer] :story_id A story id
+    # @option opts [String] :story_url An article or webpage
+    # @option opts [String] :story_title Title of the article
+    # @option opts [String] :story_body Body of the article
+    # @option opts [String] :boost_by This parameter is used for boosting result by the specified value.
+    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes. (default to auto)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 3)
+    # @return [RelatedStories]
+    def list_related_stories(opts = {})
+      data, _status_code, _headers = list_related_stories_with_http_info(opts)
+      return data
+    end
+
+    # List related stories
+    # This endpoint is used for finding related stories based on provided parameters. The number of related stories to return, up to a maximum of 100.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [Integer] :story_id A story id
+    # @option opts [String] :story_url An article or webpage
+    # @option opts [String] :story_title Title of the article
+    # @option opts [String] :story_body Body of the article
+    # @option opts [String] :boost_by This parameter is used for boosting result by the specified value.
+    # @option opts [String] :story_language This parameter is used for setting language of the story. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @return [Array<(RelatedStories, Fixnum, Hash)>] RelatedStories data, response status code and response headers
+    def list_related_stories_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_related_stories ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'boost_by'] && !['recency', 'popularity'].include?(opts[:'boost_by'])
+        fail 'invalid value for "boost_by", must be one of recency, popularity'
+      end
+      
+      if opts[:'story_language'] && !['auto', 'en', 'de', 'fr', 'it', 'es', 'pt'].include?(opts[:'story_language'])
+        fail 'invalid value for "story_language", must be one of auto, en, de, fr, it, es, pt'
+      end
+      
+      # resource path
+      local_var_path = "/related_stories".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+      form_params["id[]"] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      form_params["title"] = opts[:'title'] if opts[:'title']
+      form_params["body"] = opts[:'body'] if opts[:'body']
+      form_params["text"] = opts[:'text'] if opts[:'text']
+      form_params["language[]"] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      form_params["published_at.start"] = opts[:'published_at_start'] if opts[:'published_at_start']
+      form_params["published_at.end"] = opts[:'published_at_end'] if opts[:'published_at_end']
+      form_params["categories.taxonomy"] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      form_params["categories.confident"] = opts[:'categories_confident'] if opts[:'categories_confident']
+      form_params["categories.id[]"] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      form_params["categories.level[]"] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      form_params["entities.title.text[]"] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      form_params["entities.title.type[]"] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      form_params["entities.title.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      form_params["entities.body.text[]"] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      form_params["entities.body.type[]"] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      form_params["entities.body.links.dbpedia[]"] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      form_params["sentiment.title.polarity"] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      form_params["sentiment.body.polarity"] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      form_params["author.id[]"] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      form_params["author.name"] = opts[:'author_name'] if opts[:'author_name']
+      form_params["source.id[]"] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      form_params["source.name[]"] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      form_params["source.domain[]"] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      form_params["source.locations.country[]"] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      form_params["source.locations.state[]"] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      form_params["source.locations.city[]"] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      form_params["source.scopes.country[]"] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      form_params["source.scopes.state[]"] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      form_params["source.scopes.city[]"] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      form_params["source.scopes.level[]"] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      form_params["story_id"] = opts[:'story_id'] if opts[:'story_id']
+      form_params["story_url"] = opts[:'story_url'] if opts[:'story_url']
+      form_params["story_title"] = opts[:'story_title'] if opts[:'story_title']
+      form_params["story_body"] = opts[:'story_body'] if opts[:'story_body']
+      form_params["boost_by"] = opts[:'boost_by'] if opts[:'boost_by']
+      form_params["story_language"] = opts[:'story_language'] if opts[:'story_language']
+      form_params["per_page"] = opts[:'per_page'] if opts[:'per_page']
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'RelatedStories')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_related_stories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List Stories
+    # This endpoint is used for getting list of stories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories. (default to false)
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms. (default to lingo)
+    # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
+    # @option opts [String] :sort_by This parameter is used for changing the order column of the result. (default to published_at)
+    # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result. (default to desc)
+    # @option opts [String] :cursor This parameter is used for finding a specific page. (default to *)
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page. (default to 10)
+    # @return [Stories]
+    def list_stories(opts = {})
+      data, _status_code, _headers = list_stories_with_http_info(opts)
+      return data
+    end
+
+    # List Stories
+    # This endpoint is used for getting list of stories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [BOOLEAN] :cluster This parameter enables clustering for the returned stories.
+    # @option opts [String] :cluster_algorithm This parameter is used for specifying the clustering algorithm. It supprts STC, Lingo and [k-means](https://en.wikipedia.org/wiki/K-means_clustering) algorithms.
+    # @option opts [Array<String>] :_return This parameter is used for specifying return fields.
+    # @option opts [String] :sort_by This parameter is used for changing the order column of the result.
+    # @option opts [String] :sort_direction This parameter is used for changing the order direction of the result.
+    # @option opts [String] :cursor This parameter is used for finding a specific page.
+    # @option opts [Integer] :per_page This parameter is used for specifying number of the items in each page.
+    # @return [Array<(Stories, Fixnum, Hash)>] Stories data, response status code and response headers
+    def list_stories_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_stories ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'cluster_algorithm'] && !['stc', 'lingo', 'kmeans'].include?(opts[:'cluster_algorithm'])
+        fail 'invalid value for "cluster_algorithm", must be one of stc, lingo, kmeans'
+      end
+      
+      if opts[:'sort_by'] && !['relevance', 'recency', 'hotness', 'published_at', 'social_shares_count', 'social_shares_count.facebook', 'social_shares_count.linkedin', 'social_shares_count.google_plus', 'social_shares_count.reddit'].include?(opts[:'sort_by'])
+        fail 'invalid value for "sort_by", must be one of relevance, recency, hotness, published_at, social_shares_count, social_shares_count.facebook, social_shares_count.linkedin, social_shares_count.google_plus, social_shares_count.reddit'
+      end
+      
+      if opts[:'sort_direction'] && !['asc', 'desc'].include?(opts[:'sort_direction'])
+        fail 'invalid value for "sort_direction", must be one of asc, desc'
+      end
+      
+      # resource path
+      local_var_path = "/stories".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      query_params[:'title'] = opts[:'title'] if opts[:'title']
+      query_params[:'body'] = opts[:'body'] if opts[:'body']
+      query_params[:'text'] = opts[:'text'] if opts[:'text']
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      query_params[:'cluster'] = opts[:'cluster'] if opts[:'cluster']
+      query_params[:'cluster.algorithm'] = opts[:'cluster_algorithm'] if opts[:'cluster_algorithm']
+      query_params[:'return[]'] = @api_client.build_collection_param(opts[:'_return'], :multi) if opts[:'_return']
+      query_params[:'sort_by'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sort_direction'] = opts[:'sort_direction'] if opts[:'sort_direction']
+      query_params[:'cursor'] = opts[:'cursor'] if opts[:'cursor']
+      query_params[:'per_page'] = opts[:'per_page'] if opts[:'per_page']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Stories')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_stories\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List time series
+    # This endpoint is used for getting time series by stories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW-7DAYS/DAY)
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates). (default to NOW/DAY)
+    # @option opts [String] :period The size of each date range expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math). (default to +1DAY)
+    # @return [TimeSeriesList]
+    def list_time_series(opts = {})
+      data, _status_code, _headers = list_time_series_with_http_info(opts)
+      return data
+    end
+
+    # List time series
+    # This endpoint is used for getting time series by stories.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :period The size of each date range expressed as an interval to be added to the lower bound. It supports Date Math Syntax. Valid options are &#x60;+&#x60; following an integer number greater than 0 and one of the Date Math keywords. e.g. &#x60;+1DAY&#x60;, &#x60;+2MINUTES&#x60; and &#x60;+1MONTH&#x60;. Here are [Supported keywords](https://newsapi.aylien.com/docs/working-with-dates#date-math).
+    # @return [Array<(TimeSeriesList, Fixnum, Hash)>] TimeSeriesList data, response status code and response headers
+    def list_time_series_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_time_series ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      # resource path
+      local_var_path = "/time_series".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      query_params[:'title'] = opts[:'title'] if opts[:'title']
+      query_params[:'body'] = opts[:'body'] if opts[:'body']
+      query_params[:'text'] = opts[:'text'] if opts[:'text']
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
+      query_params[:'period'] = opts[:'period'] if opts[:'period']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'TimeSeriesList')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_time_series\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List trends
+    # This endpoint is used for finding news trendings based on stories resource.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident. (default to true)
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [String] :field This parameter is used to specify the trend field.
+    # @return [Trends]
+    def list_trends(opts = {})
+      data, _status_code, _headers = list_trends_with_http_info(opts)
+      return data
+    end
+
+    # List trends
+    # This endpoint is used for finding news trendings based on stories resource.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Array<Integer>] :id This parameter is used for finding stroies by story id.
+    # @option opts [String] :title This parameter is used for finding stories whose title contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :body This parameter is used for finding stories whose body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [String] :text This parameter is used for finding stories whose title or body contains a specfic keyword. It supports [boolean operators](https://newsapi.aylien.com/docs/boolean-operators).
+    # @option opts [Array<String>] :language This parameter is used for finding stories whose language is the specified value. It supports [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) language codes.
+    # @option opts [String] :published_at_start This parameter is used for finding stories whose published at is greater than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :published_at_end This parameter is used for finding stories whose published at is less than the specified value. [Here](https://newsapi.aylien.com/docs/working-with-dates) you can find more information about how [to work with dates](https://newsapi.aylien.com/docs/working-with-dates).
+    # @option opts [String] :categories_taxonomy This parameter is used for defining type of the taxonomy for the rest of categories queries.
+    # @option opts [BOOLEAN] :categories_confident This parameter is used for finding stories whose categories are confident.
+    # @option opts [Array<String>] :categories_id This parameter is used for finding stories whose categories id is the specified value.
+    # @option opts [Array<Integer>] :categories_level This parameter is used for finding stories whose categories level is the specified value.
+    # @option opts [Array<String>] :entities_title_text This parameter is used for finding stories whose entities text in title is the specified value.
+    # @option opts [Array<String>] :entities_title_type This parameter is used for finding stories whose entities type in title is the specified value.
+    # @option opts [Array<String>] :entities_title_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in title is the specified value.
+    # @option opts [Array<String>] :entities_body_text This parameter is used for finding stories whose entities text in body is the specified value.
+    # @option opts [Array<String>] :entities_body_type This parameter is used for finding stories whose entities type in body is the specified value.
+    # @option opts [Array<String>] :entities_body_links_dbpedia This parameter is used for finding stories whose entities dbpedia url in body is the specified value.
+    # @option opts [String] :sentiment_title_polarity This parameter is used for finding stories whose title sentiment is the specified value.
+    # @option opts [String] :sentiment_body_polarity This parameter is used for finding stories whose body sentiment is the specified value.
+    # @option opts [Array<Integer>] :author_id This parameter is used for finding stories whose author id is the specified value.
+    # @option opts [String] :author_name This parameter is used for finding stories whose author full name contains the specified value.
+    # @option opts [Array<Integer>] :source_id This parameter is used for finding stories whose source id is the specified value.
+    # @option opts [Array<String>] :source_name This parameter is used for finding stories whose source name contains the specified value.
+    # @option opts [Array<String>] :source_domain This parameter is used for finding stories whose source domain is the specified value.
+    # @option opts [Array<String>] :source_locations_country This parameter is used for finding stories whose source country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_locations_state This parameter is used for finding stories whose source state/province is the specified value.
+    # @option opts [Array<String>] :source_locations_city This parameter is used for finding stories whose source city is the specified value.
+    # @option opts [Array<String>] :source_scopes_country This parameter is used for finding stories whose source scopes country is the specified value. It supports [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country codes.
+    # @option opts [Array<String>] :source_scopes_state This parameter is used for finding stories whose source scopes state/province is the specified value.
+    # @option opts [Array<String>] :source_scopes_city This parameter is used for finding stories whose source scopes city is the specified value.
+    # @option opts [Array<String>] :source_scopes_level This parameter is used for finding stories whose source scopes level is the specified value.
+    # @option opts [String] :field This parameter is used to specify the trend field.
+    # @return [Array<(Trends, Fixnum, Hash)>] Trends data, response status code and response headers
+    def list_trends_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: DefaultApi#list_trends ..."
+      end
+      
+      if opts[:'categories_taxonomy'] && !['iab-qag', 'iptc-subjectcode'].include?(opts[:'categories_taxonomy'])
+        fail 'invalid value for "categories_taxonomy", must be one of iab-qag, iptc-subjectcode'
+      end
+      
+      if opts[:'sentiment_title_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_title_polarity'])
+        fail 'invalid value for "sentiment_title_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'sentiment_body_polarity'] && !['positive', 'neutral', 'negative'].include?(opts[:'sentiment_body_polarity'])
+        fail 'invalid value for "sentiment_body_polarity", must be one of positive, neutral, negative'
+      end
+      
+      if opts[:'field'] && !['author.name', 'source.name', 'source.domain', 'keywords', 'entities.title.text', 'entities.title.type', 'entities.title.links.dbpedia', 'entities.body.text', 'entities.body.type', 'entities.body.links.dbpedia', 'hashtags', 'categories.id', 'sentiment.title.polarity', 'sentiment.body.polarity'].include?(opts[:'field'])
+        fail 'invalid value for "field", must be one of author.name, source.name, source.domain, keywords, entities.title.text, entities.title.type, entities.title.links.dbpedia, entities.body.text, entities.body.type, entities.body.links.dbpedia, hashtags, categories.id, sentiment.title.polarity, sentiment.body.polarity'
+      end
+      
+      # resource path
+      local_var_path = "/trends".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'id[]'] = @api_client.build_collection_param(opts[:'id'], :multi) if opts[:'id']
+      query_params[:'title'] = opts[:'title'] if opts[:'title']
+      query_params[:'body'] = opts[:'body'] if opts[:'body']
+      query_params[:'text'] = opts[:'text'] if opts[:'text']
+      query_params[:'language[]'] = @api_client.build_collection_param(opts[:'language'], :multi) if opts[:'language']
+      query_params[:'published_at.start'] = opts[:'published_at_start'] if opts[:'published_at_start']
+      query_params[:'published_at.end'] = opts[:'published_at_end'] if opts[:'published_at_end']
+      query_params[:'categories.taxonomy'] = opts[:'categories_taxonomy'] if opts[:'categories_taxonomy']
+      query_params[:'categories.confident'] = opts[:'categories_confident'] if opts[:'categories_confident']
+      query_params[:'categories.id[]'] = @api_client.build_collection_param(opts[:'categories_id'], :multi) if opts[:'categories_id']
+      query_params[:'categories.level[]'] = @api_client.build_collection_param(opts[:'categories_level'], :multi) if opts[:'categories_level']
+      query_params[:'entities.title.text[]'] = @api_client.build_collection_param(opts[:'entities_title_text'], :multi) if opts[:'entities_title_text']
+      query_params[:'entities.title.type[]'] = @api_client.build_collection_param(opts[:'entities_title_type'], :multi) if opts[:'entities_title_type']
+      query_params[:'entities.title.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_title_links_dbpedia'], :multi) if opts[:'entities_title_links_dbpedia']
+      query_params[:'entities.body.text[]'] = @api_client.build_collection_param(opts[:'entities_body_text'], :multi) if opts[:'entities_body_text']
+      query_params[:'entities.body.type[]'] = @api_client.build_collection_param(opts[:'entities_body_type'], :multi) if opts[:'entities_body_type']
+      query_params[:'entities.body.links.dbpedia[]'] = @api_client.build_collection_param(opts[:'entities_body_links_dbpedia'], :multi) if opts[:'entities_body_links_dbpedia']
+      query_params[:'sentiment.title.polarity'] = opts[:'sentiment_title_polarity'] if opts[:'sentiment_title_polarity']
+      query_params[:'sentiment.body.polarity'] = opts[:'sentiment_body_polarity'] if opts[:'sentiment_body_polarity']
+      query_params[:'author.id[]'] = @api_client.build_collection_param(opts[:'author_id'], :multi) if opts[:'author_id']
+      query_params[:'author.name'] = opts[:'author_name'] if opts[:'author_name']
+      query_params[:'source.id[]'] = @api_client.build_collection_param(opts[:'source_id'], :multi) if opts[:'source_id']
+      query_params[:'source.name[]'] = @api_client.build_collection_param(opts[:'source_name'], :multi) if opts[:'source_name']
+      query_params[:'source.domain[]'] = @api_client.build_collection_param(opts[:'source_domain'], :multi) if opts[:'source_domain']
+      query_params[:'source.locations.country[]'] = @api_client.build_collection_param(opts[:'source_locations_country'], :multi) if opts[:'source_locations_country']
+      query_params[:'source.locations.state[]'] = @api_client.build_collection_param(opts[:'source_locations_state'], :multi) if opts[:'source_locations_state']
+      query_params[:'source.locations.city[]'] = @api_client.build_collection_param(opts[:'source_locations_city'], :multi) if opts[:'source_locations_city']
+      query_params[:'source.scopes.country[]'] = @api_client.build_collection_param(opts[:'source_scopes_country'], :multi) if opts[:'source_scopes_country']
+      query_params[:'source.scopes.state[]'] = @api_client.build_collection_param(opts[:'source_scopes_state'], :multi) if opts[:'source_scopes_state']
+      query_params[:'source.scopes.city[]'] = @api_client.build_collection_param(opts[:'source_scopes_city'], :multi) if opts[:'source_scopes_city']
+      query_params[:'source.scopes.level[]'] = @api_client.build_collection_param(opts[:'source_scopes_level'], :multi) if opts[:'source_scopes_level']
+      query_params[:'field'] = opts[:'field'] if opts[:'field']
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'text/xml']
+      local_header_accept_result = @api_client.select_header_accept(local_header_accept) and header_params['Accept'] = local_header_accept_result
+
+      # HTTP header 'Content-Type'
+      local_header_content_type = ['application/x-www-form-urlencoded']
+      header_params['Content-Type'] = @api_client.select_header_content_type(local_header_content_type)
+
+      # form parameters
+      form_params = {}
+
+      # http body (model)
+      post_body = nil
+            auth_names = ['app_key', 'app_id']
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => 'Trends')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DefaultApi#list_trends\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end