Skip to main content
GET
/
api
/
ranking-score
curl "https://searchcompany-main.up.railway.app/api/ranking-score?url=https://example.com"

{
  "score": 38,
  "competitor_scores": [72, 65, 58, 42],
  "platform_statuses": [
    { "platform": "ChatGPT", "status": "LOW" },
    { "platform": "Gemini", "status": "MEDIUM" },
    { "platform": "Grok", "status": "LOW" },
    { "platform": "Perplexity", "status": "LOW" },
    { "platform": "DeepSeek", "status": "LOW" },
    { "platform": "Claude", "status": "MEDIUM" },
    { "platform": "Google AI", "status": "LOW" },
    { "platform": "Copilot", "status": "LOW" }
  ]
}
Public endpoint used on the marketing website to show visitors their initial AI ranking score. If the URL hasn’t been checked before, a new score is generated and saved.
This is a public endpoint - no authentication required. Used on the searchcompany.ai landing page.

​
Query Parameters

​
url
string
required
Website URL to get/create score for

​
Response

​
score
integer
The AI ranking score (32-49 for new URLs)
​
competitor_scores
array
Array of 4 competitor scores (always higher than user score, sorted descending)
​
platform_statuses
array
Array of AI platform visibility statuses

​
How It Works

  1. Check Database - Looks for existing score in pre_payment_rankings table
  2. Return Existing - If found, returns the stored score
  3. Generate New - If new URL, generates score between 32-49 and saves it
  4. Generate Competitor Scores - Creates 4 competitor scores higher than the user’s score
  5. Generate Platform Statuses - Randomly assigns LOW (70%) or MEDIUM (30%) status to each AI platform
This ensures the same URL always gets the same score, creating consistency across page refreshes. 
curl "https://searchcompany-main.up.railway.app/api/ranking-score?url=https://example.com"

{
  "score": 38,
  "competitor_scores": [72, 65, 58, 42],
  "platform_statuses": [
    { "platform": "ChatGPT", "status": "LOW" },
    { "platform": "Gemini", "status": "MEDIUM" },
    { "platform": "Grok", "status": "LOW" },
    { "platform": "Perplexity", "status": "LOW" },
    { "platform": "DeepSeek", "status": "LOW" },
    { "platform": "Claude", "status": "MEDIUM" },
    { "platform": "Google AI", "status": "LOW" },
    { "platform": "Copilot", "status": "LOW" }
  ]
}

​
Usage on Landing Page

const response = await fetch(
  `https://searchcompany-main.up.railway.app/api/ranking-score?url=${encodeURIComponent(
    userUrl
  )}`
);
const { score, competitor_scores, platform_statuses } = await response.json();
// Display: "Your AI Visibility Score: 38"
// Show competitor rankings and platform breakdown