Name: Keyword Intelligence
Brand: quickpod
SKU: api-quickpod-aiquick-keyword
Availability: InStock
Author: API Market

Anil Singh

# Keyword Intelligence

## Overview

The Keyword Intelligence API provides a powerful way to discover high-signal keyword opportunities by leveraging real web-scale lookup data. It helps you explore domain ideas, compare likely matches, and build internal tools for naming and discovery by connecting search terms to relevant domains and related keywords.

With Keyword Intelligence, you can send a term query and receive a ranked list of matching domains, or identify domains similar to a target domain based on shared keyword overlap. You can also expand a keyword into a list of related keyword candidates. The API's responses are compact, making them ideal for fast integration into various downstream workflows, from populating UI suggestions to feeding into further ranking systems.

## Features

- **Domain Keyword Search:** Find top domains associated with a query term using keyword hit and overlap signals.
- **Similar Domain Discovery:** Identify domains that share the strongest keyword overlap with a given target domain.
- **Keyword Expansion:** Generate closely related keyword candidates from extensive lookup data, with intelligent fallbacks.
- **Real Web-Scale Data:** Powered by comprehensive, real-time web lookup data for accurate and relevant results.
- **Fast & Reliable:** Designed for quick integration and dependable performance in production environments.
- **Compact Responses:** Easy-to-process JSON output for seamless integration into applications and workflows.

## Use Cases

1.  **Competitive Domain Analysis:** Identify competitors or similar service providers by searching for domains ranking for specific industry keywords, allowing businesses to understand market positioning and uncover new market entrants.
2.  **Content Gap Analysis:** Expand a seed keyword to find related terms and topics, helping content creators and SEO strategists discover new content ideas and fill gaps in their existing content strategies.
3.  **New Product/Service Naming & Discovery:** Explore available domain names or brand ideas related to a product concept or topic by searching for relevant domains, aiding in brand development and online presence planning.
4.  **SEO Keyword Research Tools:** Integrate the API into custom SEO tools to provide users with instant keyword suggestions, domain-to-keyword relationships, and competitive insights, enhancing their research capabilities.
5.  **Market Research & Trend Spotting:** Analyze top domains associated with emerging keywords or trends to quickly gauge industry interest and identify influential players, supporting strategic business decisions.

## Pricing

- 1 API unit equals 1 keyword or domain lookup request.
- Different pricing tiers are available based on usage volume.

## API Documentation

### Base URL

All API requests should be made to: `https://prod.api.market/api/v1/quickpod/aiquick-keyword`

### Authentication

Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### 1. Service health

**GET `/health`**

Returns a simple `ok: true` if the service is operational.

**Parameters:**
- `x-api-market-key`: (Header, `string`, **Required**) Your API.market API Key.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-keyword/health" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "ok": true
}
```

#### 2. Keyword dataset health

**GET `/kdb/health`**

Returns the availability status of the underlying keyword dataset.

**Parameters:**
- `x-api-market-key`: (Header, `string`, **Required**) Your API.market API Key.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-keyword/kdb/health" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "status": "available",
  "duckdb_path": "/data/kdb.duckdb",
  "table": "keywords",
  "error": null
}
```

#### 3. Search domains by keyword intent

**GET `/kdb/search-domains`**

Returns top domains associated with the query term using keyword hit and overlap signals. This endpoint is useful for exploring domain ideas, comparing likely matches, or building internal tools for naming and discovery.

**Parameters:**
- `term`: (Query, `string`, **Required**) The keyword intent to search for. Minimum length: 1 character.
  - Example: `ecommerce seo`
- `limit`: (Query, `integer`, Optional) The maximum number of domains to return. Minimum: 1, Maximum: 2000.
  - Default: `200`
- `x-api-market-key`: (Header, `string`, **Required**) Your API.market API Key.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-keyword/kdb/search-domains?term=ecommerce%20seo&limit=5" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "query": "ecommerce seo",
  "limit": 5,
  "results": [
    {
      "domain": "shopify.com",
      "score": 0.98,
      "matched_keywords": 120,
      "total_hits": 500000
    },
    {
      "domain": "bigcommerce.com",
      "score": 0.92,
      "matched_keywords": 95,
      "total_hits": 450000
    },
    {
      "domain": "magento.com",
      "score": 0.88,
      "matched_keywords": 80,
      "total_hits": 400000
    },
    {
      "domain": "wix.com",
      "score": 0.85,
      "matched_keywords": 70,
      "total_hits": 380000
    },
    {
      "domain": "squarespace.com",
      "score": 0.83,
      "matched_keywords": 65,
      "total_hits": 350000
    }
  ]
}
```

#### 4. Find domains similar to a target domain

**GET `/kdb/similar-domains`**

Identifies domains that share the strongest keyword overlap with the input domain. This helps in competitive analysis, identifying industry peers, or expanding a target domain's footprint.

**Parameters:**
- `domain`: (Query, `string`, **Required**) The target domain to find similar domains for. Minimum length: 1 character.
  - Example: `shopify.com`
- `limit`: (Query, `integer`, Optional) The maximum number of similar domains to return. Minimum: 1, Maximum: 200.
  - Default: `25`
- `x-api-market-key`: (Header, `string`, **Required**) Your API.market API Key.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-keyword/kdb/similar-domains?domain=shopify.com&limit=3" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "query": "shopify.com",
  "results": [
    {
      "domain": "bigcommerce.com",
      "score": 0.95,
      "shared_keyword_count": 8500
    },
    {
      "domain": "wix.com",
      "score": 0.88,
      "shared_keyword_count": 7200
    },
    {
      "domain": "squarespace.com",
      "score": 0.82,
      "shared_keyword_count": 6500
    }
  ]
}
```

#### 5. Expand a keyword into related keywords

**GET `/kdb/similar-keywords`**

Returns closely related keyword candidates from lookup data, with fallback intelligence when needed. This is invaluable for content strategy, SEO research, and understanding semantic relationships between terms.

**Parameters:**
- `keyword`: (Query, `string`, **Required**) The seed keyword to expand. Minimum length: 1 character.
  - Example: `technical seo`
- `limit`: (Query, `integer`, Optional) The maximum number of similar keywords to return. Minimum: 1, Maximum: 200.
  - Default: `25`
- `x-api-market-key`: (Header, `string`, **Required**) Your API.market API Key.

**Example Request:**
```bash
curl -X GET "https://prod.api.market/api/v1/quickpod/aiquick-keyword/kdb/similar-keywords?keyword=technical%20seo&limit=3" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response (200 OK):**
```json
{
  "query": "technical seo",
  "results": [
    {
      "keyword": "on-page seo",
      "score": 0.91,
      "pair_count": 7800
    },
    {
      "keyword": "off-page seo",
      "score": 0.87,
      "pair_count": 7100
    },
    {
      "keyword": "local seo",
      "score": 0.83,
      "pair_count": 6500
    }
  ]
}
```

## Status Codes

- **200 OK**: Request successful. The response body contains the requested data.
- **400 Bad Request**: Invalid input parameters or malformed request. Check the request body and query parameters against the API documentation.
  - Example: Missing required `term` or `domain` parameter.
- **401 Unauthorized**: Missing or invalid API key. Ensure the `x-api-market-key` header is present and contains a valid key.
- **403 Forbidden**: Valid API key but insufficient permissions for the requested operation. Contact support if you believe this is an error.
- **404 Not Found**: The requested resource or endpoint does not exist. Verify the URL path.
- **429 Too Many Requests**: Rate limit exceeded. Slow down your requests and implement a retry mechanism with exponential backoff.
- **500 Internal Server Error**: A generic server-side error occurred. This indicates an unexpected issue on the API provider's end.
- **503 Service Unavailable**: The service is temporarily unavailable, possibly due to maintenance or overload. Retry the request after a short delay.

## Rate Limits

Specific rate limits are enforced to ensure fair usage and stability of the service. If you exceed the allocated request rate, you will receive a `429 Too Many Requests` status code. Implement exponential backoff in your retry logic to handle these responses gracefully. Contact support if your usage requires higher limits.

## Error Handling

Effective error handling is crucial for building robust applications.
- **Interpret Error Responses**: Always inspect the HTTP status code. For `4xx` and `5xx` errors, the response body will often contain a JSON object with a `detail` field providing more information.
    ```json
    {
      "detail": "Invalid or missing API key"
    }
    ```
    or for specific endpoint errors:
    ```json
    {
      "detail": {
        "loc": [ "query", "term" ],
        "msg": "field required",
        "type": "value_error.missing"
      }
    }
    ```
- **Common Errors**:
  - **401 Unauthorized**: Check if your `x-api-market-key` header is correctly set and the key is valid.
    - **400 Bad Request**: Review the endpoint's parameter requirements. Ensure all required query parameters are present and correctly formatted (e.g., `term`, `domain`, `keyword`).
    - **503 Service Unavailable**: This can occur if the underlying dataset is temporarily unavailable or if the service is under heavy load. The `/kdb/health` endpoint can provide insight into dataset availability.
- **Retry Strategies**: For transient errors (e.g., `429 Too Many Requests`, `503 Service Unavailable`, or network timeouts), implement a retry mechanism with exponential backoff. This means waiting progressively longer between retries to avoid overwhelming the service. For example, retry after 1s, then 2s, then 4s, up to a maximum number of retries or a total timeout.

## FAQ

**What kind of data does Keyword Intelligence use?**

The API leverages real web-scale lookup data to provide accurate and relevant keyword and domain insights.

**Is the API synchronous or asynchronous?**

The Keyword Intelligence API is synchronous. All requests return the final results directly in the response.

**How do I authenticate my requests?**

You authenticate by including your `API_MARKET_KEY` in the `x-api-market-key` header of your requests.

**What if I need more results than the default limit?**

You can specify a higher `limit` parameter in your request, up to the maximum allowed for each endpoint (e.g., 2000 for `/kdb/search-domains`, 200 for others).

**How can I check if the service is operational?**

You can use the `/health` endpoint to check the general service status and the `/kdb/health` endpoint to check the availability of the keyword dataset.

**What should I do if I get a `429 Too Many Requests` error?**

This means you've exceeded your rate limit. You should slow down your requests and implement a retry mechanism with exponential backoff.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Discover related keywords and similar domains from real web-scale lookup data. Search domains and expand keyword sets for SEO and content strategy.