---
title: "Find website competitors"
method: GET
path: "/web/competitors"
tags: ["Web Extraction"]
---

# Find website competitors

`GET /web/competitors`

Analyze a company's landing page and web search evidence to return direct competitors for the same product or market.

## Query parameters

- `domain` string, required — Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted and normalized to their domain.
- `numCompetitors` integer — Exact number of direct competitors to return. Defaults to 5.
- `timeoutMS` integer — Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).
- `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Competitor research succeeded.

- object
  - `status` 'ok', required — Status of the response.
  - `domain` string, required — Normalized input domain.
  - `target` object, required — Target company profile inferred from the landing page.
    - `companyName` string, required — Company or product name inferred from the landing page.
    - `field` string, required — Specific operating field, product category, or market.
    - `fieldDescription` string, required — One-sentence description of what the target company sells and who it serves.
    - `websiteUrl` string, required — Resolved URL used for the landing page analysis.
  - `competitors` object[], required — Direct competitors ordered by relevance and confidence.
    - `name` string, required — Competitor company or product name.
    - `domain` string, required — Competitor's normalized official domain.
    - `url` string, required — Competitor website URL.
    - `description` string, required — Short description of the competitor.
    - `confidence` 'high' | 'medium', required — Confidence that this company is a direct competitor.
    - `sourceUrls` string[], required — Search result URLs used as evidence for this competitor.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `400` — Bad request - Invalid parameters or inaccessible website
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or usage limit exceeded
- `408` — Request timeout
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/versions/182f532c2552/schema)