---
title: "Get keywords a competitor wins"
method: GET
path: "/api/apps/{app_id}/seo/research/competitor-gap"
---

# Get keywords a competitor wins

`GET /api/apps/{app_id}/seo/research/competitor-gap`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/seo/research/competitor-gap`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Keywords a rival ranks for in Google's top 20 and this app doesn't, by the rival's traffic. Brand searches excluded. Bounded to `limit` rows; not a paginated collection. Limited to 60 requests per minute per app across all six research endpoints; responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`, and a `429` carries `Retry-After`. Paid lookups also draw on a weekly per-app budget (`429 quota_exceeded` once it is used up).

## Path parameters

- `app_id` string, required: ID of the app.

## Query parameters

- `rival` string, required: Competitor domain, e.g. example.com.
- `locale` string: Site language and market, e.g. en-US, es-MX, de. Default en-US.
- `limit` integer: Max rows.

## Response `200`

Keywords the rival wins and this app doesn't.

- unknown

## Other responses

- `400`: `invalid_request`: a parameter is empty or malformed.
- `403`: `engine_not_allowed`: the workspace's AI model settings block every engine asked.
- `404`: `not_found`: the app doesn't exist, or SEO research isn't enabled for it.
- `409`: `not_set_up`: the app has no domain or search data source to look up yet.
- `422`: `invalid_request`: a required parameter is missing or the wrong type, or out of range. `error.details.errors` lists each problem.
- `429`: `rate_limited` (request limit) or `quota_exceeded` (the app's lookup budget); both carry `Retry-After`.
- `503`: `unavailable`: the data provider failed; retry shortly.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-21** `fa29e915c226`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/seo/research/competitor-gap/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)