semrush 3.0.15 → 3.0.16

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bc9e913c7a6a7d6e74a93d8ee7989c597219762f
+  data.tar.gz: d6a6f3225cf4ac4249c44946fe81f3ae64e4a2c8
+SHA512:
+  metadata.gz: 42c30663c5e278bb5e1cdfccd1ed8443ec1b00b9e609eaac1e4d90c6bd7a1a7b00d9ef3387f89c47b6cafcf284d65ba4b5a00a981b73690d36e009f90a30e8f4
+  data.tar.gz: 9546b93e5e95d5602f713534103da12743fbf86a800a0a6831cb7064384956138ff59f4fd73047a3c347b438230aa75f452e0d8ce763be46485723c6bc79fc86

data/README.rdoc

@@ -93,11 +93,18 @@ You may call for one of the following report types:
   data = report.competitors_organic_by_adwords  # for a domain
   data = report.competitors_adwords_by_organic  # for a domain
   data = report.related                         # keywords related report for a phrase
+  data = report.fullsearch                      # phrase fullsearch report
+  data = report.history_adwords                 # ads history for either a domain or a phrase
 
 For more information about the report types, please read http://www.semrush.com/api.html
 
 == ChangeLog
 
+=== 3.0.16, 2014-07-21
+
+* Add support for fullsearch reports
+* Add support for Adwords history reports
+
 === 3.0.15, 2013-06-26
 
 * activesupport dependency to >= 3.2.0 to support rails 4

data/lib/semrush.rb

@@ -9,7 +9,7 @@ require 'semrush/exception'
 require 'semrush/report'
 
 module Semrush
-  API_REPORT_URL = "http://%DB%.api.semrush.com/?action=report&type=%REPORT_TYPE%&%REQUEST_TYPE%=%REQUEST%&key=%API_KEY%&display_limit=%LIMIT%&display_offset=%OFFSET%&export=api&export_columns=%EXPORT_COLUMNS%&display_sort=%DISPLAY_SORT%&display_filter=%DISPLAY_FILTER%"
+  API_REPORT_URL = "http://api.semrush.com/?type=%REPORT_TYPE%&%REQUEST_TYPE%=%REQUEST%&key=%API_KEY%&display_limit=%LIMIT%&display_offset=%OFFSET%&export=api&database=%DB%&export_columns=%EXPORT_COLUMNS%&display_sort=%DISPLAY_SORT%&display_filter=%DISPLAY_FILTER%"
   API_UNITS_URL = "http://www.semrush.com/users/countapiunits.html?key=%API_KEY%"
   mattr_accessor :api_key
   @@api_key = ""

data/lib/semrush/report.rb

@@ -8,8 +8,8 @@ module Semrush
   # * :export_columns (ex: :export_columns => "Dn,Rk")
   class Report
     DBS = [:us, :uk, :ru, :de, :fr, :es, :it, :br, :au] #"us" - for Google.com, "uk" - for Google.co.uk, "ru" - for Google.ru, "de" for Google.de, "fr" for Google.fr, "es" for Google.es, "it" for Google.it Beta, "br" for Google.com.br Beta, "au" for Google.com.au Beta.
-    REPORT_TYPES = [:domain_rank, :domain_organic, :domain_adwords, :domain_organic_organic, :domain_adwords_adwords, :domain_organic_adwords, :domain_adwords_organic,
-                    :phrase_this, :phrase_organic, :phrase_related,
+    REPORT_TYPES = [:domain_rank, :domain_organic, :domain_adwords, :domain_organic_organic, :domain_adwords_adwords, :domain_organic_adwords, :domain_adwords_organic, :domain_adwords_historical,
+                    :phrase_this, :phrase_organic, :phrase_related, :phrase_adwords_historical, :phrase_fullsearch,
                     :url_organic, :url_adwords]
     REQUEST_TYPES = [:domain, :phrase, :url]
 
@@ -18,7 +18,8 @@ module Semrush
     # Allows calls like:
     # * Semrush::Report.new.domain_rank(:request_type => :domain, :request => 'thedomain.com')
     # * Semrush::Report.new.domain_organic_organic(:request_type => :domain, :request => 'thedomain.com')
-    # * Semrush::Report.new.phrase_related(:request_type => :phrase, :request => 'the phrase')
+    # * Semrush::Report.new.phrase_related(:request_type => :phrase, :request => 'the+phrase')
+    # * Semrush::Report.new.phrase_fullsearch(:request_type => :phrase, :request => 'the+phrase')
     def method_missing(method, *args)
       return super unless REPORT_TYPES.include?(method) && args.first.is_a?(Hash)
       request args.first.merge(:report_type => method)
@@ -110,7 +111,7 @@ module Semrush
     def basics params = {}
       domain? ? request(params.merge(:report_type => :domain_rank)) : request(params.merge(:report_type => :phrase_this))
     end
-    
+
     # Organic report
     # Can be called for a domain or a URL.
     # Default columns for a domain:
@@ -139,7 +140,7 @@ module Semrush
     # * Dn - A site name
     # * Ur - Target URL
     def organic params = {}
-      case 
+      case
       when url? then request(params.merge(:report_type => :url_organic))
       when phrase? then request(params.merge(:report_type => :phrase_organic))
       else request(params.merge(:report_type => :domain_organic))
@@ -231,6 +232,12 @@ module Semrush
       request(params.merge(:report_type => :domain_adwords_organic))
     end
 
+    # Ads history for domain or phrase
+    # Default columns:
+    def history_adwords params = {}
+      domain? ? request(params.merge(:report_type => :domain_adwords_historical)) : request(params.merge(:report_type => :phrase_adwords_historical))
+    end
+
     # Related keyword report
     # Default columns:
     # * Ph - The search query which the site has within the first 20 Google search results
@@ -243,6 +250,18 @@ module Semrush
       request(params.merge(:report_type => :phrase_related))
     end
 
+    # Fullsearch keyword report
+    # Default columns:
+    # * Ph - The search query which the site has within the first 20 Google search results
+    # * Nq - Average number of queries of this keyword in a month, for the corresponding local version of Google
+    # * Cp - Average price of a click on the AdWords ad for this search query, in U.S. dollars
+    # * Co - Competition of advertisers in AdWords for that term, the higher is the number - the higher is the competition
+    # * Nr - The number of search results - how many pages does Google know for this query
+    # * Td - Dynamics of change in the number of search queries in the past 12 months (estimated)
+    def fullsearch params = {}
+      request(params.merge(:report_type => :phrase_fullsearch))
+    end
+
     private
 
     def request params = {}
@@ -278,8 +297,8 @@ module Semrush
     # * limit - number of results returned
     # * offset - says to skip that many results before beginning to return results to you
     # * export_columns - list of column names, separated by coma. You may list just the column names you need in an order you need.
-    # * display_sort - a sorting as a String eg: 'am_asc' or 'am_desc'(read http://www.semrush.com/api) 
-    # * display_filter - list of filters separated by "|" (maximum number - 25). A filter consists of <sign>|<field>|<operation>|<value> (read http://www.semrush.com/api) 
+    # * display_sort - a sorting as a String eg: 'am_asc' or 'am_desc'(read http://www.semrush.com/api)
+    # * display_filter - list of filters separated by "|" (maximum number - 25). A filter consists of <sign>|<field>|<operation>|<value> (read http://www.semrush.com/api)
     #
     # more details in http://www.semrush.com/api.html
     def validate_parameters params = {}
@@ -354,4 +373,4 @@ module Semrush
 
 
   end
-end
+end

data/lib/semrush/version.rb

@@ -1,3 +1,3 @@
 module Semrush
-  VERSION = "3.0.15" # we want to follow the API version: for API 3.0, the gem will be version 3.0.x
+  VERSION = "3.0.16" # we want to follow the API version: for API 3.0, the gem will be version 3.0.x
 end

metadata

@@ -1,87 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: semrush
 version: !ruby/object:Gem::Version
-  version: 3.0.15
-  prerelease: 
+  version: 3.0.16
 platform: ruby
 authors:
 - arambert
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-26 00:00:00.000000000 Z
+date: 2014-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: pony
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.0
 description: This gem is a ruby client for the SemRush API.
 email:
-- arambert@weboglobin.com
+- adrien@rambert.me
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- lib/semrush.rb
+- lib/semrush/exception.rb
 - lib/semrush/exception/api_access_disabled.rb
 - lib/semrush/exception/api_report_type_disabled.rb
 - lib/semrush/exception/api_units_balance_is_zero.rb
@@ -90,36 +86,30 @@ files:
 - lib/semrush/exception/bad_query.rb
 - lib/semrush/exception/nothing_found.rb
 - lib/semrush/exception/unknown_error.rb
-- lib/semrush/exception.rb
 - lib/semrush/report.rb
 - lib/semrush/version.rb
-- lib/semrush.rb
 - lib/tasks/semrush_tasks.rake
-- MIT-LICENSE
-- Rakefile
-- README.rdoc
-homepage: http://www.weboglobin.com
+homepage: http://adrienrambert.com
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.2.1
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: This gem is a ruby client for the SemRush API.
 test_files: []