majestic_seo_api 0.9.3

data/Gemfile

@@ -0,0 +1,13 @@
+source "http://rubygems.org"
+
+gem 'nokogiri'
+gem "faraday", "~> 0.7.6"
+gem "agiley-faraday_middleware", "~> 0.8.3"
+gem 'jruby-openssl', '~> 0.7', :platforms => :jruby
+
+group :development, :test do
+  gem 'bundler'
+  gem 'jeweler'
+  gem 'rspec'
+  gem "mocha"
+end

data/LICENSE.txt

@@ -0,0 +1,50 @@
+
+Version 0.9.3
+
+Copyright (c) 2011, Majestic-12 Ltd
+
+All rights reserved.
+
+
+
+Redistribution and use in source and binary forms, with or without
+
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright
+
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright
+
+      notice, this list of conditions and the following disclaimer in the
+
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the name of the Majestic-12 Ltd nor the
+
+      names of its contributors may be used to endorse or promote products
+
+      derived from this software without specific prior written permission.
+
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+
+DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.markdown

@@ -0,0 +1,69 @@
+# Majestic SEO Ruby API Client #
+
+**This is currently under heavy development (first released 2012-01-27). Get back to me if you run into any bugs.**
+
+This is a Ruby Api client/wrapper/connector intended to be used with [Majestic SEO's awesome API](http://developer-support.majesticseo.com/).
+
+Majestic SEO currently offers a client/connector over at [Connector Downloads](http://developer-support.majesticseo.com/connectors/downloads/) but this connector wasn't suitable for me because:
+
+* It wasn't gemified (thus requiring a bunch of hacking to incorporate it into every respective Rails-app)
+* Didn't have a config file with environment specific client settings (api key, api environment). I need to be able to use different api environments depending on the app environment
+* **Didn't work with JRuby** - this gem does (or well - on 1.6.6-head and 1.7-head).
+* Lacked test/spec coverage. The current test coverage isn't the best, but it's still better than nothing.
+
+It is based on the Majestic SEO connector but has pretty much been rewritten from scratch.
+
+The original script/test-files included now reside in script/. All of them haven't been completely upgraded yet, but they will.
+
+## Installation ##
+Add to your Gemfile:
+```
+gem 'majestic_seo_api', :git => 'git://github.com/Agiley/Majestic-SEO-Api.git'
+```
+
+Generate config file:
+```
+rails generate majestic_seo
+```
+
+## Tested on ##
+The specs pass on:
+
+* Ruby 1.9.2
+* Ruby 1.9.3
+* JRuby 1.6.6-head
+* JRuby 1.7-head
+
+*JRuby 1.6.5/1.6.5.1 does not work :(*
+
+## License ##
+Original Majestic SEO License:
+
+---------
+
+Version 0.9.3
+
+Copyright (c) 2011, Majestic-12 Ltd
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+* Neither the name of the Majestic-12 Ltd nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---------
+

data/Rakefile

@@ -0,0 +1,44 @@
+begin
+  require 'bundler'
+  Bundler::GemHelper.install_tasks
+
+rescue LoadError
+  puts "Bundler not available. Install it with: gem install bundler"  
+end
+
+begin
+  # Rspec 2.0
+  require 'rspec/core/rake_task'
+
+  desc 'Default: run specs'
+  task :default => :spec  
+  RSpec::Core::RakeTask.new do |t|
+    t.pattern = "spec/**/*_spec.rb"
+  end
+  
+  RSpec::Core::RakeTask.new('rcov') do |t|
+    t.pattern = "spec/**/*_spec.rb"
+    t.rcov = true
+    t.rcov_opts = ['--exclude', 'spec']
+  end
+
+rescue LoadError
+  puts "Rspec not available. Install it with: gem install rspec"  
+end
+
+begin
+  require 'jeweler'
+  
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name          =   "majestic_seo_api"
+    gemspec.summary       =   "Interface for communicating with Majestic SEO's API"
+    gemspec.description   =   "Interface for communicating with Majestic SEO's API"
+    gemspec.email         =   "sebastian@agiley.se"
+    gemspec.homepage      =   "http://developer-support.majesticseo.com/connectors/"
+    gemspec.authors       =   ["Majestic-12 Ltd", "Sebastian Johnsson"]
+  end
+  
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.9.3

data/lib/generators/majestic_seo/majestic_seo_generator.rb

@@ -0,0 +1,18 @@
+require 'generators/helpers/file_helper'
+
+module MajesticSeo
+  module Generators
+    class MajesticSeoGenerator < Rails::Generators::Base
+      namespace "majestic_seo"
+      source_root File.expand_path("../../templates", __FILE__)
+
+      desc "Copies majestic_seo.yml to the Rails app's config directory."
+
+      def copy_config
+        template "majestic_seo.template.yml", "config/majestic_seo.yml"
+      end
+
+    end
+  end
+end
+

data/lib/generators/templates/majestic_seo.template.yml

@@ -0,0 +1,13 @@
+---
+development:
+  environment: sandbox
+  api_key: "api_key"
+
+test:
+  environment: sandbox
+  api_key: "api_key"
+
+production:
+  environment: sandbox
+  api_key: "api_key"
+

data/lib/majestic_seo/api/client.rb

@@ -0,0 +1,151 @@
+
+=begin
+
+  Version 0.9.3
+
+  Copyright (c) 2011, Majestic-12 Ltd
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  1. Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  3. Neither the name of the Majestic-12 Ltd nor the
+  names of its contributors may be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=end
+
+require 'uri'
+require 'cgi'
+require 'rubygems'
+require 'faraday_middleware'
+
+module MajesticSeo
+  module Api
+
+    class Client
+      attr_accessor :connection, :api_url, :config, :api_key, :environment
+      include MajesticSeo::Api::Logger
+
+    	def initialize(api_key = nil, environment = nil)
+    		set_config
+
+    		@api_key            =   api_key       ||  self.config.fetch("api_key", nil)
+    		@environment        =   environment   ||  self.config.fetch("environment", :sandbox)
+    		@environment        =   @environment.to_sym
+    		
+    		set_api_url
+    		set_connection
+    	end
+
+    	def set_config
+    	  rails_env     =   defined?(Rails) ? Rails.env : "development"
+    	  self.config   = YAML.load_file(File.join(Rails.root, "config/majestic_seo.yml"))[rails_env] rescue nil
+        self.config ||= YAML.load_file(File.join(File.dirname(__FILE__), "../../generators/templates/majestic_seo.yml"))[rails_env] rescue nil
+        self.config ||= YAML.load_file(File.join(File.dirname(__FILE__), "../../generators/templates/majestic_seo.template.yml"))[rails_env] rescue nil
+        self.config ||= {}
+    	end
+    	
+    	def set_api_url
+        @api_url = case @environment.to_sym
+          when :sandbox     then "http://developer.majesticseo.com/api_command"
+          when :production  then "http://enterprise.majesticseo.com/api_command"
+          else
+            "http://developer.majesticseo.com/api_command"
+        end
+      end
+    	
+    	def set_connection
+    	  @connection = Faraday.new(:url => @api_url) do |builder|
+          builder.request  :url_encoded
+          #builder.response :logger
+          builder.use FaradayMiddleware::ParseNokogiriXml
+          builder.adapter  :net_http
+        end
+    	end
+
+    	def get_index_item_info(urls, parameters = {})
+    	  request_parameters                    =   {}
+    	  request_parameters['datasource']      =   parameters.fetch(:data_source, "historic")
+        request_parameters["items"]           =   urls.size
+
+        urls.each_with_index do |url, index|
+          request_parameters["item#{index}"]  =   url
+        end
+
+        timeout     =   parameters.fetch(:timeout, 5)
+        response    =   self.execute_command("GetIndexItemInfo", request_parameters, timeout)
+        response    =   MajesticSeo::Api::ItemInfoResponse.new(response)
+
+        return response
+    	end
+
+    	def get_top_back_links(url, parameters = {})
+        request_parameters                                  =     {}
+        request_parameters['datasource']                    =     parameters.fetch(:data_source, "historic")
+        request_parameters['URL']                           =     url
+        request_parameters["MaxSourceURLs"]                 =     parameters.fetch(:max_source_urls, 100)
+        request_parameters["ShowDomainInfo"]                =     parameters.fetch(:show_domain_info, 0)
+        request_parameters["GetUrlData"]                    =     parameters.fetch(:get_url_data, 1)
+        request_parameters["GetSubDomainData"]              =     parameters.fetch(:get_sub_domain_data, 0)
+        request_parameters["GetRootDomainData"]             =     parameters.fetch(:get_root_domain_data, 0)
+        request_parameters["MaxSourceURLsPerRefDomain"]     =     parameters.fetch(:max_source_urls_per_ref_domain, -1)
+        request_parameters["DebugForceQueue"]               =     parameters.fetch(:debug_force_queue, 0)
+
+        timeout     =   parameters.fetch(:timeout, 5)
+        response    =   self.execute_command("GetTopBackLinks", request_parameters, timeout)
+        response    =   MajesticSeo::Api::TopBackLinksResponse.new(response)
+
+        return response
+    	end
+
+    	# This method will execute the specified command as an api request.
+    	# 'name' is the name of the command you wish to execute, e.g. GetIndexItemInfo
+    	# 'parameters' a hash containing the command parameters.
+    	# 'timeout' specifies the amount of time to wait before aborting the transaction. This defaults to 5 seconds.
+    	def execute_command(name, parameters, timeout = 5)
+    		query_parameters = parameters.merge({"app_api_key" => @api_key, "cmd" => name})
+    		self.execute_request(query_parameters, timeout)
+    	end
+
+    	# This will execute the specified command as an OpenApp request.
+    	# 'command_name' is the name of the command you wish to execute, e.g. GetIndexItemInfo
+    	# 'parameters' a hash containing the command parameters.
+    	# 'access_token' the token provided by the user to access their resources.
+    	# 'timeout' specifies the amount of time to wait before aborting the transaction. This defaults to 5 seconds.
+    	def execute_open_app_request(command_name, parameters, access_token, timeout = 5)
+    		query_parameters = parameters.merge({"accesstoken" => access_token, "cmd" => command_name, "privatekey" => @api_key})
+    		self.execute_request(query_parameters, timeout)
+    	end
+
+    	# 'parameters' a hash containing the command parameters.
+    	# 'timeout' specifies the amount of time to wait before aborting the transaction. This defaults to 5 seconds.
+    	def execute_request(parameters, timeout = 5)
+        response = @connection.get do |request|
+          request.params  = parameters
+          request.options = {:timeout => timeout}
+        end
+
+    		return response
+    	end
+
+    end
+
+  end
+end
+

data/lib/majestic_seo/api/data_table.rb

@@ -0,0 +1,90 @@
+
+=begin
+
+  Version 0.9.3
+
+  Copyright (c) 2011, Majestic-12 Ltd
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  1. Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  3. Neither the name of the Majestic-12 Ltd nor the
+  names of its contributors may be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=end
+
+module MajesticSeo
+  module Api
+    class DataTable
+      attr_accessor :node, :name, :row_count, :headers, :rows
+
+      def initialize(node)
+        @node       =   node
+
+        if (@node)
+          @name       =   @node["Name"]       ||  nil
+          @row_count  =   @node["RowsCount"]  ||  0
+          @headers    =   @node["Headers"]    ||  []
+
+          @rows       =   []
+          parse
+        end
+      end
+
+      def parse
+        rows = @node.xpath("Row")
+
+        if (@headers && rows && rows.any?)
+          @headers = split(@headers)
+
+          rows.each do |row|
+            parse_row(row)
+          end
+        end
+      end
+
+      def parse_row(row)
+        if (row && row.content)
+          row           =   row.content
+          row_hash      =   {}
+          splitted_row  =   split(row)
+
+          @headers.each_with_index do |header, index|
+            value               =   splitted_row[index].strip
+            value               =   (value && value != "") ? value : nil
+            row_hash[header]    =   value
+          end
+
+          @rows << row_hash if (row_hash && !row_hash.empty?)
+        end
+      end
+
+      def split(text)
+        splitted = text.split(/\|(?!\|)/)
+      end
+
+      def row_count
+        @rows.length
+      end
+
+    end
+  end
+end
+

data/lib/majestic_seo/api/item_info.rb

@@ -0,0 +1,126 @@
+
+=begin
+
+  Version 0.9.3
+
+  Copyright (c) 2011, Majestic-12 Ltd
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  1. Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  3. Neither the name of the Majestic-12 Ltd nor the
+  names of its contributors may be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=end
+
+module MajesticSeo
+  module Api
+    class ItemInfo
+      attr_accessor :response, :mappings
+      attr_accessor :index, :type, :url, :result_code, :success, :error_message, :status
+      attr_accessor :external_backlinks, :referring_domains, :indexed_urls, :analysis_results_unit_cost, :ac_rank
+      attr_accessor :get_top_backlinks_analysis_results_unit_cost, :referring_ip_addresses, :referring_subnets
+      attr_accessor :referring_edu_domains, :external_edu_backlinks, :referring_gov_domains, :external_gov_backlinks
+      attr_accessor :exact_referring_edu_domains, :exact_external_edu_backlinks, :exact_referring_gov_domains, :exact_external_gov_backlinks
+      attr_accessor :crawled, :last_crawl_data, :last_crawl_result, :redirecting, :final_redirect_result
+      attr_accessor :outbound_domain_links, :outbound_external_backliks, :outbound_internal_backlinks
+      attr_accessor :title, :redirecting_to
+
+      # This method returns a new instance of the Response class.
+      # If one of the parameters are not provided, it will default to nil.
+      def initialize(response = nil)
+        self.response           =   response
+        
+        self.mappings = {
+          "ItemNum"                               =>    {:index                                         =>    :integer},
+          "ItemType"                              =>    {:type                                          =>    :integer},
+          "Item"                                  =>    {:url                                           =>    :string},
+          "ResultCode"                            =>    {:result_code                                   =>    :string},
+          "Status"                                =>    {:status                                        =>    :string},
+          "ExtBackLinks"                          =>    {:external_backlinks                            =>    :integer},
+          "RefDomains"                            =>    {:referring_domains                             =>    :integer},
+          "IndexedURLs"                           =>    {:indexed_urls                                  =>    :integer},
+          "AnalysisResUnitsCost"                  =>    {:analysis_results_unit_cost                    =>    :integer},
+          "ACRank"                                =>    {:ac_rank                                       =>    :integer},
+          "GetTopBackLinksAnalysisResUnitsCost"   =>    {:get_top_backlinks_analysis_results_unit_cost  =>    :integer},
+          "RefIPs"                                =>    {:referring_ip_addresses                        =>    :integer},
+          "RefSubNets"                            =>    {:referring_subnets                             =>    :integer},
+          "RefDomainsEDU"                         =>    {:referring_edu_domains                         =>    :integer},
+          "ExtBackLinksEDU"                       =>    {:external_edu_backlinks                        =>    :integer},
+          "RefDomainsGOV"                         =>    {:referring_gov_domains                         =>    :integer},
+          "ExtBackLinksGOV"                       =>    {:external_gov_backlinks                        =>    :integer},
+          "RefDomainsEDU_Exact"                   =>    {:exact_referring_edu_domains                   =>    :integer},
+          "ExtBackLinksEDU_Exact"                 =>    {:exact_external_edu_backlinks                  =>    :integer},
+          "RefDomainsGOV_Exact"                   =>    {:exact_referring_gov_domains                   =>    :integer},
+          "ExtBackLinksGOV_Exact"                 =>    {:exact_external_gov_backlinks                  =>    :integer},
+          "CrawledFlag"                           =>    {:crawled                                       =>    :boolean},
+          "LastCrawlDate"                         =>    {:last_crawl_date                               =>    :date},
+          "LastCrawlResult"                       =>    {:last_crawl_result                             =>    :string},
+          "RedirectFlag"                          =>    {:redirecting                                   =>    :boolean},
+          "FinalRedirectResult"                   =>    {:final_redirect_result                         =>    :string},
+          "OutDomainsExternal"                    =>    {:outbound_domain_links                         =>    :integer},
+          "OutLinksExternal"                      =>    {:outbound_external_backliks                    =>    :integer},
+          "OutLinksInternal"                      =>    {:outbound_internal_backlinks                   =>    :integer},
+          "Title"                                 =>    {:title                                         =>    :string},
+          "RedirectTo"                            =>    {:redirecting_to                                =>    :string},
+        }
+        
+        parse_item_info
+      end
+      
+      def parse_item_info
+        self.response.each do |api_column, api_value|
+          mapping   =   self.mappings[api_column]
+          value     =   (!api_value.nil? && !api_value.to_s.eql?("")) ? api_value.to_s : nil
+          
+          mapping.each do |column, data_type|
+            converted_value = case data_type
+              when :string    then value
+              when :integer   then value.to_i
+              when :date      then value #Return it as a string for now - need to be able to retrieve a result with a date set to determine date parsing format
+              when :boolean   then (value.downcase.eql?("true"))
+            end
+            
+            self.send("#{column}=", converted_value)
+          end if (value)
+        end
+        
+        set_result_status
+        set_item_type
+      end
+      
+      def set_result_status
+        self.success          =   (self.result_code && self.result_code.downcase.eql?("ok"))
+        self.error_message    =   (self.success) ? "" : self.result_code
+      end
+      
+      def set_item_type
+        self.type = case self.type
+          when 1 then :root_domain
+          when 2 then :sub_domain
+          when 3 then :url
+        end
+      end
+
+    end
+
+  end
+end
+

data/lib/majestic_seo/api/item_info_response.rb

@@ -0,0 +1,58 @@
+
+=begin
+
+  Version 0.9.3
+
+  Copyright (c) 2011, Majestic-12 Ltd
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+  1. Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+  3. Neither the name of the Majestic-12 Ltd nor the
+  names of its contributors may be used to endorse or promote products
+  derived from this software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+  DISCLAIMED. IN NO EVENT SHALL Majestic-12 Ltd BE LIABLE FOR ANY
+  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+  (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=end
+
+module MajesticSeo
+  module Api
+    class ItemInfoResponse < Response
+      
+      def initialize(response, table_key = "Results")
+        self.table_key = table_key
+        super(response)
+        parse_item_info_objects
+      end
+      
+      def parse_item_info_objects
+        parsed      = []
+        item_infos  = self.items
+        
+        if (item_infos && item_infos.any?)
+          item_infos.each do |item_info|
+            parsed << MajesticSeo::Api::ItemInfo.new(item_info)
+          end 
+
+          @items = parsed if (parsed.any?)
+        end
+      end
+      
+    end
+  end
+end

data/lib/majestic_seo/api/logger.rb

@@ -0,0 +1,11 @@
+module MajesticSeo
+  module Api
+    module Logger
+      
+      def log(level, message)
+        (defined?(Rails) && Rails.logger) ? Rails.logger.send(level, message) : puts(message)
+      end
+      
+    end
+  end
+end