google_custom_search_api 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+rdoc/*
+*.gem
+.bundle

data/CHANGELOG.rdoc

@@ -0,0 +1,2 @@
+= Changelog
+

data/Gemfile.lock

@@ -0,0 +1,38 @@
+PATH
+  remote: .
+  specs:
+    google_custom_search_api (0.0.1)
+      httparty
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    addressable (2.2.7)
+    crack (0.3.1)
+    diff-lcs (1.1.3)
+    httparty (0.8.1)
+      multi_json
+      multi_xml
+    json (1.6.5)
+    multi_json (1.1.0)
+    multi_xml (0.4.2)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+    webmock (1.8.3)
+      addressable (>= 2.2.7)
+      crack (>= 0.1.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  google_custom_search_api!
+  json
+  rspec
+  webmock

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Ben Wiseley
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,126 @@
+# Google Custom Search
+
+This project is a Ruby lib for Google's Custom Search ENgine API (http://www.google.com/cse).  There seem to be quite a few cse libs out there that don't work so I rolled this up quickly.
+
+Questions/comments, etc: wiseleyb@gmail.com
+
+## Install
+
+Add to your Gemfile:
+
+  gem "google_custom_search_api"
+
+then
+
+  bundle install
+
+## Configure
+
+You need to configure ```GOOGLE_SEARCH_CX``` and ```GOOGLE_API_KEY``` to ```config/initializers/google_cse_api.rb```:
+
+```
+  GOOGLE_API_KEY = "..."
+  GOOGLE_SEARCH_CX = "..."
+```
+You can get your ```GOOGLE_API_KEY``` from https://code.google.com/apis/console/b/0/?pli=1 - There are many choices - Simple API Access is probably what you want.  There are more elaborate authorization schemes available for Google services but those aren't currently implemented.
+
+You can get your ```GOOGLE_SEARCH_CX``` from http://www.google.com/cse/  Either create a custom engine or follow ```manage your existing search engines``` and go to your cse's Control panel.  ```GOOGLE_SEARCH_CX``` == ```Search engine unique ID```
+
+### Searching the web, not just your site, with CSE
+
+Google CSE was set up so search specific sites.  To search the entire web simply go to http://www.google.com/cse/, find your CSE, go to it's control panel.
+
+* in ```Basics``` under ```Search Preferences``` choose ```Search the entire web but emphasize included sites.```
+* in ```Sites``` add ```www.google.com```
+
+## Use
+
+To perform a search:
+
+```
+  results = GoogleCustomSearchApi.search("poker")
+```
+Results now contains a raw version and a class'ed version of the data show in ```Sample results``` below.
+
+This means you can do:
+
+```
+  results["items"].each do |item|
+  	puts item["title"], item["link"]
+  end
+```
+
+or
+
+```
+  results.items.each do |item|
+    puts item.title, item.link
+  end
+```
+
+See [Custom Search](http://code.google.com/apis/customsearch/v1/using_rest.html) documentation for an explanation of all fields available.
+
+### Paging
+
+By default CSE returns a maximum of 10 results at a time, you can't get more results without paging. BTW if you want fewer results just pass in the :num => 1-10 option when searching.
+
+To do paging we pass in the :start option.  Example:
+
+```
+  results = GoogleCustomSearchApi.search("poker", :start => 1)
+```
+
+The maximum number of pages CSE allows is 10 - or 100 results in total.  To walk through the pages you can use :start => 1, :start => 11, etc. Or you can use the results to find the next value, like so:
+
+```
+  start = 1
+  begin
+    results = GoogleCustomSearchApi.search("poker",:start => start)
+    if results.queries.keys.include?("nextPage")
+      start = results.queries.nextPage.first.startIndex
+    else
+      start = nil
+    end
+  end while start.nil? == false
+```
+
+If you just want all results you can use the method ```search_and_return_all_results(query, opts = {})``` works just like the normal search but iterates through all available results and puts them in an array.
+
+### Encoding issues
+
+TODO - this section needs work
+
+CSE will return non utf-8 results which can be problematic.  I might add in a config value that you can explicitly set encoding.  Until then a work around is doing stuff like:
+
+```
+  results.items.first.title.force_encoding(Encoding::UTF_8)
+```
+
+More on this here: http://code.google.com/apis/customsearch/docs/ref_encoding.html
+
+## Contributing - Running tests
+
+Pull requests welcome.
+
+To run tests
+```
+  git clone git@github.com:wiseleyb/google_custom_search_api.git
+  cd google_custom_search_api
+  bundle install
+  bundle exec rspec spec
+```
+
+## Credits
+* Based largely on the gem https://github.com/alexreisner/google_custom_search 
+* Awesome ResponseData class from https://github.com/mikedemers/rbing
+* Work done while working on a project for the company http://reInteractive.net in sunny Sydney.  A great ruby shop should you need help with something.
+
+## TODO
+* pretty light on the tests
+
+## Sample results
+
+See spec/fixtures/*.json for examples of data returned
+
+
+Copyright (c) 2012 Ben Wiseley, released under the MIT license

data/Rakefile

@@ -0,0 +1,19 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "Google Custom Search API #{GoogleCustomSearch::VERSION}"
+  rdoc.rdoc_files.include('*.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/lib/google_custom_search_api.rb

@@ -0,0 +1,107 @@
+##
+# Add search functionality (via Google Custom Search). Protocol reference at:
+# http://www.google.com/coop/docs/cse/resultsxml.html
+#
+module GoogleCustomSearchApi
+  extend self
+  
+  ##
+  # Search the site.
+  #
+  # opts 
+  #   see list here for valid options http://code.google.com/apis/customsearch/v1/using_rest.html#query-params
+  def search(query, opts = {})
+    # Get and parse results.
+    url = url(query, opts)
+    puts url
+    return nil unless results = fetch(url)
+    results["items"] ||= []
+    ResponseData.new(results)
+  end
+  
+  def search_and_return_all_results(query, opts = {})
+    res = []
+    opts[:start] ||= 1
+    begin
+      results = GoogleCustomSearchApi.search("poker",opts)
+      res << results
+      if results.queries.keys.include?("nextPage")
+        opts[:start] = results.queries.nextPage.first.startIndex
+      else
+        opts[:start] = nil
+      end
+    end while opts[:start].nil? == false
+    return res
+  end
+  
+  # Convenience wrapper for the response Hash.
+  # Converts keys to Strings. Crawls through all
+  # member data and converts any other Hashes it
+  # finds. Provides access to values through
+  # method calls, which will convert underscored
+  # to camel case.
+  #
+  # Usage:
+  # 
+  #  rd = ResponseData.new("AlphaBeta" => 1, "Results" => {"Gamma" => 2, "delta" => [3, 4]})
+  #  puts rd.alpha_beta
+  #  => 1
+  #  puts rd.alpha_beta.results.gamma
+  #  => 2
+  #  puts rd.alpha_beta.results.delta
+  #  => [3, 4]
+  #
+  class ResponseData < Hash
+  private
+    def initialize(data={})
+      data.each_pair {|k,v| self[k.to_s] = deep_parse(v) }
+    end
+    def deep_parse(data)
+      case data
+      when Hash
+        self.class.new(data)
+      when Array
+        data.map {|v| deep_parse(v) }
+      else
+        data
+      end
+    end
+    def method_missing(*args)
+      name = args[0].to_s
+      return self[name] if has_key? name
+      camelname = name.split('_').map {|w| "#{w[0,1].upcase}#{w[1..-1]}" }.join("")
+      if has_key? camelname
+        self[camelname]
+      else
+        super *args
+      end
+    end
+  end
+  
+  
+  private # -------------------------------------------------------------------
+  
+  ##
+  # Build search request URL.
+  #
+  # see list here for valid options http://code.google.com/apis/customsearch/v1/using_rest.html#query-params
+  def url(query, opts = {})
+    opts[:q] = query
+    opts[:alt] ||= "json"
+    uri = Addressable::URI.new
+    uri.query_values = opts
+    begin
+      params.merge!(GOOGLE_SEARCH_PARAMS)
+    rescue NameError
+    end
+    "https://www.googleapis.com/customsearch/v1?key=#{GOOGLE_API_KEY}&cx=#{GOOGLE_SEARCH_CX}&#{uri.query}"
+  end
+  
+  ##
+  # Query Google, and make sure it responds.
+  #
+  def fetch(url)
+    return HTTParty.get(url)
+  end
+  
+end

data/lib/version.rb

@@ -0,0 +1,3 @@
+module GoogleCustomSearchApi
+  VERSION = "0.0.1"
+end

data/spec/fixtures/empty.json

@@ -0,0 +1,31 @@
+{
+ "kind": "customsearch#search",
+ "url": {
+  "type": "application/json",
+  "template": "https://www.googleapis.com/customsearch/v1?q={searchTerms}&num={count?}&start={startIndex?}&lr={language?}&safe={safe?}&cx={cx?}&cref={cref?}&sort={sort?}&filter={filter?}&gl={gl?}&cr={cr?}&googlehost={googleHost?}&c2coff={disableCnTwTranslation?}&hq={hq?}&hl={hl?}&siteSearch={siteSearch?}&siteSearchFilter={siteSearchFilter?}&exactTerms={exactTerms?}&excludeTerms={excludeTerms?}&linkSite={linkSite?}&orTerms={orTerms?}&relatedSite={relatedSite?}&dateRestrict={dateRestrict?}&lowRange={lowRange?}&highRange={highRange?}&searchType={searchType}&fileType={fileType?}&rights={rights?}&imgSize={imgSize?}&imgType={imgType?}&imgColorType={imgColorType?}&imgDominantColor={imgDominantColor?}&alt=json"
+ },
+ "queries": {
+  "request": [
+   {
+    "title": "Google Custom Search - asdfojasoidfjao sdfjaosdfj aosdijfoaisdjfoasjdofijas dofijweo fwoef jwoeifjw",
+    "totalResults": "0",
+    "searchTerms": "asdfojasoidfjao sdfjaosdfj aosdijfoaisdjfoasjdofijas dofijweo fwoef jwoeifjw",
+    "count": 10,
+    "inputEncoding": "utf8",
+    "outputEncoding": "utf8",
+    "safe": "off",
+    "cx": "002432975944642411257:ztx9u0hzbcw"
+   }
+  ]
+ },
+ "searchInformation": {
+  "searchTime": 0.121274,
+  "formattedSearchTime": "0.12",
+  "totalResults": "0",
+  "formattedTotalResults": "0"
+ },
+ "spelling": {
+  "correctedQuery": "asdf ojasoidfjao sdfj sdfj aosdijfoaisdjfoasjdofijas dofijweo fwoef jwoeifjw",
+  "htmlCorrectedQuery": "\u003cb\u003e\u003ci\u003easdf ojasoidfjao\u003c/i\u003e\u003c/b\u003e \u003cb\u003e\u003ci\u003esdfj sdfj\u003c/i\u003e\u003c/b\u003e aosdijfoaisdjfoasjdofijas dofijweo fwoef jwoeifjw"
+ }
+}

data/spec/fixtures/poker.json

@@ -0,0 +1,290 @@
+{
+ "kind": "customsearch#search",
+ "url": {
+  "type": "application/json",
+  "template": "https://www.googleapis.com/customsearch/v1?q={searchTerms}&num={count?}&start={startIndex?}&lr={language?}&safe={safe?}&cx={cx?}&cref={cref?}&sort={sort?}&filter={filter?}&gl={gl?}&cr={cr?}&googlehost={googleHost?}&c2coff={disableCnTwTranslation?}&hq={hq?}&hl={hl?}&siteSearch={siteSearch?}&siteSearchFilter={siteSearchFilter?}&exactTerms={exactTerms?}&excludeTerms={excludeTerms?}&linkSite={linkSite?}&orTerms={orTerms?}&relatedSite={relatedSite?}&dateRestrict={dateRestrict?}&lowRange={lowRange?}&highRange={highRange?}&searchType={searchType}&fileType={fileType?}&rights={rights?}&imgSize={imgSize?}&imgType={imgType?}&imgColorType={imgColorType?}&imgDominantColor={imgDominantColor?}&alt=json"
+ },
+ "queries": {
+  "nextPage": [
+   {
+    "title": "Google Custom Search - poker",
+    "totalResults": "40500000",
+    "searchTerms": "poker",
+    "count": 10,
+    "startIndex": 11,
+    "inputEncoding": "utf8",
+    "outputEncoding": "utf8",
+    "safe": "off",
+    "cx": "002432975944642411257:ztx9u0hzbcw"
+   }
+  ],
+  "request": [
+   {
+    "title": "Google Custom Search - poker",
+    "totalResults": "40500000",
+    "searchTerms": "poker",
+    "count": 10,
+    "startIndex": 1,
+    "inputEncoding": "utf8",
+    "outputEncoding": "utf8",
+    "safe": "off",
+    "cx": "002432975944642411257:ztx9u0hzbcw"
+   }
+  ]
+ },
+ "context": {
+  "title": "ICMS Dev"
+ },
+ "searchInformation": {
+  "searchTime": 0.193868,
+  "formattedSearchTime": "0.19",
+  "totalResults": "40500000",
+  "formattedTotalResults": "40,500,000"
+ },
+ "items": [
+  {
+   "kind": "customsearch#result",
+   "title": "Official World Series of Poker Online",
+   "htmlTitle": "Official World Series of \u003cb\u003ePoker\u003c/b\u003e Online",
+   "link": "http://www.wsop.com/",
+   "displayLink": "www.wsop.com",
+   "snippet": "Official website of the World Series of Poker Tournament. Featuring poker   tournament coverage of events, schedules and news. Play online poker games   like ...",
+   "htmlSnippet": "Official website of the World Series of \u003cb\u003ePoker\u003c/b\u003e Tournament. Featuring \u003cb\u003epoker\u003c/b\u003e \u003cbr\u003e  tournament coverage of events, schedules and news. Play online \u003cb\u003epoker\u003c/b\u003e games \u003cbr\u003e  like \u003cb\u003e...\u003c/b\u003e",
+   "cacheId": "T7q1CfbZcPwJ",
+   "formattedUrl": "www.wsop.com/",
+   "htmlFormattedUrl": "www.wsop.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://www.wsop.com/images/hm/download_image.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "185",
+      "height": "113",
+      "src": "https://encrypted-tbn1.google.com/images?q=tbn:ANd9GcQzUUbsQCEJ9huedBRALkpQPN6QBBwgwIFT2_cEA9hkkJYBehSvRygrQw"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Poker - Wikipedia, the free encyclopedia",
+   "htmlTitle": "\u003cb\u003ePoker\u003c/b\u003e - Wikipedia, the free encyclopedia",
+   "link": "http://en.wikipedia.org/wiki/Poker",
+   "displayLink": "en.wikipedia.org",
+   "snippet": "Poker is a family of card games involving betting and individualistic play whereby   the winner is determined by the ranks and combinations of their cards, some of ...",
+   "htmlSnippet": "\u003cb\u003ePoker\u003c/b\u003e is a family of card games involving betting and individualistic play whereby \u003cbr\u003e  the winner is determined by the ranks and combinations of their cards, some of \u003cb\u003e...\u003c/b\u003e",
+   "cacheId": "M0JijEuvEdkJ",
+   "formattedUrl": "en.wikipedia.org/wiki/Poker",
+   "htmlFormattedUrl": "en.wikipedia.org/wiki/\u003cb\u003ePoker\u003c/b\u003e",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://upload.wikimedia.org/wikipedia/commons/thumb/1/14/Holdem.jpg/300px-Holdem.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "240",
+      "height": "171",
+      "src": "https://encrypted-tbn2.google.com/images?q=tbn:ANd9GcStTlDjK3fS8LXRP2QSifQ1Q5dg0dwpak2LR9aGzPTavzts2b62_Q6t91k"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Online Poker - Play Online at Full Tilt Poker Room",
+   "htmlTitle": "Online \u003cb\u003ePoker\u003c/b\u003e - Play Online at Full Tilt \u003cb\u003ePoker\u003c/b\u003e Room",
+   "link": "http://www.fulltiltpoker.com/",
+   "displayLink": "www.fulltiltpoker.com",
+   "snippet": "Online Poker at the Fastest Growing Online Poker Room. Full Tilt Poker offers the   best in online poker: world famous pros, a huge bonus, real or play money.",
+   "htmlSnippet": "Online \u003cb\u003ePoker\u003c/b\u003e at the Fastest Growing Online \u003cb\u003ePoker\u003c/b\u003e Room. Full Tilt \u003cb\u003ePoker\u003c/b\u003e offers the \u003cbr\u003e  best in online \u003cb\u003epoker\u003c/b\u003e: world famous pros, a huge bonus, real or play money.",
+   "cacheId": "-0lVMr2LbU0J",
+   "formattedUrl": "www.fulltiltpoker.com/",
+   "htmlFormattedUrl": "www.fulltilt\u003cb\u003epoker\u003c/b\u003e.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://w.fulltiltcdn.net/images/global/content/home/video-player-still.png"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "206",
+      "height": "183",
+      "src": "https://encrypted-tbn3.google.com/images?q=tbn:ANd9GcQNl-iv7LDBN5OsGiWYzyH1ezgTvB2gwEIHhPLqJ0Tkd2OmQiywk0P7fyQ"
+     }
+    ],
+    "metatags": [
+     {
+      "uid": "10",
+      "nav_title": "Online Poker"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Poker.com - Online Poker Games, Free Tournaments, Rules & News",
+   "htmlTitle": "\u003cb\u003ePoker\u003c/b\u003e.com - Online \u003cb\u003ePoker\u003c/b\u003e Games, Free Tournaments, Rules & News",
+   "link": "http://www.poker.com/",
+   "displayLink": "www.poker.com",
+   "snippet": "The world's #1 free poker information website, with poker game rules, news,   tournaments and reviews of all the best online poker rooms.",
+   "htmlSnippet": "The world's #1 free \u003cb\u003epoker\u003c/b\u003e information website, with \u003cb\u003epoker\u003c/b\u003e game rules, news, \u003cbr\u003e  tournaments and reviews of all the best online \u003cb\u003epoker\u003c/b\u003e rooms.",
+   "cacheId": "IlkL1Yc3_F8J",
+   "formattedUrl": "www.poker.com/",
+   "htmlFormattedUrl": "www.\u003cb\u003epoker\u003c/b\u003e.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://www.poker.com/pokernews/wp-content/uploads/2011/03/poker.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "115",
+      "height": "115",
+      "src": "https://encrypted-tbn3.google.com/images?q=tbn:ANd9GcRQrcdYcF0OGtXZ2SCv7CP55Z7O_is7guk6l-wEw5s85I-Z-UcBwJ3V9g"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Online Poker Sites Toplists & Bonus Offers, Poker Reviews and News",
+   "htmlTitle": "Online \u003cb\u003ePoker\u003c/b\u003e Sites Toplists & Bonus Offers, \u003cb\u003ePoker\u003c/b\u003e Reviews and News",
+   "link": "http://www.pokerlistings.com/",
+   "displayLink": "www.pokerlistings.com",
+   "snippet": "5 hours ago ... PokerListings is the world's largest online poker guide with the best bonus offers   guaranteed and exclusive free tournaments for new players.",
+   "htmlSnippet": "5 hours ago \u003cb\u003e...\u003c/b\u003e PokerListings is the world's largest online \u003cb\u003epoker\u003c/b\u003e guide with the best bonus offers \u003cbr\u003e  guaranteed and exclusive free tournaments for new players.",
+   "cacheId": "dq71R1WBRMUJ",
+   "formattedUrl": "www.pokerlistings.com/",
+   "htmlFormattedUrl": "www.\u003cb\u003epoker\u003c/b\u003elistings.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://edge1.pokerlistings.com/assets/Uploads/EN-584x323-AffBanner-2.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "302",
+      "height": "167",
+      "src": "https://encrypted-tbn3.google.com/images?q=tbn:ANd9GcTXMaQ0pVWAUfo2V7ydD3a2sHYiFEPjA4zSEMJAKbC3GQ2Y2PzRAtttp1B3"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Governor of Poker - Hot Games at Miniclip.com - Play Free Online ...",
+   "htmlTitle": "Governor of \u003cb\u003ePoker\u003c/b\u003e - Hot Games at Miniclip.com - Play Free Online \u003cb\u003e...\u003c/b\u003e",
+   "link": "http://www.miniclip.com/games/governor-of-poker/en/",
+   "displayLink": "www.miniclip.com",
+   "snippet": "Win all your games in your hometown and become the Governor of Poker!",
+   "htmlSnippet": "Win all your games in your hometown and become the Governor of \u003cb\u003ePoker\u003c/b\u003e!"
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Online Poker | Play at Pacific poker online and get $8 FREE",
+   "htmlTitle": "Online \u003cb\u003ePoker\u003c/b\u003e | Play at Pacific \u003cb\u003epoker\u003c/b\u003e online and get $8 FREE",
+   "link": "http://www.pacificpoker.com/",
+   "displayLink": "www.pacificpoker.com",
+   "snippet": "Play online poker at Pacific Poker and get $8 FREE AND $400 bonus to play   poker online at 888 poker - the largest and most trusted online poker room.",
+   "htmlSnippet": "Play online \u003cb\u003epoker\u003c/b\u003e at Pacific \u003cb\u003ePoker\u003c/b\u003e and get $8 FREE AND $400 bonus to play \u003cbr\u003e  \u003cb\u003epoker\u003c/b\u003e online at 888 \u003cb\u003epoker\u003c/b\u003e - the largest and most trusted online \u003cb\u003epoker\u003c/b\u003e room.",
+   "cacheId": "sYy5C08rRZYJ",
+   "formattedUrl": "www.pacificpoker.com/",
+   "htmlFormattedUrl": "www.pacific\u003cb\u003epoker\u003c/b\u003e.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://images.888.com/newpoker/lang/en_new/PCP-main_december-400.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "339",
+      "height": "148",
+      "src": "https://encrypted-tbn3.google.com/images?q=tbn:ANd9GcQ0kVbE22EZPQE2iGUuqRFBEzh2odvIS7LfKBDNKBKkxOCoj4TAeMgEZ7c"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Online Poker Games | Play for Free Texas Holdem | PokerStars",
+   "htmlTitle": "Online \u003cb\u003ePoker\u003c/b\u003e Games | Play for Free Texas Holdem | PokerStars",
+   "link": "http://www.pokerstars.net/",
+   "displayLink": "www.pokerstars.net",
+   "snippet": "Play Texas Hold'em poker tournaments and other free poker games at the world's   largest online poker room, with PokerStars free software download.",
+   "htmlSnippet": "Play Texas Hold'em \u003cb\u003epoker\u003c/b\u003e tournaments and other free \u003cb\u003epoker\u003c/b\u003e games at the world's \u003cbr\u003e  largest online \u003cb\u003epoker\u003c/b\u003e room, with PokerStars free software download.",
+   "cacheId": "QMONnAr9GUMJ",
+   "formattedUrl": "www.pokerstars.net/",
+   "htmlFormattedUrl": "www.\u003cb\u003epoker\u003c/b\u003estars.net/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://www.pokerstars.net/images/nightly-500-promo-net.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "141",
+      "height": "178",
+      "src": "https://encrypted-tbn1.google.com/images?q=tbn:ANd9GcRiMe-aAj1GQAKfrfatZqzE3BhRT9LjXr6r5v2sVQBfWI3jYqP8m_qMrQVr"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "Poker News, Online Poker Reviews & Bonuses | PokerNews",
+   "htmlTitle": "\u003cb\u003ePoker\u003c/b\u003e News, Online \u003cb\u003ePoker\u003c/b\u003e Reviews & Bonuses | PokerNews",
+   "link": "http://www.pokernews.com/",
+   "displayLink": "www.pokernews.com",
+   "snippet": "PokerNews is the world's No. 1 poker information source, offering: global poker   news coverage, online poker reviews, special poker bonuses and deals, ...",
+   "htmlSnippet": "PokerNews is the world's No. 1 \u003cb\u003epoker\u003c/b\u003e information source, offering: global \u003cb\u003epoker\u003c/b\u003e \u003cbr\u003e  news coverage, online \u003cb\u003epoker\u003c/b\u003e reviews, special \u003cb\u003epoker\u003c/b\u003e bonuses and deals, \u003cb\u003e...\u003c/b\u003e",
+   "cacheId": "Rdd35pvFIl8J",
+   "formattedUrl": "www.pokernews.com/",
+   "htmlFormattedUrl": "www.\u003cb\u003epoker\u003c/b\u003enews.com/",
+   "pagemap": {
+    "cse_image": [
+     {
+      "src": "http://www.pokernews.com/w/articles/4f5f/91ca6bf60.jpg"
+     }
+    ],
+    "cse_thumbnail": [
+     {
+      "width": "276",
+      "height": "183",
+      "src": "https://encrypted-tbn1.google.com/images?q=tbn:ANd9GcQ0X_cuK9XH4Ys7UmStdrxthiQmmRbklJxCPtYQtQsnkd9pHX7Yyp3Ioro"
+     }
+    ],
+    "metatags": [
+     {
+      "fb:admins": "100001502531544",
+      "application-name": "PokerNews Global",
+      "msapplication-starturl": "/",
+      "msapplication-navbutton-color": "#000000",
+      "msapplication-task": "name=News;action-uri=/news/;icon-uri=/img/jumplist/news.ico"
+     }
+    ]
+   }
+  },
+  {
+   "kind": "customsearch#result",
+   "title": "WPT | World Poker Tour Home",
+   "htmlTitle": "WPT | World \u003cb\u003ePoker\u003c/b\u003e Tour Home",
+   "link": "http://www.worldpokertour.com/",
+   "displayLink": "www.worldpokertour.com",
+   "snippet": "Official Site. Find show and tournament information. Watch clips, view WPT   player bios and statistics, improve your game, and play online.",
+   "htmlSnippet": "Official Site. Find show and tournament information. Watch clips, view WPT \u003cbr\u003e  player bios and statistics, improve your game, and play online.",
+   "cacheId": "NjGERrVM5rEJ",
+   "formattedUrl": "www.worldpokertour.com/",
+   "htmlFormattedUrl": "www.world\u003cb\u003epoker\u003c/b\u003etour.com/"
+  }
+ ]
+}