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" }
]
}
🟢 GET - Ranking Score
Get Ranking Score
Get or create a pre-payment AI ranking score for a website
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
string
required
Website URL to get/create score for
Response
integer
The AI ranking score (32-49 for new URLs)
array
Array of 4 competitor scores (always higher than user score, sorted descending)
array
How It Works
- Check Database - Looks for existing score in
pre_payment_rankingstable - Return Existing - If found, returns the stored score
- Generate New - If new URL, generates score between 32-49 and saves it
- Generate Competitor Scores - Creates 4 competitor scores higher than the user’s score
- Generate Platform Statuses - Randomly assigns LOW (70%) or MEDIUM (30%) status to each AI platform
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