---
title: "Get sites linking to a competitor"
method: GET
path: "/api/apps/{app_id}/seo/research/backlink-gap"
---

# Get sites linking to a competitor

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

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/seo/research/backlink-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>

Sites that link to a rival and not to this app, strongest first. 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.

## Response `200`

Sites linking to the rival and not to this app.

- 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/backlink-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)
