Kwrds.ai Integration with SmythOS
Want to power your content strategy with AI-driven insights? Connect Kwrds.ai to SmythOS and empower your agents to perform advanced keyword research and SERP analysis automatically.
List of Kwrds.ai Components
Quickly compare Kwrds.ai components by what they do and their key I/O. Click any component name to jump directly to its detailed guide.
Component | Action | What it Does | Inputs | Key Outputs | Use Case |
---|---|---|---|---|---|
Keyword Research | Research | Retrieves core metrics (volume, CPC, competition) for a keyword. | required search_question | volume , cpc | Analyzing the value of a target keyword. |
Related Keywords | Research | Finds a list of semantically related keywords. | required search_question | keywords | Expanding a content topic cluster. |
People Also Ask | Research | Retrieves "People Also Ask" questions from Google for a keyword. | required keyword | results | Creating FAQ sections and answering user questions. |
Search Volume | Research | Gets search volume and other metrics for a batch of keywords. | required keywords | volume , cpc | Quickly analyzing a list of potential keywords. |
SERP | Research | Fetches the Search Engine Results Page (SERP) data for a query. | required search_question | serp , pasf | Analyzing top-ranking competitors for a keyword. |
AI Keyword Generation | Generate | Uses AI to generate new keyword ideas based on a seed topic. | required search_question | Response | Brainstorming new content ideas and keyword targets. |
Prerequisites
Before you begin, please ensure you have the following:
- An active SmythOS account. (Sign up here).
- A Kwrds.ai account.
- Your Kwrds.ai API Key.
Getting Started With Kwrds.ai
The connection between SmythOS and Kwrds.ai is configured using a secure API Key.
Step 1: Get Your Kwrds.ai API Key
- Log in to your Kwrds.ai account.
- Navigate to your Account settings page.
- In the API Key section, your key will be displayed. Copy it to your clipboard.
Step 2: Store Your API Key in SmythOS Vault
Your API Key is a sensitive credential. Use the SmythOS Vault
to store it securely.
- In your SmythOS dashboard, navigate to the Vault.
- Create a new secret and paste your Kwrds.ai API Key as the value. Give it a memorable name, like
kwrdsai_api_key
. - For more details, see the Vault Documentation.
Step 3: Configure a Kwrds.ai Component
- In your SmythOS agent graph, drag and drop any Kwrds.ai component.
- Click the component to open its Settings panel.
- In the
Kwrds API key
field, select the secret you saved in the Vault (e.g.,kwrdsai_api_key
). - Your connection is now configured for that component.
Which Kwrds.ai Component Should I Use?
If you need to… | Target | Use this Component | Why this one? |
---|---|---|---|
Get all core metrics for a single keyword | A search query | Keyword Research | Provides a comprehensive overview (volume, CPC, intent) for one keyword. |
Understand what questions users are asking | A keyword | People Also Ask | Directly fetches the PAA box from Google SERPs, perfect for content ideation. |
Find new keywords related to a topic | A seed keyword | Related Keywords | Expands your keyword list with semantically similar terms. |
Analyze the top 10 results for a query | A search query | SERP | Gives you the actual search results page data for competitor analysis. |
Quickly get search volume for a long list of keywords | An array of keywords | Search Volume | Optimized for bulk processing of keyword lists. |
Brainstorm completely new ideas | A seed topic | AI Keyword Generation | Leverages AI to come up with creative and relevant keyword suggestions. |
Component Details
This section provides detailed information for each Kwrds.ai component.
Keyword Research
Retrieves a comprehensive set of data, including search volume, CPC, and competition, for a single keyword.
Inputs
Field | Type | Required | Notes |
---|---|---|---|
search_question | string | Yes | The keyword or question to research. |
search_country | string | Optional | The locale for the search (e.g., en-GB ). Default: en-US . |
Outputs
Field | Type | Description |
---|---|---|
volume | integer | The monthly search volume for the keyword. |
cpc | float | The average Cost Per Click for the keyword. |
search_intent | string | The likely user intent (e.g., informational, transactional). |
competition_value | float | A score indicating advertiser competition. |
Response | object | The full, raw JSON response from the Kwrds.ai API. |
People Also Ask
Retrieves the list of questions that appear in Google's "People Also Ask" box for a given keyword.
Inputs
Field | Type | Required | Notes |
---|---|---|---|
keyword | string | Yes | The keyword to find related questions for. |
search_country | string | Optional | Two-letter country code. Default: US . |
search_language | string | Optional | Two-letter language code. Default: en . |
Outputs
Field | Type | Description |
---|---|---|
results | array | An array of strings, where each string is a question from the PAA box. |
Response | object | The raw JSON response from the API. |
Related Keywords
Retrieves a list of keywords that are semantically related to a given keyword.
Inputs
Field | Type | Required | Notes |
---|---|---|---|
search_question | string | Yes | The seed keyword or question. |
search_country | string | Optional | The locale for the search. Default: en-US . |
Outputs
Field | Type | Description |
---|---|---|
keywords | array | An array of related keyword objects, each with its own volume, cpc, etc. |
Response | object | The raw JSON response from the API. |
SERP
Returns the live Search Engine Results Page (SERP) data for a given query.
Inputs
Field | Type | Required | Notes |
---|---|---|---|
search_question | string | Yes | The keyword or question to search for. |
search_country | string | Optional | The locale for the search. Default: en-US . |
Outputs
Field | Type | Description |
---|---|---|
serp | array | An array of objects representing the top search results (URL, title, description). |
pasf | array | An array of "People Also Search For" queries. |
Response | object | The raw JSON response from the API. |
Best Practices & Advanced Tips
- Secure Your API Key: Always store your Kwrds.ai API key in the SmythOS
Vault
. - Chain Components for Deep Research: The real power comes from combining these components. Start with
AI Keyword Generation
, validate the ideas withSearch Volume
, find questions withPeople Also Ask
, and analyze competitors withSERP
. - Use a Loop for Bulk Analysis: To analyze a large list of keywords, use a
Loop
component in SmythOS. Inside the loop, call theKeyword Research
component for each keyword and log the results to a Google Sheet or database. - Localize Your Research: Always specify the
search_country
andsearch_language
to get the most accurate and relevant data for your target audience.
Troubleshooting Common Issues
-
Error:
401 Unauthorized
- Cause: The API Key is incorrect, has been disabled, or is missing.
- Solution: Verify that the API Key in your SmythOS Vault is correct and matches the one in your Kwrds.ai account dashboard.
-
Error:
402 Payment Required
or Quota Errors- Cause: You have exhausted the API credits available in your Kwrds.ai plan.
- Solution: Log in to your Kwrds.ai account to check your usage and upgrade your plan if necessary.
-
Empty Results
- Cause: The keyword may have very low or no search data, or the specific combination of keyword and country has no results.
- Solution: Try a broader keyword to test the connection. Double-check the
search_country
code for typos.
What's Next?
You are now ready to build powerful SEO and content strategy workflows with the SmythOS Kwrds.ai Integration!
Consider these ideas:
-
Build an Agent That...
- Acts as a "Content Brief Generator." It takes a topic, finds related keywords and "People Also Ask" questions, analyzes the top SERP results, and compiles all of it into a structured brief in a Notion document.
- Performs automated keyword clustering. The agent takes a list of keywords, fetches their SERP results, and groups them together based on how many overlapping URLs they have.
- Monitors keyword opportunities. It regularly checks a list of target keywords and sends an alert if the
competition_value
drops below a certain threshold.
-
Explore Other Integrations:
- Combine Kwrds.ai with an LLM component. Use the keyword data and PAA questions to generate a high-quality, SEO-optimized draft of a blog post.
- Feed the results of your keyword research directly into a Google Sheet to build a dynamic content calendar and tracking dashboard.
- Use the
SERP
component to find competitor articles, then use a web scraping tool to analyze their word count and structure.