pollster 0.2.3 → 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c6eaa6fad77bf8e90e533e5ec269cc1701815808
+  data.tar.gz: 8c95537346a56210703d764613e6e592b3d3e279
+SHA512:
+  metadata.gz: 9866ecb3fbf43f9ecc0d67c9b5670feefd9be8da1f75639befe4b65c3d616964566c989af9b90cd5b94a2091e5a1e7e9c7ac8f053164597c6d42a76b47bdc407
+  data.tar.gz: 0d20b5802448d4658308581bf92b996aa7e2e405bb5064b7604da4abc6b190aa75d3169433c7e3b0eed6e79ddd9d8bb56e2c841f88b4b13e803e0ae2f4df3444

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2012, The Huffington Post
+Copyright (c) 2016, The Huffington Post
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -1,151 +1,108 @@
-          :::::::::   ::::::::  :::        :::        :::::::: ::::::::::: :::::::::: :::::::::    |                   ,*
-         :+:    :+: :+:    :+: :+:        :+:       :+:    :+:    :+:     :+:        :+:    :+:    |                 ,*
-        +:+    +:+ +:+    +:+ +:+        +:+       +:+           +:+     +:+        +:+    +:+     |             ,*,*
-       +#++:++#+  +#+    +:+ +#+        +#+       +#++:++#++    +#+     +#++:++#   +#++:++#:       |     ,*,   ,*
-      +#+        +#+    +#+ +#+        +#+              +#+    +#+     +#+        +#+    +#+       |   ,*   *,*
-     #+#        #+#    #+# #+#        #+#       #+#    #+#    #+#     #+#        #+#    #+#        | ,*
-    ###         ########  ########## ########## ########     ###     ########## ###    ###         |*
-                                                                                                    - - - - - - - - - - - 
-  
+# pollster
 
-A Ruby wrapper for the [Pollster API](http://elections.huffingtonpost.com/pollster/api) 
-which provides access to political opinion polling data and trend estimates from The Huffington Post.
+Pollster - the Ruby gem for the Pollster API
 
-The Pollster gem has been tested under Ruby 1.8.7, 1.9.2 and 1.9.3.
+Download election-related polling data from Pollster.
 
-## Installation
-
-    gem install pollster
-
-## Getting Started
-
-    require 'pollster'
-    include Pollster
+[HuffPost Pollster](https://elections.huffingtonpost.com/pollster) is a website that tracks public opinion. Pollster's editors enter polling data for the \"Questions\" they care about -- questions the public answers in \"Polls\".
 
-See the current estimate of the president's job approval
+The Pollster website is organized into \"Charts\" and Pollster-calculated trendlines (descriptions of how the public felt each day, based on the polls and public algorithms). Each Chart is based on a single Question.  The Pollster API provides every point plotted on all the \"Charts\" on the Pollster website. Furthermore, it provides the raw polling data that went into those charts: every response to every Question, at whichever level of detail the developer requests.
 
-    Chart.find('obama-job-approval').estimates
+This SDK was originally generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
-List charts about 2012 senate races
+- API version: 2.0.0
+- Package version: 2.0.0
+- Build package: class io.swagger.codegen.languages.RubyClientCodegen
 
-    Chart.where(:topic => '2012-senate')
+For more information, please visit [https://groups.google.com/forum/#!forum/pollster-users](https://groups.google.com/forum/#!forum/pollster-users)
 
-List charts about Wisconsin
-
-    Chart.where(:state => 'WI')
-
-Calculate the margin between Obama and Romney from a recent general election poll
-
-    poll = Poll.where(:chart => '2012-general-election-romney-vs-obama').first
-    responses = poll.questions.detect { |question| question.chart == '2012-general-election-romney-vs-obama' }.responses
-    obama = responses.detect { |response| response[:choice] == "Obama" }
-    romney = responses.detect { |response| response[:choice] == "Romney" }
-    obama[:value] - romney[:value]
+## Installation
 
-See the methodology used in recent polls about the Affordable Care Act
+In short: add `gem 'pollster', '~> 2.0.0'` to your Gemfile.
 
-    chart = Chart.find 'us-health-bill'
-    chart.polls.map { |poll| [poll.pollster, poll.method] }
+Full installation options:
 
-## Usage
+### Build a gem
 
-Pollster provides three classes:
+To build the Ruby code into a gem:
 
-    Pollster::Chart
+```shell
+gem build pollster.gemspec
+```
 
-represents the current estimates for a Pollster chart (e.g. [Romney vs. Obama](http://elections.huffingtonpost.com/pollster/2012-general-election-romney-vs-obama)).
+Then either install the gem locally:
 
-    Pollster::Poll
+```shell
+gem install ./pollster-2.0.0.gem
+```
+(for development, run `gem install --dev ./pollster-1.0.0.gem` to install the development dependencies)
 
-represents a specific poll conducted by a polling firm.
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
-    Pollster::Question
+Finally add this to the Gemfile:
 
-represents a question asked as part of a poll.
+    gem 'pollster', '~> 2.0.0'
 
-### Accessing data
+### Install from Git
 
-List all the charts available from Pollster:
+If the Ruby gem is hosted at a git repository: https://github.com/YOUR_GIT_USERNAME/YOUR_GIT_REPO, then add the following in the Gemfile:
 
-    >> Pollster::Chart.all
-    => [<Pollster::Chart: 2012 Iowa GOP Primary>,
-        <Pollster::Chart: 2012 New Hampshire GOP Primary>,
-        <Pollster::Chart: 2012 South Carolina GOP Primary>,
-        <Pollster::Chart: 2012 Florida GOP Primary>,
-        <Pollster::Chart: 2012 Nevada GOP Primary>,
-        ...]
+    gem 'pollster', :git => 'https://github.com/YOUR_GIT_USERNAME/YOUR_GIT_REPO.git'
 
-This response is not paginated; all charts will be returned.
+### Include the Ruby code directly
 
-A specific chart may be accessed using Pollster::Chart#find, giving the chart's slug as an argument:
+Include the Ruby code directly using `-I` as follows:
 
-    >> Pollster::Chart.find('2012-iowa-gop-primary')
-    => <Pollster::Chart: 2012 Iowa GOP Primary>
+```shell
+ruby -Ilib script.rb
+```
 
-All the charts for a topic or state may be accessed using Pollster::Chart#where:
+## Getting Started
 
-    >> Pollster::Chart.where(:state => 'MD')
-    => [<Pollster::Chart: 2012 Maryland GOP Primary>,
-        <Pollster::Chart: 2012 Maryland House: 6th District>,
-        <Pollster::Chart: 2012 Maryland President: Romney vs. Obama>]
+Please follow the [installation](#installation) procedure and then run the following code:
+```ruby
+# Load the gem
+require 'pollster'
 
-    >> Pollster::Chart.where(:topic => '2012-senate')
-    => [<Pollster::Chart: 2012 Massachusetts Senate: Brown vs Warren>,
-        <Pollster::Chart: 2012 Ohio Senate: Brown vs Mandel>,
-        <Pollster::Chart: 2012 Arizona Senate: Flake vs. Carmona>,
-        <Pollster::Chart: 2012 Florida Senate: Mack vs. Nelson>,
-        ...]
+api = Pollster::Api.new
 
-    >> Pollster::Chart.where(:topic => '2012-senate', :state => 'MA')
-    => [<Pollster::Chart: 2012 Massachusetts Senate: Brown vs Warren>]
+opts = { 
+  cursor: nil,                            # Special string to index into the Array
+  tags: "2016-president",                 # Comma-separated list of tag slugs
+  election_date: Date.parse("2013-10-20") # Date of an election
+}
 
-List the polls that were used to create the estimate for a specific chart:
+begin
+  result = api.charts_get(opts)
+  p result
+rescue Pollster::ApiError => e
+  puts "Exception when calling Api->charts_get: #{e}"
+end
 
-    >> chart = Pollster::Chart.find('2012-iowa-gop-primary')
-    >> chart.polls
-    => [#<Pollster::Poll:...
-        @start_date=#<Date: 2012-01-01 (4911855/2,0,2299161)>>,
-        @end_date=#<Date: 2012-01-01 (4911855/2,0,2299161)>,
-        @id=12385,
-        @method="Automated Phone",
-        @pollster="InsiderAdvantage",
-        @questions=
-         [{:name=>"2012 Iowa GOP Primary",
-           :chart=>"2012-iowa-gop-primary",
-           :topic=>"2012-gop-primary",
-           :state=>"IA",
-           :subpopulations=>
-            [{:name=>"Likely Voters",
-              :observations=>729,
-              :margin_of_error=>nil,
-              :responses=>
-               [{:choice=>"Romney", :value=>23},
-                {:choice=>"Bachmann", :value=>6},
-                {:choice=>"Gingrich", :value=>16},
-                {:choice=>"Huntsman", :value=>2},
-                {:choice=>"Paul", :value=>22},
-                {:choice=>"Perry", :value=>10},
-                {:choice=>"Santorum", :value=>18},
-                {:choice=>"Other", :value=>1},
-                {:choice=>"Undecided", :value=>2}]}]}],
-        @source= "http://www.realclearpolitics.com/docs/2012/InsiderAdvantage_Iowa_0102.pdf",
-        ...]
+```
 
+## API documentation
 
-You may also list all polls available through Pollster:
+Perhaps the best documentation is `example.rb`: it shows how to use all API
+endpoints and how to paginate.
 
-    >> Pollster::Poll.all
+See https://elections.huffingtonpost.com/pollster/api/v2/help for more details.
 
-This response is paginated, with 10 polls per page. To access subsequent pages, provide a page argument:
+See https://app.swaggerhub.com/api/huffpostdata/pollster-api/2.0.0 for full API
+documentation. The Ruby-specific warts:
 
-    >> Pollster::Poll.all(:page => 5)
+* For the TSV endpoints `questions/{slug}/poll-responses-clean.tsv` and
+  `charts/{slug}/pollster-chart-poll-questions.tsv`, the return values include a
+  `responses` Hash that maps from `label` (String) to `value` (Float).
+* Ruby API method names are snake-cased versions of the API endpoints and end
+  with `_get`. For example, the Ruby method to access
+  `questions/{slug}/poll-responses-clean.tsv` is
+  `api.questions_slug_poll_responses_clean_tsv_get(slug)`.
 
-## Authors
+## Author
 
-- Aaron Bycoffe, bycoffe@huffingtonpost.com
-- Jay Boice, jay.boice@huffingtonpost.com
-- Andrei Scheinkman, andrei@huffingtonpost.com
+Adam Hooper, adam.hooper@huffingtonpost.com.
 
 ## Copyright
 
-Copyright © 2012 The Huffington Post. See LICENSE for details.
+Copyright © 2016 The Huffington Post. See LICENSE for details.

data/example.rb

@@ -0,0 +1,128 @@
+#!/usr/bin/env ruby
+
+require 'pollster'
+
+api = Pollster::Api.new
+
+# GET /tags
+puts "GET /tags..."
+
+tags = api.tags_get()
+
+puts "  Found #{tags.count} tags"
+puts "  First tag: #{tags.first.slug} (#{tags.first.n_charts} charts)"
+
+# GET /charts
+puts "GET /charts..."
+
+charts = api.charts_get({
+  cursor: nil,                            # String | Special string to index into the Array
+  tags: "2016-president",                 # String | Comma-separated list of tag slugs
+  election_date: Date.parse("2016-11-08") # Date | Date of an election
+})
+
+puts "  Found #{charts.count} charts; our reults page has #{charts.items.length} charts"
+
+# GET /charts/:slug
+puts "GET /charts/:slug..."
+chart_slug = charts.items.first.slug
+puts "  First chart has slug `#{chart_slug}`"
+
+chart = api.charts_slug_get(chart_slug)
+
+puts "  Found chart `#{chart.slug}`"
+puts "  Tags: #{chart.tags.join(', ')}"
+puts "  Question: #{chart.question.slug}"
+puts "  Polls that answer Question: #{chart.question.n_polls}"
+
+# GET /polls, and pagination
+puts "GET /polls..."
+# Pick a question that has enough polls that we'll need to paginate
+question_slug = charts.items.find{ |c| c.question.n_polls > 30 }.question.slug
+
+polls = api.polls_get({
+  cursor: nil,
+  question: question_slug,
+  tags: nil,
+  sort: 'created_at'
+})
+
+puts "  Found #{polls.count} polls; our results page has #{polls.items.count} polls and begins with #{polls.items.first.slug}"
+puts "  next_cursor is #{polls.next_cursor}; using it in another GET request...."
+
+polls2 = api.polls_get({
+  cursor: polls.next_cursor,
+  question: question_slug,
+  tags: nil,
+  sort: 'created_at'
+})
+
+puts "  Got another #{polls2.items.count} polls, such as #{polls2.items.first.slug}"
+
+# GET /polls/:slug -- unnecessary here, since a Poll's data shows up in GET /polls
+puts "GET /polls/:slug..."
+poll_slug = polls.items.first.slug
+puts "  First poll has slug `#{poll_slug}`"
+
+poll = api.polls_slug_get(poll_slug)
+
+puts "  Found poll `#{poll.slug}`"
+puts "  Poll conducted from: #{poll.start_date} to: #{poll.end_date}, entered into Pollster: #{poll.created_at}"
+puts "  Questions: #{poll.poll_questions.length}"
+puts "  First question name: #{poll.poll_questions[0].question.name}"
+puts "  First question options: #{poll.poll_questions[0].question.responses.map(&:label).join(', ')}"
+puts "  First question first sample subpopulation: #{poll.poll_questions[0].sample_subpopulations[0].name}"
+puts "  First question responses: #{poll.poll_questions[0].sample_subpopulations[0].responses.map { |r| "#{r.text} (#{r.pollster_label}): #{r.value}" }.join('; ')}"
+
+# GET /charts/:slug/pollster-trendlines.tsv
+puts "GET /charts/:slug/pollster-trendlines.tsv..."
+
+trendlines = api.charts_slug_pollster_trendlines_tsv_get(chart_slug)
+
+puts "  Found #{trendlines.points.length} trendline points"
+first_label = chart.question.responses[0].label
+first_trendline = trendlines.by_label[first_label]
+puts "  Trendline for #{first_label} has #{first_trendline.length} points"
+puts "  Most recent points: #{first_trendline.last(5).map{ |p| "#{p.date.to_s}:#{p.value}" }.join(', ')}"
+
+# GET /charts/:slug/pollster-chart-poll-questions.tsv
+puts "GET /charts/:slug/pollster-chart-poll-questions.tsv..."
+
+chart_poll_questions = api.charts_slug_pollster_chart_poll_questions_tsv_get(chart_slug)
+
+puts "  Found #{chart_poll_questions.count} poll questions plotted on chart"
+puts "  Most recent poll: #{chart_poll_questions.first.poll_slug} (#{chart_poll_questions.first.start_date.to_s} to #{chart_poll_questions.first.end_date.to_s})"
+puts "  Responses (as plotted on the chart): #{chart_poll_questions.first.responses.map{ |k, v| "#{k} #{v}" }.join(', ')}"
+
+# GET /questions
+puts "GET /questions..."
+
+questions = api.questions_get({
+  cursor: nil,                            # String | Special string to index into the Array
+  tags: "2016-president",                 # String | Comma-separated list of tag slugs (most Questions are not tagged)
+  election_date: Date.parse("2016-11-08") # Date | Date of an election
+})
+
+puts "  Found #{questions.count} Questions matching request"
+puts "  First Question: #{questions.items.first.slug} (#{questions.items.first.name})"
+puts "  Responses Pollster tracks: #{questions.items.first.responses.map(&:label).join(", ")}"
+
+# GET /question/:slug/poll_responses_clean.tsv
+puts "GET /question/:slug/poll_responses_clean.tsv..."
+
+responses_clean = api.questions_slug_poll_responses_clean_tsv_get(question_slug)
+
+puts "  Found #{responses_clean.count} responses to Question #{question_slug}"
+puts "  Most recent poll: #{responses_clean.first.poll_slug} (#{responses_clean.first.start_date.to_s} to #{responses_clean.first.end_date.to_s})"
+puts "  Responses (as aggregated by Pollster): #{responses_clean.first.responses.map{ |k, v| "#{k} #{v}" }.join(', ')}"
+
+# GET /question/:slug/poll_responses_raw.tsv
+puts "GET /question/:slug/poll_responses_raw.tsv..."
+
+responses_raw = api.questions_slug_poll_responses_raw_tsv_get(question_slug)
+
+puts "  Found #{responses_raw.count} response data points to Question #{question_slug}"
+puts "  Most recent for label #{first_label}:"
+for r in responses_raw.select{ |r| r.pollster_label == first_label }.first(5)
+  puts "    #{r.poll_slug} on #{r.end_date.to_s}, prompting #{r.sample_subpopulation} for #{r.response_text}: #{r.value}"
+end

data/lib/pollster.rb

@@ -1,4 +1,46 @@
-require 'pollster/base'
-require 'pollster/chart'
-require 'pollster/poll'
-require 'pollster/question'
+# Common files
+require 'pollster/api_client'
+require 'pollster/api_error'
+require 'pollster/version'
+require 'pollster/configuration'
+
+# Models
+require 'pollster/models/chart'
+require 'pollster/models/chart_estimate'
+require 'pollster/models/chart_estimate_lowess_parameters'
+require 'pollster/models/chart_pollster_estimate_summary'
+require 'pollster/models/inline_response_200'
+require 'pollster/models/chart_pollster_trendlines'
+require 'pollster/models/pollster_chart_poll_questions'
+require 'pollster/models/question_poll_responses_clean'
+require 'pollster/models/question_poll_responses_raw'
+require 'pollster/models/inline_response_200_3'
+require 'pollster/models/inline_response_200_4'
+require 'pollster/models/poll'
+require 'pollster/models/poll_question'
+require 'pollster/models/poll_question_responses'
+require 'pollster/models/poll_question_sample_subpopulations'
+require 'pollster/models/question'
+require 'pollster/models/question_responses'
+require 'pollster/models/tag'
+
+# APIs
+require 'pollster/api'
+
+module Pollster
+  class << self
+    # Customize default settings for the SDK using block.
+    #   Pollster.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/pollster/api.rb

@@ -0,0 +1,655 @@
+require "uri"
+
+module Pollster
+  class Api
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+
+    # Charts
+    # Returns a list of Charts, ordered by creation date (newest first).  A Chart is chosen by Pollster editors. One example is \"Obama job approval - Democrats\". It is always based upon a single Question.  Users should strongly consider basing their analysis on Questions instead. Charts are derived data; Pollster editors publish them and change them as editorial priorities change. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of tag slugs. Only Charts with one or more of these tags and Charts based on Questions with one or more of these tags will be returned.
+    # @option opts [Date] :election_date Date of an election, in YYYY-MM-DD format. Only Charts based on Questions pertaining to an election on this date will be returned.
+    # @return [InlineResponse200]
+    def charts_get(opts = {})
+      data, _status_code, _headers = charts_get_with_http_info(opts)
+      return data
+    end
+
+    # Charts
+    # Returns a list of Charts, ordered by creation date (newest first).  A Chart is chosen by Pollster editors. One example is \"Obama job approval - Democrats\". It is always based upon a single Question.  Users should strongly consider basing their analysis on Questions instead. Charts are derived data; Pollster editors publish them and change them as editorial priorities change. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of tag slugs. Only Charts with one or more of these tags and Charts based on Questions with one or more of these tags will be returned.
+    # @option opts [Date] :election_date Date of an election, in YYYY-MM-DD format. Only Charts based on Questions pertaining to an election on this date will be returned.
+    # @return [Array<(InlineResponse200, Fixnum, Hash)>] InlineResponse200 data, response status code and response headers
+    def charts_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.charts_get ..."
+      end
+      # resource path
+      local_var_path = "/charts".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'tags'] = opts[:'tags'] if !opts[:'tags'].nil?
+      query_params[:'election_date'] = opts[:'election_date'] if !opts[:'election_date'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'InlineResponse200')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#charts_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Chart
+    # A Chart is chosen by Pollster editors. One example is \"Obama job approval - Democrats\". It is always based upon a single Question.  Users should strongly consider basing their analysis on Questions instead. Charts are derived data; Pollster editors publish them and change them as editorial priorities change. 
+    # @param slug Unique identifier for a Chart
+    # @param [Hash] opts the optional parameters
+    # @return [Chart]
+    def charts_slug_get(slug, opts = {})
+      data, _status_code, _headers = charts_slug_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # Chart
+    # A Chart is chosen by Pollster editors. One example is \&quot;Obama job approval - Democrats\&quot;. It is always based upon a single Question.  Users should strongly consider basing their analysis on Questions instead. Charts are derived data; Pollster editors publish them and change them as editorial priorities change. 
+    # @param slug Unique identifier for a Chart
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Chart, Fixnum, Hash)>] Chart data, response status code and response headers
+    def charts_slug_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.charts_slug_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.charts_slug_get" if slug.nil?
+      # resource path
+      local_var_path = "/charts/{slug}".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'Chart')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#charts_slug_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # One row per poll plotted on a Chart
+    # Derived data presented on a Pollster Chart.  Rules for which polls and responses are plotted on a chart can shift over time. Here are some examples of behaviors Pollster has used in the past:  * We've omitted \"Registered Voters\" from a chart when \"Likely Voters\"   responded to the same poll question. * We've omitted poll questions that asked about Gary Johnson on a   chart about Trump v Clinton. * We've omitted polls when their date ranges overlapped. * We've omitted labels (and their responses) for dark-horse   candidates.  In short: this endpoint is about Pollster, not the polls. For complete data, use a TSV from the Questions API.  The response follows the exact same format as `questions/{slug}/poll-responses-clean.tsv`, which you should strongly consider before settling on the Chart TSV. 
+    # @param slug Unique Chart identifier. For example: &#x60;obama-job-approval&#x60;
+    # @param [Hash] opts the optional parameters
+    # @return [PollsterChartPollQuestions]
+    def charts_slug_pollster_chart_poll_questions_tsv_get(slug, opts = {})
+      data, _status_code, _headers = charts_slug_pollster_chart_poll_questions_tsv_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # One row per poll plotted on a Chart
+    # Derived data presented on a Pollster Chart.  Rules for which polls and responses are plotted on a chart can shift over time. Here are some examples of behaviors Pollster has used in the past:  * We&#39;ve omitted \&quot;Registered Voters\&quot; from a chart when \&quot;Likely Voters\&quot;   responded to the same poll question. * We&#39;ve omitted poll questions that asked about Gary Johnson on a   chart about Trump v Clinton. * We&#39;ve omitted polls when their date ranges overlapped. * We&#39;ve omitted labels (and their responses) for dark-horse   candidates.  In short: this endpoint is about Pollster, not the polls. For complete data, use a TSV from the Questions API.  The response follows the exact same format as &#x60;questions/{slug}/poll-responses-clean.tsv&#x60;, which you should strongly consider before settling on the Chart TSV. 
+    # @param slug Unique Chart identifier. For example: &#x60;obama-job-approval&#x60;
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PollsterChartPollQuestions, Fixnum, Hash)>] PollsterChartPollQuestions data, response status code and response headers
+    def charts_slug_pollster_chart_poll_questions_tsv_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.charts_slug_pollster_chart_poll_questions_tsv_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.charts_slug_pollster_chart_poll_questions_tsv_get" if slug.nil?
+      # resource path
+      local_var_path = "/charts/{slug}/pollster-chart-poll-questions.tsv".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['text/tab-separated-values']
+      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 = []
+      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 = []
+      data, status_code, headers = @api_client.call_api_tsv(: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 => 'PollsterChartPollQuestions')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#charts_slug_pollster_chart_poll_questions_tsv_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Estimates of what the polls suggest about trends
+    # Derived data presented on a Pollster Chart.  The trendlines on a Pollster chart don't add up to 100: we calculate each label's trendline separately.  Use the `charts/{slug}` response's `chart.pollster_estimates[0].algorithm` to find the algorithm Pollster used to generate these estimates.  Pollster recalculates trendlines every time a new poll is entered. It also recalculates trendlines daily if they use the `bayesian-kallman` algorithm, because that algorithm's output changes depending on the end date. 
+    # @param slug Unique Chart identifier. For example: &#x60;obama-job-approval&#x60;
+    # @param [Hash] opts the optional parameters
+    # @return [ChartPollsterTrendlines]
+    def charts_slug_pollster_trendlines_tsv_get(slug, opts = {})
+      data, _status_code, _headers = charts_slug_pollster_trendlines_tsv_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # Estimates of what the polls suggest about trends
+    # Derived data presented on a Pollster Chart.  The trendlines on a Pollster chart don&#39;t add up to 100: we calculate each label&#39;s trendline separately.  Use the &#x60;charts/{slug}&#x60; response&#39;s &#x60;chart.pollster_estimates[0].algorithm&#x60; to find the algorithm Pollster used to generate these estimates.  Pollster recalculates trendlines every time a new poll is entered. It also recalculates trendlines daily if they use the &#x60;bayesian-kallman&#x60; algorithm, because that algorithm&#39;s output changes depending on the end date. 
+    # @param slug Unique Chart identifier. For example: &#x60;obama-job-approval&#x60;
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ChartPollsterTrendlines, Fixnum, Hash)>] ChartPollsterTrendlines data, response status code and response headers
+    def charts_slug_pollster_trendlines_tsv_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.charts_slug_pollster_trendlines_tsv_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.charts_slug_pollster_trendlines_tsv_get" if slug.nil?
+      # resource path
+      local_var_path = "/charts/{slug}/pollster-trendlines.tsv".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['text/tab-separated-values']
+      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 = []
+      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 = []
+      data, status_code, headers = @api_client.call_api_tsv(: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 => 'ChartPollsterTrendlines')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#charts_slug_pollster_trendlines_tsv_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Polls
+    # A Poll on Pollster is a collection of questions and responses published by a reputable survey house. This endpoint provides raw data from the survey house, plus Pollster-provided metadata about each question.  Pollster editors don't include every question when they enter Polls, and they don't necessarily enter every subpopulation for the responses they _do_ enter. They make editorial decisions about which questions belong in the database.  The response will contain a maximum of 25 Poll objects, even if the database contains more than 25 polls. Use the `next_cursor` parameter to fetch the rest, 25 Polls at a time. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of Question tag names; only Polls containing Questions with any of the given tags will be returned.
+    # @option opts [String] :question Question slug; only Polls that ask that Question will be returned.
+    # @option opts [String] :sort If &#x60;updated_at&#x60;, sort the most recently updated Poll first. (This can cause race conditions when used with &#x60;cursor&#x60;.) Otherwise, sort by most recently _entered_ Poll first. (default to created_at)
+    # @return [InlineResponse2003]
+    def polls_get(opts = {})
+      data, _status_code, _headers = polls_get_with_http_info(opts)
+      return data
+    end
+
+    # Polls
+    # A Poll on Pollster is a collection of questions and responses published by a reputable survey house. This endpoint provides raw data from the survey house, plus Pollster-provided metadata about each question.  Pollster editors don&#39;t include every question when they enter Polls, and they don&#39;t necessarily enter every subpopulation for the responses they _do_ enter. They make editorial decisions about which questions belong in the database.  The response will contain a maximum of 25 Poll objects, even if the database contains more than 25 polls. Use the &#x60;next_cursor&#x60; parameter to fetch the rest, 25 Polls at a time. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of Question tag names; only Polls containing Questions with any of the given tags will be returned.
+    # @option opts [String] :question Question slug; only Polls that ask that Question will be returned.
+    # @option opts [String] :sort If &#x60;updated_at&#x60;, sort the most recently updated Poll first. (This can cause race conditions when used with &#x60;cursor&#x60;.) Otherwise, sort by most recently _entered_ Poll first.
+    # @return [Array<(InlineResponse2003, Fixnum, Hash)>] InlineResponse2003 data, response status code and response headers
+    def polls_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.polls_get ..."
+      end
+      if opts[:'sort'] && !['created_at', 'updated_at'].include?(opts[:'sort'])
+        fail ArgumentError, 'invalid value for "sort", must be one of created_at, updated_at'
+      end
+      # resource path
+      local_var_path = "/polls".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'tags'] = opts[:'tags'] if !opts[:'tags'].nil?
+      query_params[:'question'] = opts[:'question'] if !opts[:'question'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'InlineResponse2003')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#polls_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Poll
+    # A Poll on Pollster is a collection of questions and responses published by a reputable survey house. This endpoint provides raw data from the survey house, plus Pollster-provided metadata about each question.  Pollster editors don't include every question when they enter Polls, and they don't necessarily enter every subpopulation for the responses they _do_ enter. They make editorial decisions about which questions belong in the database. 
+    # @param slug Unique Poll identifier. For example: &#x60;gallup-26892&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Poll]
+    def polls_slug_get(slug, opts = {})
+      data, _status_code, _headers = polls_slug_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # Poll
+    # A Poll on Pollster is a collection of questions and responses published by a reputable survey house. This endpoint provides raw data from the survey house, plus Pollster-provided metadata about each question.  Pollster editors don&#39;t include every question when they enter Polls, and they don&#39;t necessarily enter every subpopulation for the responses they _do_ enter. They make editorial decisions about which questions belong in the database. 
+    # @param slug Unique Poll identifier. For example: &#x60;gallup-26892&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Poll, Fixnum, Hash)>] Poll data, response status code and response headers
+    def polls_slug_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.polls_slug_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.polls_slug_get" if slug.nil?
+      # resource path
+      local_var_path = "/polls/{slug}".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'Poll')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#polls_slug_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Questions
+    # Returns a list of Questions.  A Question is chosen by Pollster editors. One example is \"Obama job approval\".  Different survey houses may publish varying phrasings (\"Do you approve or disapprove\" vs \"What do you think of the job\") and prompt readers with varying responses (one poll might have \"Approve\" and \"Disapprove\"; another poll might have \"Strongly approve\" and \"Somewhat approve\"). Those variations do not appear in this API endpoint. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of Question tag names. Only Questions with one or more of these tags will be returned.
+    # @option opts [Date] :election_date Date of an election, in YYYY-MM-DD format. Only Questions pertaining to an election on this date will be returned.
+    # @return [InlineResponse2004]
+    def questions_get(opts = {})
+      data, _status_code, _headers = questions_get_with_http_info(opts)
+      return data
+    end
+
+    # Questions
+    # Returns a list of Questions.  A Question is chosen by Pollster editors. One example is \&quot;Obama job approval\&quot;.  Different survey houses may publish varying phrasings (\&quot;Do you approve or disapprove\&quot; vs \&quot;What do you think of the job\&quot;) and prompt readers with varying responses (one poll might have \&quot;Approve\&quot; and \&quot;Disapprove\&quot;; another poll might have \&quot;Strongly approve\&quot; and \&quot;Somewhat approve\&quot;). Those variations do not appear in this API endpoint. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :cursor Special string to index into the Array
+    # @option opts [String] :tags Comma-separated list of Question tag names. Only Questions with one or more of these tags will be returned.
+    # @option opts [Date] :election_date Date of an election, in YYYY-MM-DD format. Only Questions pertaining to an election on this date will be returned.
+    # @return [Array<(InlineResponse2004, Fixnum, Hash)>] InlineResponse2004 data, response status code and response headers
+    def questions_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.questions_get ..."
+      end
+      # resource path
+      local_var_path = "/questions".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+      query_params[:'cursor'] = opts[:'cursor'] if !opts[:'cursor'].nil?
+      query_params[:'tags'] = opts[:'tags'] if !opts[:'tags'].nil?
+      query_params[:'election_date'] = opts[:'election_date'] if !opts[:'election_date'].nil?
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'InlineResponse2004')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#questions_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Question
+    # A Question is chosen by Pollster editors. One example is \"Obama job approval\".  Different survey houses may publish varying phrasings (\"Do you approve or disapprove\" vs \"What do you think of the job\") and prompt readers with varying responses (one poll might have \"Approve\" and \"Disapprove\"; another poll might have \"Strongly approve\" and \"Somewhat approve\"). Those variations do not appear in this API endpoint. 
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [Question]
+    def questions_slug_get(slug, opts = {})
+      data, _status_code, _headers = questions_slug_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # Question
+    # A Question is chosen by Pollster editors. One example is \&quot;Obama job approval\&quot;.  Different survey houses may publish varying phrasings (\&quot;Do you approve or disapprove\&quot; vs \&quot;What do you think of the job\&quot;) and prompt readers with varying responses (one poll might have \&quot;Approve\&quot; and \&quot;Disapprove\&quot;; another poll might have \&quot;Strongly approve\&quot; and \&quot;Somewhat approve\&quot;). Those variations do not appear in this API endpoint. 
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Question, Fixnum, Hash)>] Question data, response status code and response headers
+    def questions_slug_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.questions_slug_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.questions_slug_get" if slug.nil?
+      # resource path
+      local_var_path = "/questions/{slug}".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'Question')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#questions_slug_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # One row of response values per PollQuestion+Subpopulation concerning the given Question
+    # We include one TSV column per response label. See `questions/{slug}` for the Question's list of response labels, which are chosen by Pollster editors. Each row represents a single PollQuestion+Subpopulation. The value for each label column is the sum of the PollQuestion+Subpopulation responses that map to that `pollster_label`. For instance, on a hypothetical row, the `Approve` column might be the sum of that poll's `Strongly Approve` and `Somewhat Approve`. After the first TSV columns -- which are always response labels -- the next column will be `poll_slug`. `poll_slug` and subsequent columns are described in this API documentation. During the lifetime of a Question, Pollster editors may add, rename or reorder response labels. Such edits will change the TSV column headers. Column headers after `poll_slug` are never reordered or edited (but we may add new column headers). Sometimes a Poll may ask the same Question twice, leading to two similar rows with different values. Those rows will differ by `question_text` or by the set of response labels that have values.
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [QuestionPollResponsesClean]
+    def questions_slug_poll_responses_clean_tsv_get(slug, opts = {})
+      data, _status_code, _headers = questions_slug_poll_responses_clean_tsv_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # One row of response values per PollQuestion+Subpopulation concerning the given Question
+    # We include one TSV column per response label. See &#x60;questions/{slug}&#x60; for the Question&#39;s list of response labels, which are chosen by Pollster editors. Each row represents a single PollQuestion+Subpopulation. The value for each label column is the sum of the PollQuestion+Subpopulation responses that map to that &#x60;pollster_label&#x60;. For instance, on a hypothetical row, the &#x60;Approve&#x60; column might be the sum of that poll&#39;s &#x60;Strongly Approve&#x60; and &#x60;Somewhat Approve&#x60;. After the first TSV columns -- which are always response labels -- the next column will be &#x60;poll_slug&#x60;. &#x60;poll_slug&#x60; and subsequent columns are described in this API documentation. During the lifetime of a Question, Pollster editors may add, rename or reorder response labels. Such edits will change the TSV column headers. Column headers after &#x60;poll_slug&#x60; are never reordered or edited (but we may add new column headers). Sometimes a Poll may ask the same Question twice, leading to two similar rows with different values. Those rows will differ by &#x60;question_text&#x60; or by the set of response labels that have values.
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(QuestionPollResponsesClean, Fixnum, Hash)>] QuestionPollResponsesClean data, response status code and response headers
+    def questions_slug_poll_responses_clean_tsv_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.questions_slug_poll_responses_clean_tsv_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.questions_slug_poll_responses_clean_tsv_get" if slug.nil?
+      # resource path
+      local_var_path = "/questions/{slug}/poll-responses-clean.tsv".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['text/tab-separated-values']
+      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 = []
+      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 = []
+      data, status_code, headers = @api_client.call_api_tsv(: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 => 'QuestionPollResponsesClean')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#questions_slug_poll_responses_clean_tsv_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # One row per PollQuestion+Subpopulation+Response concerning the given Question (Large)
+    # Raw data from which we derived `poll-responses-clean.tsv`.  Each row represents a single PollQuestion+Subpopulation+Response. See the Poll API for a description of these terms.  Group results by `(poll_slug, subpopulation, question_text)`: that's how the survey houses group them.  This response can be several megabytes large. We encourage you to consider `poll-responses-clean.tsv` instead. 
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [QuestionPollResponsesRaw]
+    def questions_slug_poll_responses_raw_tsv_get(slug, opts = {})
+      data, _status_code, _headers = questions_slug_poll_responses_raw_tsv_get_with_http_info(slug, opts)
+      return data
+    end
+
+    # One row per PollQuestion+Subpopulation+Response concerning the given Question (Large)
+    # Raw data from which we derived &#x60;poll-responses-clean.tsv&#x60;.  Each row represents a single PollQuestion+Subpopulation+Response. See the Poll API for a description of these terms.  Group results by &#x60;(poll_slug, subpopulation, question_text)&#x60;: that&#39;s how the survey houses group them.  This response can be several megabytes large. We encourage you to consider &#x60;poll-responses-clean.tsv&#x60; instead. 
+    # @param slug Unique Question identifier. For example: &#x60;00c -Pres (44) Obama - Job Approval - National&#x60;. (Remember to URL-encode this parameter when querying.)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(QuestionPollResponsesRaw, Fixnum, Hash)>] QuestionPollResponsesRaw data, response status code and response headers
+    def questions_slug_poll_responses_raw_tsv_get_with_http_info(slug, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.questions_slug_poll_responses_raw_tsv_get ..."
+      end
+      # verify the required parameter 'slug' is set
+      fail ArgumentError, "Missing the required parameter 'slug' when calling Api.questions_slug_poll_responses_raw_tsv_get" if slug.nil?
+      # resource path
+      local_var_path = "/questions/{slug}/poll-responses-raw.tsv".sub('{format}','json').sub('{' + 'slug' + '}', slug.to_s)
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['text/tab-separated-values']
+      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 = []
+      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 = []
+      data, status_code, headers = @api_client.call_api_tsv(: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 => 'QuestionPollResponsesRaw')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#questions_slug_poll_responses_raw_tsv_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Tags
+    # Returns the list of Tags.  A Tag can apply to any number of Charts and Questions; Charts and Questions, in turn, can have any number of Tags.  Tags all look `like-this`: lowercase letters, numbers and hyphens. 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<Tag>]
+    def tags_get(opts = {})
+      data, _status_code, _headers = tags_get_with_http_info(opts)
+      return data
+    end
+
+    # Tags
+    # Returns the list of Tags.  A Tag can apply to any number of Charts and Questions; Charts and Questions, in turn, can have any number of Tags.  Tags all look &#x60;like-this&#x60;: lowercase letters, numbers and hyphens. 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Array<Tag>, Fixnum, Hash)>] Array<Tag> data, response status code and response headers
+    def tags_get_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "Calling API: Api.tags_get ..."
+      end
+      # resource path
+      local_var_path = "/tags".sub('{format}','json')
+
+      # query parameters
+      query_params = {}
+
+      # header parameters
+      header_params = {}
+
+      # HTTP header 'Accept' (if needed)
+      local_header_accept = ['application/json', 'application/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 = []
+      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 = []
+      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 => 'Array<Tag>')
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Api#tags_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end