This API provides **search autocomplete keyword suggestions**, **alphabet expansion**, and **question-based keyword ideas** with **country-wise and language-wise filtering**, along with **estimated search volume**, **competition level**, and **CPC values** for each keyword. It is designed for **SEO tools**, **keyword research platforms**, **content creators**, and **marketing applications** that need fast and scalable keyword discovery. ---

Getting Started

To begin using this API, follow these steps and make your first API call: **Subscribe to a plan:** Visit our Pricing page and subscribe to one of the available plans. If you are just starting, you can subscribe to the free **BASIC** plan (hard-limited and no credit card required). **Make your first API call:** Visit the RapidAPI Playground — the **Autocomplete Keywords** endpoint should be selected and displayed on the main panel view. Since default query parameters are already set, simply click the blue **“Test endpoint”** button to make your first API call. The JSON response will be displayed on the right panel. **Documentation and Resources:** Refer to the detailed endpoint descriptions, input parameters, and response examples provided in the **Endpoints** tab. Code snippets are available for JavaScript, Python, Java, Shell, and more to help you integrate quickly. You should be good to go now! ---

Authentication

To authenticate with the API, send the **X-RapidAPI-Host** header along with the **X-RapidAPI-Key** header set to your RapidAPI App API Key (as shown in the endpoint Code Snippets). ---

Input Parameters

The following query parameters are supported by the API: **query** (required) Base keyword or phrase for which autocomplete suggestions are generated. Example: `best seo tools` **country** (optional) Country code for location-based keyword suggestions. Format: ISO 2-letter country code Example: `US`, `GB`, `IN` Default: `US` **language** (optional) Language code for keyword suggestions. Format: ISO language code Example: `en`, `es`, `fr`, `de` Default: `en` **limit** (optional) Maximum number of keyword suggestions returned. Default: `100` ---

Response Structure

Here’s an example of a successful response: ``` { "success": true, "input": { "query": "best seo tools", "country": "US", "language": "en" }, "keywords": [ { "keyword": "best seo tools for beginners", "estimated_search_volume": 5400, "competition": 0.42, "cpc_usd": 2.15 }, { "keyword": "best seo tools free", "estimated_search_volume": 8100, "competition": 0.37, "cpc_usd": 1.84 }, { "keyword": "how to choose seo tools", "estimated_search_volume": 2900, "competition": 0.29, "cpc_usd": 1.12 } ], "total_results": 3 } ``` --- Please note that some errors might be returned by the RapidAPI gateway and will have a different structure. Please refer to the **Error Handling / Error Response Structure** section for more details. In addition, RapidAPI gateway adds several headers to each response. For more information, please refer to: [https://docs.rapidapi.com/docs/response-headers](https://docs.rapidapi.com/docs/response-headers) ---

Endpoints

For detailed endpoint parameters, response fields, and live testing, please refer to the **Endpoints** section of this API. ---

Rate Limiting

Each subscription plan defines the maximum number of requests permitted per month, along with a rate limit expressed in **RPS (Requests Per Second)**. All free plans (such as **BASIC**) are limited to **1000 requests per hour**, as required by RapidAPI. ---

Rate Limits Headers

All API responses include the following rate limit headers: **x-ratelimit-requests-limit:** Total number of requests allowed by your subscription **x-ratelimit-requests-remaining:** Remaining requests before reaching the quota limit **x-ratelimit-requests-reset:** Time in seconds until the quota resets ---

Handling Limits

When rate limits are exceeded, the API will return a **429 Too Many Requests** error. ``` { "message": "Too many requests" } ``` Wait until the limit resets or upgrade your subscription plan for higher limits. ---

Code Examples

Code examples for JavaScript, Python, Java, Shell, and other popular languages are available in the **Endpoints** tab under **Code Snippets**. ---

Common HTTP Status Codes

**400 Bad Request:** Missing or invalid parameters **403 Forbidden:** Invalid API key or no active subscription **404 Not Found:** Invalid endpoint **429 Too Many Requests:** Rate limit exceeded **5XX Server Error:** Temporary server-side issue ---

Support

If you encounter any issues or need clarification, please contact us with the error code, message, and request context, and we will assist you promptly. ---

Contact Us

For custom plans, enterprise usage, or high-volume requests: **Email:** [alreadycoded@gmail.com](mailto:alreadycoded@gmail.com) **Website:** [https://www.alreadycoded.com](https://www.alreadycoded.com)