INTEGRATION · RUBY

Find competitors with Ruby

Get the top 100 competitors, look-alikes, and similar companies for any domain in Ruby — ranked with match scores, relationship types, and confidence, powered by SimilarIQ's AI research engine. One key, ~60 seconds to first result.

Quick start

require "net/http"
require "json"

uri = URI("https://similariq.ai/api/v1/search")
req = Net::HTTP::Post.new(uri, {{
  "X-API-Key" => ENV["SIMILARIQ_API_KEY"],
  "Content-Type" => "application/json",
}})
req.body = {{ domain: "salesforce.com", limit: 100 }}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, read_timeout: 180) do |http|
  http.request(req)
end

JSON.parse(res.body)["competitors"].first(10).each do |c|
  puts "#{{c['rank']}}. #{{c['company']}} (#{{c['domain']}}) — #{{c['matchScore']}} #{{c['type']}}"
end

Drop it in a Rails service object or a rake task to enrich accounts overnight.

What you get back

{
  "domain": "salesforce.com",
  "totalCompetitors": 100,
  "creditsRemaining": 199,
  "competitors": [
    { "rank": 1, "company": "HubSpot", "domain": "hubspot.com",
      "matchScore": 97, "type": "Direct", "confidence": 94,
      "likelyCompetitor": true }
  ]
}
Going further: bulk research, history, exports and watchlists are all in the API, SDKs, CLI, and MCP server. Full reference: similariq.ai/docs.

Frequently asked questions

What does SimilarIQ return for a domain?

The top 100 competitors, look-alikes, and similar companies for any company website — each with a 0-100 match score, relationship type (Direct, Indirect, Adjacent, Emerging), a confidence score, and a likely-competitor flag. Results come from SimilarIQ's proprietary AI research engine, cross-validated across multiple intelligence sources.

How much does it cost?

1 credit per search (up to 100 results). Credits come with plans from $6/month ($0.10-$0.24 per search) or pay-as-you-go at $0.50 per search. Free trial searches on signup. Failed searches auto-refund, and reading past results is always free.

How do I get an API key?

Sign up at similariq.ai, then create a key under API Keys in the app. The same sk-live- key works for the REST API, SDKs, CLI, and MCP server.

How long does a search take in Ruby?

30-60 seconds — the engine researches the domain live across multiple intelligence sources and cross-validates before ranking. Set your HTTP timeout to at least 120 seconds, or use the bulk endpoints for large lists.