0.0
The project is in a healthy, maintained state
Official RankVectors API SDK for Ruby - Intelligent internal linking optimization using AI
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

>= 3.6.0, ~> 3.6

Runtime

~> 1.0, >= 1.0.1
 Project Readme

rankvectors

RankVectors - the Ruby gem for the RankVectors API

Intelligent internal linking optimization API using AI.

RankVectors helps you automatically discover and implement optimal internal links across your website to improve SEO performance and user experience.

Key Features

  • AI-Powered Analysis: Uses OpenAI embeddings to find optimal linking opportunities
  • Smart Crawling: Automatically crawls and analyzes your website content
  • Automated Implementation: Implement links via webhooks or manual instructions
  • Page-Based Plans: Predictable pricing by number of pages monitored
  • Multi-Platform Support: Works with any CMS or platform via REST API

Getting Started

  1. Create a project with your website URL
  2. Start a crawl to analyze your content
  3. Generate AI-powered link suggestions
  4. Implement suggestions via API or webhook
  5. Track performance and manage page usage and limits

Authentication

Most API endpoints support authentication using your RankVectors API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get your API key from your RankVectors dashboard: Settings → API Keys

Note: Some endpoints (marked in the documentation) support both API key authentication and web session authentication (Stack Auth). API key authentication is required for SDK usage and external integrations like WordPress plugins.

This SDK is automatically generated by the OpenAPI Generator project:

  • API version: 1.3.1
  • Package version: 1.3.1
  • Generator version: 7.16.0
  • Build package: org.openapitools.codegen.languages.RubyClientCodegen For more information, please visit https://rankvectors.com/docs

Installation

Build a gem

To build the Ruby code into a gem:

gem build rankvectors.gemspec

Then either install the gem locally:

gem install ./rankvectors-1.3.1.gem

(for development, run gem install --dev ./rankvectors-1.3.1.gem to install the development dependencies)

or publish the gem to a gem hosting service, e.g. RubyGems.

Finally add this to the Gemfile:

gem 'rankvectors', '~> 1.3.1'

Install from Git

If the Ruby gem is hosted at a git repository: https://github.com/rankvectors/rankvectors-ruby-sdk, then add the following in the Gemfile:

gem 'rankvectors', :git => 'https://github.com/rankvectors/rankvectors-ruby-sdk.git'

Include the Ruby code directly

Include the Ruby code directly using -I as follows:

ruby -Ilib script.rb

Getting Started

Please follow the installation procedure and then run the following code:

# Load the gem
require 'rankvectors'

# Setup authorization
RankVectors.configure do |config|
  # Configure API key authorization: ApiKeyAuth
  config.api_key['Authorization'] = 'YOUR API KEY'
  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
  # config.api_key_prefix['Authorization'] = 'Bearer'
end

api_instance = RankVectors::APIKeysApi.new
create_api_key_request = RankVectors::CreateApiKeyRequest.new({name: 'WordPress Plugin'}) # CreateApiKeyRequest | 

begin
  #Create API key
  result = api_instance.create_api_key(create_api_key_request)
  p result
rescue RankVectors::ApiError => e
  puts "Exception when calling APIKeysApi->create_api_key: #{e}"
end

Documentation for API Endpoints

All URIs are relative to https://api.rankvectors.com

Class Method HTTP request Description
RankVectors::APIKeysApi create_api_key POST /api/api-keys Create API key
RankVectors::APIKeysApi delete_api_key DELETE /api/api-keys/{id} Delete API key
RankVectors::APIKeysApi list_api_keys GET /api/api-keys List API keys
RankVectors::APIKeysApi update_api_key PATCH /api/api-keys/{id} Update API key
RankVectors::AnalyticsApi get_project_analytics GET /api/projects/{projectId}/analytics Get project analytics
RankVectors::ContentVerificationApi get_page_changes GET /api/projects/{projectId}/changes Get page changes
RankVectors::ContentVerificationApi verify_content POST /api/projects/{projectId}/verify-content Verify page content
RankVectors::CrawlingApi get_crawl_history GET /api/projects/{projectId}/crawl Get crawl history
RankVectors::CrawlingApi start_crawl POST /api/projects/{projectId}/crawl Start website crawl
RankVectors::ImplementationsApi get_implementation GET /api/projects/{projectId}/implementations/{implementationId} Get implementation details
RankVectors::ImplementationsApi implement_links POST /api/projects/{projectId}/implementations Implement link suggestions
RankVectors::ImplementationsApi list_implementations GET /api/projects/{projectId}/implementations List implementations
RankVectors::ImplementationsApi rollback_implementation POST /api/projects/{projectId}/implementations/{implementationId}/rollback Rollback implementation
RankVectors::PagesApi batch_sync_pages POST /api/projects/{projectId}/pages/batch Batch sync pages
RankVectors::PagesApi list_pages GET /api/projects/{projectId}/pages List pages
RankVectors::ProjectsApi create_project POST /api/projects Create a new project
RankVectors::ProjectsApi delete_project DELETE /api/projects/{projectId} Delete a project
RankVectors::ProjectsApi get_project GET /api/projects/{projectId} Get project details
RankVectors::ProjectsApi list_projects GET /api/projects List all projects
RankVectors::ProjectsApi sync_project POST /api/projects/{projectId}/sync Sync project
RankVectors::SuggestionsApi delete_suggestion DELETE /api/projects/{projectId}/suggestions/{suggestionId} Delete suggestion
RankVectors::SuggestionsApi generate_suggestions POST /api/projects/{projectId}/suggestions Generate link suggestions
RankVectors::SuggestionsApi get_suggestions GET /api/projects/{projectId}/suggestions Get link suggestions
RankVectors::SuggestionsApi update_suggestion PATCH /api/projects/{projectId}/suggestions/{suggestionId} Update suggestion status
RankVectors::UserApi get_user_info GET /api/user/me Get authenticated user information
RankVectors::WebhooksApi get_implementation_instructions GET /api/webhook/implement-link Get implementation instructions
RankVectors::WebhooksApi report_implementation_status POST /api/webhook/implement-link Report implementation status

Documentation for Models

Documentation for Authorization

Authentication schemes defined for the API:

ApiKeyAuth

  • Type: API key
  • API key parameter name: Authorization
  • Location: HTTP header