Quantcast

SodaHead.com Partner API Endpoints

In all instances, polls must have been created via telepicturestv sub-domain.

[active] poll(s) by id:
  • http://<partner>.sodahead.com/api/polls/<poll_id>/
  • http://<partner>.sodahead.com/api/polls/<poll_id>/<poll_id>/<poll_id>/.../
[active] poll(s) (by id) extensions (ex. geo-location):
  • http://<partner>.sodahead.com/api/polls/(<poll_id>/)*?ext=geo
  • @param ext: extensions (csv options: geo, geo-intl, geo-)
  • geo shows US per-state counts and the remainder under intl.
  • Where sessions do not have a state locality, counts are accumulated under an empty, "" state-key for the applicable country, if expanded to the state level.
  • Country codes are ISO 3166 (string).
  • State/province codes are ISO-3166-2 (string) for US/Canada and FIPS 10-4 (string) otherwise.
  • Answer ids and counts are uint32.
  • geo-intl shows per-country counts.
  • Where sessions do not have a country locality, counts are accumulated under the US key.
  • geo- shows that countries counts and the remainder under intl -- geo-us is synonymous and adheres to the rules of geo.
  • Where sessions do not have a country locality, counts are accumulated under the intl key.
[open] poll voting:
  • http://<partner>.sodahead.com/api/polls//vote/
  • @param answer: (POST) answer_id
  • @return poll and vote objects
[active] poll(s) (by faceted search)
  • http://<partner>.sodahead.com/api/polls/
  • @param site: (variadic) (int) site/affiliate/author id(s)
  • @param startdate: (UTC datetime) (int) start/activation datetime >= seconds since POSIX epoch
  • @param enddate: (UTC datetime) (int) end/close datetime <= seconds since POSIX epoch
  • @param keyword: (variadic) (str) keyword(s)
  • @param limit: items returned per page (default: 40; max: 1000)
  • @return next and prev [relative] uri(s)
  • Variadic parameters take a set of values under the same key; values are OR'd for each set.
[active] poll(s) by page:
  • http://<partner>.sodahead.com/api/polls/page/?index=/letsaskamerica/index.html
  • @param index: URI to an index
  • @return single poll
    • http://<partner>.sodahead.com/api/polls/page/?story=%2Fentertainment%2Ffunny-celeb-nickname%2F%3Ffoo%3Dbar%26wiz%3Dbang
    • @param story: URI to a story
    • @return list of poll(s), even if only a single index
    • URIs can be urlencoded / quoted