Skip to main content
Add a competitor to analyze in the Explore tab. The competitor website is analyzed using Exa’s AI-powered APIs:
  1. Exa /contents - Fetches the actual website content with live crawling
  2. Exa /answer - Analyzes the content to extract structured company information
Users can add up to 2 competitors manually. Auto-discovered competitors (10 from onboarding) don’t count toward this limit.

​
How It Works

The two-step approach ensures accurate data extraction:
  1. First, we fetch the website content using Exa’s /contents endpoint with livecrawl: "fallback" to get fresh data
  2. Then, we pass that content to Exa’s /answer endpoint which uses an LLM to extract the company name, description, products, and target market in a structured format

​
Request Body

FieldTypeRequiredDescription
urlstringYesCompetitor website URL

​
Example Request

curl -X POST https://searchcompany-main.up.railway.app/api/explore/add-competitor \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://lululemon.com"}'

​
Example Response (Success)

{
  "status": "success",
  "competitor": {
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "name": "Lululemon",
    "url": "https://lululemon.com",
    "description": "Lululemon Athletica is a Canadian athletic apparel company known for yoga pants and technical athletic wear.",
    "favicon_url": "https://www.google.com/s2/favicons?domain=lululemon.com&sz=64",
    "source": "user_added"
  }
}

​
Example Response (Limit Reached)

{
  "status": "error",
  "error": "You can only add up to 2 competitors manually. Remove one to add another."
}

​
Example Response (Already Exists)

{
  "status": "error",
  "error": "This competitor has already been added"
}

​
Response Fields

FieldTypeDescription
statusstring"success" or "error"
competitorobjectThe added competitor (on success)
errorstringError message (on failure)

​
Competitor Fields

FieldTypeDescription
idstringUnique competitor ID (UUID)
namestringCompany name (extracted via Exa /answer)
urlstringCompany website URL
descriptionstringBrief description of the company
favicon_urlstringURL to company favicon (via Google’s favicon service)
sourcestringAlways "user_added" for this endpoint

​
Timing

The request typically completes in 3-8 seconds depending on website complexity.