semrush 3.0.19 → 3.0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7908057cffa77b3bcdf9301152d88bd081ef6722
-  data.tar.gz: f81b79c34d2073941be4d2e4aab22d8565f8e128
+  metadata.gz: f1ffcc2620afe86a94e56018f4f270cf74fce325
+  data.tar.gz: 22b3960b8546b4eb7c9ac635ad5aeb2e0b21918d
 SHA512:
-  metadata.gz: f8a03d42f79ac83e2b51892b367abd6809eb43ede1ab0b2ea5369994fc6796b201c5705a4ba5a9beb71a13405bf90846414827b56685714c27518622eda56390
-  data.tar.gz: 2ed8f0f977ff34ef6d9b0f9eaf4cb0ebf05dff93b08f189e984ba1a85c2103553495253c946dfbf4335bc73411e16da8cfa21dbb0ac55c38ba64499eb442b70e
+  metadata.gz: 1f51855e45b1521a8a66bad0dc79eb8e3686eb9d6272378ec65830cba6a10a0ad30c2a94bb41b52ee472e73058c095c76c40ec8081e3cc32ccd1f301a5a6de0e
+  data.tar.gz: d8ee04ef916a755cc9369eb2f91eb165c00952a19eb09b22a6b707397c088f41011ce08ddf63c140e951a47d0aa93c691674faaf15ca3c7082dc1b3402a219a1

data/README.rdoc

@@ -4,7 +4,7 @@ Semrush is a ruby wrapper for the SEMRush API.
 
 == Requirements
 
-- Ruby 1.9
+- Ruby 1.9 or 2.x
 - ActiveSupport (tested with ActiveSupport 3.1 & 3.2)
 
 == Installation
@@ -58,6 +58,7 @@ You may use the following parameters:
   :export_columns # (String) select the columns you want to fetch, for instance: :export_columns => "Dn,Rk"
   :display_sort   # (String) select the column and the order you want to sort with, for instance: :display_sort => 'tr_asc'
   :display_filter # (String) list of filters for the report, separated by '|' (maximum number - 25). A filter consists of <sign>|<field>|<operation>|<value> (read http://www.semrush.com/api), for instance: :display_filter => '+|Po|Lt|5'
+  :display_date	  # (String) select the date for the report data, in the format: YYYYMM15
 
 Some examples:
 
@@ -100,6 +101,10 @@ For more information about the report types, please read http://www.semrush.com/
 
 == ChangeLog
 
+=== 3.0.19, 2016-01-16
+
+* Fixes map bug with filtered organic report that has no results
+
 === 3.0.18, 2014-10-03
 
 * Add new databases (countries)

data/lib/semrush.rb

@@ -8,7 +8,7 @@ require 'semrush/exception'
 require 'semrush/report'
 
 module Semrush
-  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_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%&display_date=%DISPLAY_DATE%"
   API_UNITS_URL = "http://www.semrush.com/users/countapiunits.html?key=%API_KEY%"
   mattr_accessor :api_key
   @@api_key = ""

data/lib/semrush/report.rb

@@ -9,7 +9,7 @@ module Semrush
   class Report
     DBS = [:us, :uk, :ca, :ru, :de, :fr, :es, :it, :br, :au, :ar, :be, :ch, :dk, :fi, :hk, :ie, :il, :mx, :nl, :no, :pl, :se, :sg, :tr] #"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, etc
     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,
+                    :phrase_this, :phrase_organic, :phrase_related, :phrase_adwords_historical, :phrase_fullsearch, :phrase_kdi,
                     :url_organic, :url_adwords]
     REQUEST_TYPES = [:domain, :phrase, :url]
 
@@ -261,6 +261,16 @@ module Semrush
     def fullsearch params = {}
       request(params.merge(:report_type => :phrase_fullsearch))
     end
+    
+    # Keyword Difficulty report
+    # Usage:
+    # > report = Semrush::Report.phrase(phrases.join(';'), database: 'us', limit: 100).kdi
+    # Report constants an array of hashes:
+    # * keyword - phrase for KDI
+    # * keyword_difficulty_index - KDI for phrase
+    def kdi params = {}
+      request(params.merge(:report_type => :phrase_kdi))
+    end
 
     private
 
@@ -306,7 +316,7 @@ module Semrush
       params.delete(:db) unless DBS.include?(params[:db].try(:to_sym))
       params.delete(:report_type) unless REPORT_TYPES.include?(params[:report_type].try(:to_sym))
       params.delete(:request_type) unless REQUEST_TYPES.include?(params[:request_type].try(:to_sym))
-      @parameters = {:db => "us", :api_key => Semrush.api_key, :limit => "", :offset => "", :export_columns => "", :display_sort => "", :display_filter => ""}.merge(@parameters).merge(params)
+      @parameters = {:db => "us", :api_key => Semrush.api_key, :limit => "", :offset => "", :export_columns => "", :display_sort => "", :display_filter => "", :display_date => ""}.merge(@parameters).merge(params)
       raise Semrush::Exception::Nolimit.new(self, "The limit parameter is missing: a limit is required.") unless @parameters[:limit].present? && @parameters[:limit].to_i>0
       raise Semrush::Exception::BadArgument.new(self, "Request parameter is missing: Domain name, URL, or keywords are required.") unless @parameters[:request].present?
       raise Semrush::Exception::BadArgument.new(self, "Bad db: #{@parameters[:db]}") unless DBS.include?(@parameters[:db].try(:to_sym))
@@ -333,6 +343,7 @@ module Semrush
     end
 
     def parse(text = "")
+      return [] if text.empty?
       csv = CSV.parse(text.to_s, :col_sep => ";")
       data = {}
       format_key = lambda do |k|

data/lib/semrush/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: semrush
 version: !ruby/object:Gem::Version
-  version: 3.0.19
+  version: 3.0.20
 platform: ruby
 authors:
 - arambert
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-01-16 00:00:00.000000000 Z
+date: 2017-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport