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

Registers a new business for AI visibility tracking. Creates records in multiple tables and updates Clerk organization metadata.

Architecture

Request Body

{
  "business_name": "Acme Corp",
  "business_url": "https://acme.com",
  "tracking_type": "business",
  "clerk_org_id": "org_abc123",
  "clerk_user_id": "user_xyz789",
  "org_slug": "acme-corp"
}

What Gets Created

clerk_organization_details - Links Clerk org to business
entities - Business entity for tracking
pre_payment_rankings - Initial ranking score (32-49)
Clerk metadata - Business data on organization

Response Format

{
  "id": 1,
  "business_uuid": "uuid-...",
  "business_name": "Acme Corp",
  "created_at": "2024-01-15T10:30:00Z",
  "ranking_score": 42,
  "entity_id": "uuid-..."
}

Code Location

src/app/apis/onboarding/create_business/routes.py

​Purpose

​Architecture

​Request Body

​What Gets Created

​Response Format

​Code Location

Purpose

Architecture

Request Body

What Gets Created

Response Format

Code Location