OneClickSEO.ai
Developer API

Keyword ideas

Generates a large set of keyword ideas from a seed keyword or a website URL, each enriched with volume, difficulty, CPC and intent. This is an asynchronous job: create the job, then poll it until it completes.

Create a keyword-ideas job

POST/keywords/ideas
Body parameters
ParameterTypeDescription
seedstringSeed keyword to expand. Required unless `url` is given.
urlstringWebsite URL to derive ideas from. Required unless `seed` is given.
countrystring2-letter ISO country code. Defaults to `us`.
languagestring2-letter ISO language code. Defaults to `en`.
includestring[]Only return ideas containing these words.
excludestring[]Exclude ideas containing these words.
cURL
curl -X POST "https://api.oneclickseo.ai/v1/keywords/ideas" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "seed": "link building", "country": "us" }'
202Job accepted
Response
{
  "data": { "id": "job_3f9a2c", "status": "pending", "progress": 0 },
  "meta": { "request_id": "req_8f2c1a", "credits_charged": 25 }
}

Fetch job results

Poll the job by id. Once `status` is `completed`, `data.keywords` holds the ideas (paginated with `page` / `per_page`).

GET/keywords/ideas/{job_id}
cURL
curl "https://api.oneclickseo.ai/v1/keywords/ideas/job_3f9a2c" \
  -H "Authorization: Bearer YOUR_API_KEY"
200Completed job with keyword ideas
Response
{
  "data": {
    "id": "job_3f9a2c",
    "status": "completed",
    "total_keywords": 1842,
    "keywords": [
      {
        "keyword": "link building services",
        "volume": 2400,
        "difficulty": 61,
        "cpc": 18.7,
        "intent": "HIGH_INTENT",
        "type": "STANDARD"
      }
    ]
  },
  "meta": { "page": 1, "per_page": 50, "total": 1842, "total_pages": 37 }
}
Credit cost

A keyword-ideas run costs 25 credits, charged when the job is created. Fetching results is free.

Related