competitors

Discover Competitors

Discover competitors for a company website.

Uses GPT-5 with web search to identify direct competitors. Requires authentication - competitors are stored for the authenticated user.

Modes:

  • async_mode=true (default): Returns immediately with task_id, poll /status/{task_id} for results
  • async_mode=false: Waits for completion and returns competitors directly (may take 30-60s)

Returns: 10-15 direct competitors with websites and descriptions.

post/api/v1/competitors/discover

Request

  • Base URL: https://api.trylapis.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trylapis.com/api/v1/competitors/discover
  • Auth: HTTP bearer

Query parameters

client_user_idinteger nullable

Client user ID to view data for

Headers

x-lapis-dev-tokenstring nullable
x-assume-user-idinteger nullable

Request body

website_urlstring uri required

Company website to analyze

async_modeboolean

If true, runs in background and returns task_id for polling

Example request

{
  "website_url": "https://example.com"
}

Response

Sync response with competitors

statusstring

Task status

company_namestring required

Identified company name

company_descriptionstring nullable

What the company does

industrystring nullable

Industry classification

sub_verticalstring nullable

Specific sub-vertical

elapsed_secondsnumber required

Time taken for discovery

raw_idinteger nullable

PrimaryCompetitorRaw ID

Changes

No recorded changes to this operation across all 1 revision of this API.