Skip to main content
Get full details for a specific competitor, including scraped content for chat context.

Path Parameters

ParameterTypeRequiredDescription
competitor_idstringYesCompetitor UUID

Example Request

curl -X GET https://searchcompany-main.up.railway.app/api/explore/competitor/550e8400-e29b-41d4-a716-446655440002 \
  -H "Authorization: Bearer $TOKEN"

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://storage.supabase.co/favicons/competitors/ghi789.png",
    "scraped_content": "Lululemon Athletica is a Canadian athletic apparel company known for yoga pants and technical athletic wear.\n\nFounded in 1998 in Vancouver, they focus on yoga, running, and training apparel. Key products include their signature Align leggings, ABC pants for men, and technical outerwear.",
    "source": "user_added",
    "created_at": "2025-12-28T09:30:00Z"
  }
}

Example Response (Not Found)

{
  "status": "error",
  "error": "Competitor not found"
}

Response Fields

FieldTypeDescription
statusstring"success" or "error"
competitorobjectFull competitor details (on success)
errorstringError message (on failure)

Competitor Detail Fields

FieldTypeDescription
idstringUnique competitor ID (UUID)
namestringCompany name
urlstringCompany website URL
descriptionstringBrief description
favicon_urlstringURL to company favicon
scraped_contentstringFull scraped content for chat context
sourcestring"auto_discovered" or "user_added"
created_atstringISO timestamp of when competitor was added