Fetch Competitors from Exa

Internal Service — This is not an HTTP endpoint. It’s called by the competitor research service.

Purpose

Step 2 of competitor research: Uses Exa’s Answer API to find 5 competitors based on the website content.

Function Signature

async def fetch_competitors_from_exa(api_key: str, url: str, website_content: str) -> list

Parameters

Parameter	Type	Description
`api_key`	`str`	Exa API key
`url`	`str`	Business URL (to exclude from results)
`website_content`	`str`	Content from Step 1

Returns

[
    {
        "name": "Competitor A",
        "website": "https://competitor-a.com",
        "strengths": ["strength 1", "strength 2", "strength 3"],
        "favicon_url": "https://..."
    },
    # ... 5 total
]

Prompt Engineering

The prompt instructs Exa to:

Find exactly 5 competitors
NOT include the original business
Return 3 unique strengths per competitor (10-20 chars each)
Return valid JSON format

Parsing Pipeline

Code Location

src/website/competitor_research/service.py
# Lines 90-165: fetch_competitors_from_exa()

Getting Started

Website

Onboarding

Cron

Your Current Setup

Explore

Settings - Toggle

Settings - Business

Settings - Team

Settings - Billing

Settings - Domain

Webhooks

Health

Manual Trigger

Purpose

Function Signature

Parameters

Returns

Prompt Engineering

Parsing Pipeline

Code Location

​Purpose

​Function Signature

​Parameters

​Returns

​Prompt Engineering

​Parsing Pipeline

​Code Location

Purpose

Function Signature

Parameters

Returns

Prompt Engineering

Parsing Pipeline

Code Location