kwrds.ai

LSI Semantic Keywords API

Quickstart

curl --location 'https://keywordresearch.api.kwrds.ai/lsi' \
--header 'X-API-KEY: YOUR_API_KEY_GOES_HERE' \
--header 'Content-Type: application/json' \
--data '{
    "search_question": "tesla cybertruck",
    "search_country": "en-US"
}'

To increase your API limits, please choose your plan right from our pricing page.

Introduction

The LSI Semantic Keywords API helps you discover semantically related keywords for your target keyword. LSI (Latent Semantic Indexing) keywords are contextually related terms that help search engines better understand your content's topic and context. This API combines data from multiple sources including Google API, LLM-generated suggestions, SERP analysis, and other sources to provide comprehensive LSI keyword recommendations.

Watch LSI Keywords in Action

Discover how LSI keywords can enhance your SEO strategy. Learn practical tips to improve your content and boost search engine visibility.

Watch demo video

Watch video

Read our full guide on LSI Keywords to learn more about how to use them to boost your SEO strategy.

Endpoint

POST /lsi

This endpoint retrieves LSI semantic keywords and their metrics for a given keyword.

Example Request

Here's an example of how to use the LSI Semantic Keywords API with cURL:

curl --location 'https://keywordresearch.api.kwrds.ai/lsi' \
--header 'X-API-KEY: YOUR_API_KEY_GOES_HERE' \
--header 'Content-Type: application/json' \
--data '{
    "search_question": "tesla cybertruck",
    "search_country": "en-US"
}'

Request Body

• search_question: (Required) The keyword for which you want to find LSI semantic keywords.
• search_country: (Required) The country code (e.g., en-US) for which the search should be localized. The first part is the ISO 639-1 language code, and the second part is the ISO 3166-1 alpha-2 country code.

Headers

• X-API-KEY: (Required) Your API key for authentication.
• Content-Type: (Required) The content type of the request, which should be application/json.

Example Response

The API returns a JSON array containing detailed metrics for the LSI semantic keywords. Here's an example response:

[
    {
        "keyword": "tesla cybertruck specs",
        "volume": 165000,
        "cpc": 1.25,
        "search-intent": "Informational",
        "competition_value": "HIGH"
    },
    {
        "keyword": "cybertruck release date",
        "volume": 135000,
        "cpc": 0.95,
        "search-intent": "Informational",
        "competition_value": "MEDIUM"
    }
]

Response Structure

Each object in the response array contains:

• keyword: The LSI semantic keyword
• volume: Monthly search volume for the keyword
• cpc: Cost per click for the keyword
• search-intent: Search intent classification (e.g., "Informational", "Commercial", etc.)
• competition_value: Competition level for the keyword

Use Cases

The LSI Semantic Keywords API can be used for:

1. Content Optimization: Enhance your content with semantically related keywords
2. Topic Research: Understand the broader context and related concepts
3. SEO Strategy: Improve topical relevance and search engine rankings
4. Content Gap Analysis: Identify missing semantic keywords in your content

Best Practices

1. Use Relevant Language Codes: Always specify the correct language and country code for targeted results
2. Error Handling: Implement proper error handling for various HTTP status codes

Error Handling

The LSI Semantic Keywords API returns standard HTTP status codes:

• 200 OK: Request successful
• 400 Bad Request: Invalid request parameters
• 401 Unauthorized: Missing or invalid API key
• 403 Forbidden: Insufficient permissions or plan limitations
• 404 Not Found: No LSI keywords found
• 429 Too Many Requests: Rate limit exceeded
• 500 Internal Server Error: Server-side error

Next Steps

Now that you understand how to use the LSI Semantic Keywords API, you can start integrating it into your content optimization workflow. For questions or support, contact hello@kwrds.ai.