Adding keywords in bulk

Rank Tracking → Add keywords supports three bulk input methods. This page documents the formats and validation rules so your imports succeed first try.

Method 1: paste list

One keyword per line. Optional comma-separated location, device, engine, group.

text
semoptimiser
seo audit tool, Sydney NSW, mobile, google
rank tracker, United Kingdom, desktop, bing, brand
ai visibility tracker

Per-field defaults when omitted: location = site default, device = mobile, engine = google, group = null.

Method 2: CSV upload

Required column: keyword. Optional columns: location, device, engine, group. Header row required.

text
keyword,location,device,engine,group
semoptimiser,Sydney NSW,mobile,google,brand
seo audit tool,Sydney NSW,desktop,google,product
rank tracker,Sydney NSW,mobile,bing,product

Max 5,000 rows per upload. UTF-8 only. Commas inside fields must be quoted ("keyword with, comma",Sydney,mobile,google).

Method 3: GSC import

Requires Search Console connected. Click Import from GSC, set:

Validation rules

• Keyword: 1-200 chars, lowercase normalized. Duplicates within a site/location/device/engine combo are rejected.
• Location: must match a Google location string. We autocomplete; CSV uploads validate during import and reject unknown locations.
• Device: must be `mobile` or `desktop`. Case-insensitive.
• Engine: must be `google` or `bing` (or `naver`, `yandex`, `seznam` on the CEO plan).
• Group: free text 1-50 chars. Used as a tag for filtering.

Slot accounting

Each unique (keyword, location, device, engine) combination counts as one slot against your plan's keyword limit. A keyword tracked in 5 suburbs × 2 devices = 10 slots.

After import

• New keywords get their first SERP check within an hour.
• Daily rank checks happen between 02:00 and 06:00 in your workspace timezone.
• Manual on-demand check available from each keyword's row.

API equivalent

bash
curl -X POST https://api.semoptimiser.com/v1/keywords/bulk \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "site_1",
    "keywords": [
      { "keyword": "seo audit", "location": "Sydney NSW", "device": "mobile", "engine": "google" }
    ]
  }'