Skip to main content

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.

TL;DR

Securely link your Kwrds.ai account to SmythOS using an API key. Then, use our suite of components to automate the retrieval of keyword volume, CPC, "People Also Ask" questions, and other critical SEO data.

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.

ComponentActionWhat it DoesInputsKey OutputsUse Case
Keyword ResearchResearchRetrieves core metrics (volume, CPC, competition) for a keyword.required search_questionvolume, cpcAnalyzing the value of a target keyword.
Related KeywordsResearchFinds a list of semantically related keywords.required search_questionkeywordsExpanding a content topic cluster.
People Also AskResearchRetrieves "People Also Ask" questions from Google for a keyword.required keywordresultsCreating FAQ sections and answering user questions.
Search VolumeResearchGets search volume and other metrics for a batch of keywords.required keywordsvolume, cpcQuickly analyzing a list of potential keywords.
SERPResearchFetches the Search Engine Results Page (SERP) data for a query.required search_questionserp, pasfAnalyzing top-ranking competitors for a keyword.
AI Keyword GenerationGenerateUses AI to generate new keyword ideas based on a seed topic.required search_questionResponseBrainstorming new content ideas and keyword targets.
INFO
Why Integrate Kwrds.ai with Your Agent?

Kwrds.ai provides AI-powered SEO insights that are essential for modern content strategy. Integrating it with SmythOS allows you to automate the entire research and planning process.

  • Automate Keyword Discovery: Create agents that take a single topic and automatically generate a list of related keywords, find "People Also Ask" questions, and analyze the search volume for each, creating a complete content brief in seconds.
  • Streamline Content Creation: Build a workflow where an agent researches a keyword with Kwrds.ai, then feeds the keyword, related questions, and search intent into an LLM to generate a well-structured, SEO-optimized article draft.
  • Enhance Competitive Analysis: Programmatically fetch the SERP data for your most important keywords to see who is ranking and what kind of content they are using. Track changes over time to spot new opportunities.
  • Scale Your SEO Efforts: Instead of manually researching keywords one by one, build agents that can analyze hundreds or thousands of keywords from a list, enriching your data and saving countless hours.

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

  1. Log in to your Kwrds.ai account.
  2. Navigate to your Account settings page.
  3. 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.

  1. In your SmythOS dashboard, navigate to the Vault.
  2. Create a new secret and paste your Kwrds.ai API Key as the value. Give it a memorable name, like kwrdsai_api_key.
  3. For more details, see the Vault Documentation.

Step 3: Configure a Kwrds.ai Component

  1. In your SmythOS agent graph, drag and drop any Kwrds.ai component.
  2. Click the component to open its Settings panel.
  3. In the Kwrds API key field, select the secret you saved in the Vault (e.g., kwrdsai_api_key).
  4. Your connection is now configured for that component.
Heads-up
You must add the API Key from the Vault to each Kwrds.ai component you use. This ensures all your API calls are properly authenticated.

Which Kwrds.ai Component Should I Use?

If you need to…TargetUse this ComponentWhy this one?
Get all core metrics for a single keywordA search queryKeyword ResearchProvides a comprehensive overview (volume, CPC, intent) for one keyword.
Understand what questions users are askingA keywordPeople Also AskDirectly fetches the PAA box from Google SERPs, perfect for content ideation.
Find new keywords related to a topicA seed keywordRelated KeywordsExpands your keyword list with semantically similar terms.
Analyze the top 10 results for a queryA search querySERPGives you the actual search results page data for competitor analysis.
Quickly get search volume for a long list of keywordsAn array of keywordsSearch VolumeOptimized for bulk processing of keyword lists.
Brainstorm completely new ideasA seed topicAI Keyword GenerationLeverages 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.

INFO
This component requires an API Key for authentication, as detailed in the Getting Started section.

Inputs

FieldTypeRequiredNotes
search_questionstringYesThe keyword or question to research.
search_countrystringOptionalThe locale for the search (e.g., en-GB). Default: en-US.

Outputs

FieldTypeDescription
volumeintegerThe monthly search volume for the keyword.
cpcfloatThe average Cost Per Click for the keyword.
search_intentstringThe likely user intent (e.g., informational, transactional).
competition_valuefloatA score indicating advertiser competition.
ResponseobjectThe full, raw JSON response from the Kwrds.ai API.
Use Case

Before writing a new blog post, an agent takes the target keyword, runs it through this component, and checks if the volume is above a certain threshold and the competition_value is low enough.

People Also Ask

Retrieves the list of questions that appear in Google's "People Also Ask" box for a given keyword.

INFO
This component requires an API Key for authentication, as detailed in the Getting Started section.

Inputs

FieldTypeRequiredNotes
keywordstringYesThe keyword to find related questions for.
search_countrystringOptionalTwo-letter country code. Default: US.
search_languagestringOptionalTwo-letter language code. Default: en.

Outputs

FieldTypeDescription
resultsarrayAn array of strings, where each string is a question from the PAA box.
ResponseobjectThe raw JSON response from the API.
Use Case

An agent tasked with creating a content brief for an article uses this component to generate a list of questions that should be answered in an FAQ section.

Retrieves a list of keywords that are semantically related to a given keyword.

INFO
This component requires an API Key for authentication, as detailed in the Getting Started section.

Inputs

FieldTypeRequiredNotes
search_questionstringYesThe seed keyword or question.
search_countrystringOptionalThe locale for the search. Default: en-US.

Outputs

FieldTypeDescription
keywordsarrayAn array of related keyword objects, each with its own volume, cpc, etc.
ResponseobjectThe raw JSON response from the API.
Use Case

To build a topic cluster, an agent takes a main pillar keyword (e.g., "AI agents"), uses this component to find related sub-topics, and then creates a list of potential blog posts.

SERP

Returns the live Search Engine Results Page (SERP) data for a given query.

INFO
This component requires an API Key for authentication, as detailed in the Getting Started section.

Inputs

FieldTypeRequiredNotes
search_questionstringYesThe keyword or question to search for.
search_countrystringOptionalThe locale for the search. Default: en-US.

Outputs

FieldTypeDescription
serparrayAn array of objects representing the top search results (URL, title, description).
pasfarrayAn array of "People Also Search For" queries.
ResponseobjectThe raw JSON response from the API.
Use Case

A competitor analysis agent runs this component with a target keyword, extracts the top 5 ranking URLs from the serp output, and then sends those URLs to a web scraper to analyze their content.

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 with Search Volume, find questions with People Also Ask, and analyze competitors with SERP.
  • Use a Loop for Bulk Analysis: To analyze a large list of keywords, use a Loop component in SmythOS. Inside the loop, call the Keyword Research component for each keyword and log the results to a Google Sheet or database.
  • Localize Your Research: Always specify the search_country and search_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.