Keyword
A Keyword is a search phrase or AI prompt that Pages target, with its rank and citations observed over time.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
phrase | string | required | The words searched or asked. |
form | string | One of search or question. |
Object
{
"$id": "https: //api.sb/ routewise.dev/ keywords/ keyword_1",
"$type": "Keyword",
"phrase": "Example phrase",
"form": "search"
}Relationships
- A Keyword is targeted by many Pages: a Page is written to rank for, or be cited on, its Keywords.
targetedBy, inversetargets.
Verbs
createCreates a Keyword.POST /{namespace}/keywordsgetReturns one Keyword by id.GET /{namespace}/keywords/{id}listReturns Keywords, newest first, one page at a time.GET /{namespace}/keywordsupdateChanges the given properties of a Keyword.PATCH /{namespace}/keywords/{id}deleteDeletes a Keyword; its history is kept.DELETE /{namespace}/keywords/{id}measureMeasure records a Keyword’s monthly search volume, difficulty, cost per click and trend in one locale.POST /{namespace}/keywords/{keyword}/measure
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Keyword.create | Yes | Yes | Yes | No |
Keyword.get | Yes | Yes | Yes | Yes |
Keyword.list | Yes | Yes | Yes | Yes |
Keyword.update | Yes | Yes | Yes | No |
Keyword.delete | Yes | Yes | Yes | No |
Keyword.measure | Yes | Yes | Yes | No |
Call it
Measure the latest keyword.Example
The Keyword "home inspector near me" is targeted by the city Pages of an inspector directory. Its largest city Page ranks third and is cited in one AI answer this week.