Importing Keywords

Learn how to import keywords into SEO Platform from various sources.

Supported Import Methods

• CSV Upload - Upload a CSV file with keywords
• Manual Entry - Add keywords one at a time
• API Import - Programmatically import via REST API

CSV Import

Preparing Your CSV

Your CSV file should include:

Column	Required	Description
keyword	Yes	The keyword text
search_volume	No	Monthly search volume
cpc	No	Cost per click
competition	No	Competition level (0-1)
tags	No	Comma-separated tags

Example CSV

keyword,search_volume,cpc,competition
buy laptop online,12000,1.50,0.8
best gaming laptop,8500,2.00,0.9
cheap laptops,15000,1.20,0.7
laptop reviews,6000,0.80,0.5

Import Steps

1. Navigate to Keywords > Import
2. Click Choose File and select your CSV
3. Map CSV columns to platform fields
4. Set import options:
   • Duplicate handling: Skip, Update, or Create new
   • Default taxonomy: Assign to a taxonomy during import
5. Click Preview Import to review
6. Click Start Import to begin

Column Mapping

The platform will auto-detect common column names. For custom columns:

1. Review the column mapping screen
2. Select the correct field for each column
3. Mark columns to skip with "Ignore"

Manual Entry

For adding a few keywords quickly:

1. Go to Keywords > Add Keyword
2. Enter the keyword text
3. (Optional) Add metadata:
   • Search volume
   • CPC
   • Tags
4. Click Save

Bulk Manual Entry

1. Go to Keywords > Bulk Add
2. Enter keywords, one per line
3. Click Add All

API Import

For automated imports, use the REST API:

import requests

keywords = [
    {"text": "keyword 1", "search_volume": 1000},
    {"text": "keyword 2", "search_volume": 2000},
]

response = requests.post(
    "https://api.seo-platform.com/api/v1/keywords/bulk",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"keywords": keywords}
)

See the API Reference for detailed documentation.

Import Limits

Plan	Keywords per Import	Keywords per Month
Free	100	500
Pro	10,000	100,000
Enterprise	Unlimited	Unlimited

Handling Duplicates

When importing keywords that already exist:

• Skip: Ignore duplicate keywords
• Update: Update existing keyword metadata
• Create New: Create a new entry (not recommended)

Troubleshooting

Import Fails

Common causes:

• Invalid CSV format (check encoding is UTF-8)
• Missing required keyword column
• Exceeding import limits

Keywords Not Appearing

1. Check import job status in Keywords > Import History
2. Verify column mapping was correct
3. Check for error messages in the import log

Encoding Issues

If keywords display incorrectly:

1. Open your CSV in a text editor
2. Save with UTF-8 encoding
3. Re-import the file

Related Topics

• Keyword Classification - Classify imported keywords
• API Reference - Automate imports via API