> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyword Planner

> Discover new keywords and get search volume data

The **Keyword Planner** node lets you discover new keywords and get search volume data without needing a Google Ads account connection. Perfect for keyword research and competitive analysis.

***

## When to Use It

* Discover new keyword opportunities for content or advertising campaigns
* Get search volume and competition data for existing keywords
* Research keywords based on competitor websites or landing pages
* Analyze keyword trends and seasonal patterns with monthly breakdowns
* Build comprehensive keyword lists for SEO or PPC campaigns

***

## Inputs

| Field                 | Type         | Required | Description                                                       | Applies To                       |
| --------------------- | ------------ | -------- | ----------------------------------------------------------------- | -------------------------------- |
| **Action Type**       | Tabs         | Yes      | Choose "Discover Keywords" or "Historical Metrics"                | Both                             |
| **Seed Type**         | Select       | Yes      | Choose "Keyword List" or "Website URL" for discovery              | Discover Keywords                |
| **Seed Keywords**     | Text-area    | Yes      | Enter keywords to use as seeds for discovery (one per line)       | Discover Keywords (Keyword List) |
| **Website URL**       | Text         | Yes      | Enter a website URL to discover related keywords                  | Discover Keywords (Website URL)  |
| **Keywords**          | Text-area    | Yes      | Enter keywords to get historical metrics (one per line)           | Historical Metrics               |
| **Monthly Breakdown** | Switch       | No       | Show search volume metrics broken down by month                   | Historical Metrics               |
| **Countries**         | Multi-select | Yes      | Select target countries for keyword data (default: United States) | Both                             |
| **Language**          | Select       | Yes      | Select target language for keyword data (default: English)        | Both                             |
| **Result Limit**      | Number       | No       | Maximum number of keywords to return (1-10,000)                   | Both                             |

***

## Output

Returns keyword data with the following columns:

| Column                 | Description                                     |
| ---------------------- | ----------------------------------------------- |
| **keyword**            | The keyword text                                |
| **avgMonthlySearches** | Average monthly search volume                   |
| **competition**        | Competition level (Low, Medium, High)           |
| **competitionIndex**   | Numerical competition score (0-100)             |
| **lowTopOfPageBid**    | Minimum suggested bid for top of page placement |
| **highTopOfPageBid**   | Maximum suggested bid for top of page placement |

**Note:** Historical Metrics mode with monthly breakdown enabled will include additional month-by-month search volume columns.

***

## Credit Cost

* **Cost per run**: 1 credit (regardless of number of keywords analyzed)

***

## FAQs

<Accordion title="Do I need a Google Ads account to use this node?">
  No! This node works without requiring any Google Ads account connection. It uses public keyword data to provide insights, making it perfect for SEO research and competitive analysis.
</Accordion>

<Accordion title="What's the difference between Discover Keywords and Historical Metrics?">
  * **Discover Keywords**: Finds new keyword suggestions based on your seed keywords or a website URL
  * **Historical Metrics**: Provides detailed search volume and trend data for keywords you already have

  Use Discover Keywords for research and expansion, Historical Metrics for analyzing specific keywords.
</Accordion>

<Accordion title="How accurate is the search volume data?">
  The search volume data comes from Google's Keyword Planner and represents estimated monthly searches. While generally reliable for relative comparisons, actual volumes may vary. The data is most accurate for:

  * Popular keywords with substantial search volume
  * Recent time periods (last 12 months)
  * Major markets and languages
</Accordion>

<Accordion title="What does the competition level mean?">
  Competition level indicates how many advertisers are bidding on each keyword:

  * **Low**: Few advertisers competing, potentially easier to rank
  * **Medium**: Moderate competition levels
  * **High**: Many advertisers competing, typically more expensive and competitive

  This helps prioritize keywords based on difficulty and opportunity.
</Accordion>

<Accordion title="How should I use the monthly breakdown feature?">
  Enable monthly breakdown to:

  * Identify seasonal trends (e.g., "Christmas gifts" peaks in December)
  * Plan content calendars around search patterns
  * Understand when to increase or decrease advertising spend
  * Spot emerging trends or declining interest

  This is especially useful for seasonal businesses or trending topics.
</Accordion>

<Accordion title="Can I research keywords for any country and language?">
  Yes, you can select multiple countries and specify the target language. This is useful for:

  * International SEO research
  * Expanding into new markets
  * Understanding regional keyword variations
  * Comparing search behavior across different countries
</Accordion>

<Accordion title="What's the best way to use the URL seed option?">
  Enter competitor websites or relevant landing pages to:

  * Analyze competitor keyword strategies
  * Find keywords you might have missed
  * Discover niche-specific terminology
  * Research industry-standard keywords

  Example: Enter "nike.com" to discover athletic and sports-related keywords.
</Accordion>

<Accordion title="How many keywords should I research at once?">
  For optimal results:

  * **Seed keywords**: 5-20 keywords work best for discovery
  * **Historical metrics**: You can analyze 100+ keywords at once
  * **Result limit**: Set based on your needs (100-1000 for comprehensive research)

  More isn't always better - focus on quality and relevance over quantity.
</Accordion>

<Accordion title="How can I use this data with other nodes?">
  Keyword Planner output works great with:

  * **AI Analyze Data**: To categorize and prioritize keywords
  * **Add Keyword to Ad Group**: To bulk add discovered keywords to campaigns
  * **Sheets nodes**: To organize and track keyword research
  * **AI Ask**: To get strategic recommendations based on the data
</Accordion>

<Accordion title="What format should I use for entering keywords?">
  * **One keyword per line**: Each line should contain one keyword phrase
  * **No special formatting**: Just enter the keyword text (no quotes, brackets, or symbols)
  * **Natural language**: Use how people actually search ("running shoes" not "running-shoes")
  * **Variations welcome**: Include plurals, synonyms, and related terms

  Example format:

  ```
  running shoes
  athletic footwear
  marathon sneakers
  jogging shoes
  ```
</Accordion>