Skip to content

Keyword methods: measure

The Keyword Verbs measure as typed SDK methods, with inputs, result, refusals and an example.

Reference for Keyword, one group of Keyword methods.

Keyword.measure

Measure records a Keyword’s monthly search volume, difficulty, cost per click and trend in one locale. Verb page.

TypeScript
interface KeywordVerbs {
  measure(input: KeywordMeasureInput, options?: SB.CallOptions): SB.Call<Keyword>
}

Emits Keyword.measured.

Inputs

InputTypeRequiredDescription
keywordKeywordrequiredThe Keyword to measure.
localestringThe market and language, such as en-US. Defaults to the Startup’s home Market.
venuestringThe search venue, such as google-search. Defaults to the largest one in the Market.

Returns

OutputTypeRequiredDescription
keywordKeywordrequiredThe Keyword; each measure is a Keyword.measured Event with its method and observation time.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

TypeScript
import { $ } from 'startup-builder'

const keyword = await $.Keyword.measure({ keyword: 'keyword_cEoeFM4Drs' })