---
title: Research Keywords API
slug: keyword-research
url: https://apyhub.com/se-ranking/service/keyword-research
provider: "SE Ranking SEO & AI Search API"
categories: [SEO]
auth: api_key
---

# Research Keywords API

Run comprehensive keyword analysis and discovery for any term. Powered by SE Ranking data for search volume, difficulty, and content planning.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/export` | What it does Exports bulk keyword metrics for the keywords you submit, using the selected source qu… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/longtail` | What it does Retrieves longtail keyword suggestions for a given source and keyword. The response re… | 100 |
| GET | `https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/similar` | What it does Returns a list of keywords similar to the keyword you provide, along with the total nu… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/questions` | What it does Returns question keyword suggestions for the provided keyword and source, with optiona… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/related` | What it does Returns related keywords for the source and keyword query inputs, with optional sortin… | 1000 |

## Examples

### Export Keywords Metrics

#### Quickstart

Export keyword research results for a source and a list of keywords.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/export?source=de" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["seo tools"]}'
```

#### What you'll get back

Returns a JSON array of objects. Each object can include `keyword`, `cpc`, `volume`, `intents`, `difficulty`, `competition`, `history_trend`, and `is_data_found`.

```json
[
  {
    "keyword": "seo tools",
    "cpc": 2.34,
    "volume": 5400,
    "intents": ["I"],
    "difficulty": 42,
    "competition": 0.61,
    "history_trend": {
      "2026-01-01": 5200
    },
    "is_data_found": true
  }
]
```

### Get longtail keywords

#### Quickstart

Get long-tail keyword suggestions for a source and keyword, with optional pagination in the query string.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/longtail?source=de&keyword=running%20shoes" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `total` integer and a `keywords` array of strings.

```json
{
  "total": 3,
  "keywords": ["best running shoes for men", "running shoes for flat feet", "lightweight running shoes"]
}
```

### Get similar keywords

#### Quickstart

Fetch similar keywords for a given source and keyword, using the required query parameters.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/similar?source=de&keyword=coffee"
-H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `total` integer and a `keywords` array. Each item in `keywords` is an object that can include `keyword`, `volume`, `cpc`, `intents`, `difficulty`, `competition`, `history_trend`, and `serp_features`.

```json
{
  "total": 2,
  "keywords": [
    {
      "keyword": "coffee beans",
      "volume": 90500,
      "cpc": 1.24,
      "intents": ["I", "T"],
      "difficulty": 42,
      "competition": 0.37,
      "history_trend": null,
      "serp_features": ["Featured snippet"]
    }
  ]
}
```

### Get question keywords

#### Quickstart

Search for question-style keyword ideas for a source and keyword.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/questions?source=de&keyword=seo+tools" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `total` integer and a `keywords` array. Each item in `keywords` is an object that may include `keyword`, `volume`, `cpc`, `difficulty`, `competition`, `intents`, `history_trend`, and `serp_features`.

```json
{
  "total": 2,
  "keywords": [
    {
      "keyword": "seo tools for small business",
      "volume": 2400,
      "cpc": 1.85,
      "difficulty": 36,
      "competition": 0.42,
      "intents": ["I", "C"],
      "history_trend": null,
      "serp_features": ["Featured snippet", "People also ask"]
    }
  ]
}
```

### Get related keywords

#### Quickstart

Search for related keywords for a given source and keyword using the required query parameters.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/keyword-research/v1/keywords/related?source=de&keyword=keyword+research" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `total` integer and a `keywords` array. Each item in `keywords` is an object that can include fields like `keyword` and `volume`, along with other keyword metrics from the schema.

```json
{
  "total": 2,
  "keywords": [
    {
      "keyword": "keyword research tools",
      "volume": 1900,
      "cpc": 1.24,
      "relevance": 98
    }
  ]
}
```

## About

This collection of endpoints is designed for comprehensive keyword analysis and discovery. Use these requests to retrieve performance metrics for large lists of keywords or to generate new keyword ideas based on a seed term.
This folder is divided into two main categories:

Bulk Keyword Metrics
- Export Keywords Metrics: Submit a list of up to 5,000 keywords to get detailed data points for each, including search volume, CPC, competition score, keyword difficulty, and historical search volume trends. This is ideal for bulk analysis and data enrichment.

Keyword Discovery | Use these endpoints to expand your keyword lists and uncover new ranking opportunities.
- Get Similar Keywords: Find keywords that are semantically similar to your seed keyword, including synonyms and close variations.
- Get Related Keywords: Discover keywords that are topically related, based on having a high number of overlapping URLs in their search results.
- Get Question Keywords: Generate a list of keywords phrased as common user questions, perfect for content marketing and FAQ creation.
- Get Longtail Keywords: Find longer, more specific keyword phrases that often have lower competition and higher conversion rates.

## 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/keyword-research