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 }
]
}
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.