---
title: Analyze AI Search Performance API
slug: ai-search
url: https://apyhub.com/se-ranking/service/ai-search
provider: "SE Ranking SEO & AI Search API"
categories: [Artificial Intelligence, Marketing, SEO]
auth: api_key
---

# Analyze AI Search Performance API

Measure how visible a domain or brand is inside ChatGPT, Gemini, and Perplexity answers. Powered by SE Ranking data for AI search monitoring.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/by-engine/time-series` | What it does Returns an AI search overview for a given engine, source, and target as a JSON object… | 4000 |
| GET | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/discover-brand` | What it does Discovers brand names from the supplied target and source values using the selected sc… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/aggregated/time-series` | What it does Retrieves an aggregated AI search overview across engines for the requested target and… | 10000 |
| POST | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/leaderboard` | What it does Returns an AI search leaderboard for a primary target and up to 10 competitors, using… | 40000 |
| GET | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/prompts-by-target` | What it does Returns a list of prompts for the specified engine, target, source, and scope, with op… | 10000 |
| GET | `https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/prompts-by-brand` | What it does Returns a list of prompts for a given brand and source, with optional sorting and filt… | 10000 |

## Examples

### Get AI Search Overview — Single Engine (Trend)

#### Quickstart

Fetch the time-series overview for an AI search engine by passing the required query parameters.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/by-engine/time-series?engine=ai-overview&source=us&target=seranking.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with two top-level objects: `summary` and `time_series`.

- `summary` contains `link_presence`, `brand_presence`, `average_position`, and `ai_opportunity_traffic`, each as an object with `current`, `previous`, `change_percent`, and `change_absolute` number fields.
- `time_series` contains arrays for `ai_traffic`, `link_presence`, `organic_traffic`, `overall_traffic`, and `average_position`; each array item has a `date` string in `YYYY-MM` format and a numeric `value`.

```json
{
  "summary": {
    "link_presence": {
      "current": 0,
      "previous": 0,
      "change_percent": 0,
      "change_absolute": 0
    }
  },
  "time_series": {
    "ai_traffic": [
      {
        "date": "2024-01",
        "value": 0
      }
    ]
  }
}
```

### discover brand

#### Quickstart

Find brand suggestions for a target by passing the required query parameters in a simple GET request.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/discover-brand?source=us&target=seranking.com&scope=base_domain" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `brands` array of strings. Each string is a discovered brand name.

```json
{
  "brands": [
    "Example"
  ]
}
```

### Get AI Search Overview — All Engines (Trend)

#### Quickstart

Compare AI search metrics for a target against a source using the required query parameters.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/aggregated/time-series?source=us&target=seranking.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with optional `summary` and `time_series` objects.

- `summary` contains metric objects such as `link_presence`, `brand_presence`, `average_position`, and `ai_opportunity_traffic`, each with `current`, `previous`, `change_percent`, and `change_absolute` numbers.
- `time_series` contains arrays such as `ai_traffic`, `link_presence`, `organic_traffic`, `overall_traffic`, and `average_position`, where each item has a `date` string in `YYYY-MM` format and a numeric `value`.

```json
{
  "summary": {
    "link_presence": {
      "current": 12.5,
      "previous": 10.2,
      "change_percent": 22.55,
      "change_absolute": 2.3
    }
  },
  "time_series": {
    "ai_traffic": [
      { "date": "2024-05", "value": 120.4 }
    ]
  }
}
```

### Compare Brand vs Competitors (AI Leaderboard)

#### Quickstart

Compare one primary brand against at least one competitor across selected AI engines.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/overview/leaderboard" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "us",
    "engines": ["ai-overview"],
    "primary": {
      "brand": "SE Ranking",
      "target": "seranking.com"
    },
    "competitors": [
      { "brand": "Semrush", "target": "semrush.com" }
    ]
  }'
```

#### What you'll get back

Returns a JSON object with three top-level fields: `results` is an object keyed by domain, then by engine; `leaderboard` is an array of ranked result objects; and `request_metadata` is an object summarizing the request context.

```json
{
  "results": {},
  "leaderboard": [
    {
      "rank": 1,
      "domain": "example.com",
      "link_presence": 1,
      "brand_presence": 1,
      "share_of_voice": 0.75,
      "is_primary_target": true
    }
  ],
  "request_metadata": {
    "source": "example.com",
    "engines": ["ai-overview"],
    "primary": "Example",
    "competitors": ["Competitor"]
  }
}
```

### prompts by target

#### Quickstart

Fetch prompts for a target search term with the required query parameters.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/prompts-by-target?engine=ai-mode&target=seranking.com&source=us&scope=base_domain" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `date` as a string date, `total` as an integer, and `prompts` as an array of objects. Each prompt object can include `type`, `answer` (with `text` and `links`), `prompt`, and `volume`.

```json
{
  "date": "2026-07-27",
  "total": 1,
  "prompts": [
    {
      "type": "Link",
      "answer": {
        "text": "Some example answer",
        "links": ["https://example.com"]
      },
      "prompt": "ai search prompts",
      "volume": 100
    }
  ]
}
```

### prompts by brand

#### Quickstart

Fetch brand-related prompts by passing the required query parameters for engine, brand, and source.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/ai-search/v1/ai-search/prompts-by-brand?engine=perplexity&brand=SE%20Ranking&source=us" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with `date` as a string in `YYYY-MM-DD` format, `total` as an integer, and `prompts` as an array of prompt objects.

Each prompt object can include `type` (string), `answer` (object with `text` and `links`), `prompt` (string), and `volume` (integer).

```json
{
  "date": "2026-07-27",
  "total": 1,
  "prompts": [
    {
      "type": "Brand",
      "answer": {
        "text": "Example answer",
        "links": ["https://example.com"]
      },
      "prompt": "Example prompt",
      "volume": 100
    }
  ]
}
```

## About

## What it does
AI Search Analytics helps you measure how a brand or domain appears in AI search results. Send a target and source, and get back brand matches, prompt data, and visibility metrics you can use to track presence across AI engines.

Use the discovery endpoint to find brands associated with a URL, domain, base domain, or full URL. For prompt analysis, query by target brand or by brand name and receive a dated response with totals plus a `prompts` array. Each prompt includes the prompt text, its type, the answer text, any links, and volume. You can sort by volume, type, or snippet length, and filter by volume, keyword count, character count, and multi-keyword inclusion or exclusion.

For performance tracking, the overview endpoints return summary metrics and monthly time series for AI traffic, link presence, organic traffic, overall traffic, and average position. Use the aggregated view to compare performance across engines, or the leaderboard endpoint to compare a primary target against up to 10 competitors and see share of voice, link presence, and brand presence by engine.

Build reporting dashboards, monitor competitor visibility, or audit how often your brand is cited versus linked in AI-driven search experiences.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/se-ranking/service/ai-search