Overview - The Search Company API

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

Purpose

Returns the current visibility score and historical data for dashboard charts. Shows how visible a business/product is across AI platforms over time.

Architecture

Query Parameters

Parameter	Type	Description
`product_id`	`string`	Filter by product (optional)
`business_url`	`string`	Business URL for ranking lookup
`ranking_score`	`int`	Pre-payment ranking score

Response Format

{
  "visibilityScore": {
    "value": 67,
    "trend": "+12%"
  },
  "history": [
    {"date": "Jan 15", "value": 55},
    {"date": "Jan 16", "value": 58},
    {"date": "Jan 17", "value": 67}
  ]
}

Trend Calculation

Compares current score to score from 7 days ago:

trend = ((current - week_ago) / week_ago) * 100

History Format

Returns last 6 months of data
Dates formatted as “Jan 15” for frontend charts
Values are 0-100 percentage scores

Code Location

src/app/apis/current_setup/visibility_score/routes.py

​Purpose

​Architecture

​Query Parameters

​Response Format

​Trend Calculation

​History Format

​Code Location

Purpose

Architecture

Query Parameters

Response Format

Trend Calculation

History Format

Code Location