---
title: "Read keyword demand and Google occupancy"
method: GET
path: "/keyword"
tags: ["Keyword"]
---

# Read keyword demand and Google occupancy

`GET /keyword`

## Request

- Base URL: `https://vaneform.com/api/v1`
- URL: `https://vaneform.com/api/v1/keyword`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `q` string, required

## Response `200`

Cached brief, or a Pro miss that buys and stores this month.

- KeywordResource: keyword is the normalized lookup key. items has at most 30 Google results.
  - `keyword` string
  - `market` object
    - `id` string
    - `label` string
  - `status` string
  - `as_of` string
  - `search_volume_monthly` number, nullable
  - `cpc_usd` number, nullable
  - `cpc_low_usd` number, nullable
  - `cpc_high_usd` number, nullable
  - `keyword_difficulty` number, nullable
  - `search_intent` string
  - `paid_competition` string: LOW, MEDIUM, or HIGH.
  - `volume_trend` object
    - `monthly` number
    - `quarterly` number
    - `yearly` number
  - `monthly_searches` object[]
    - `month` string
    - `volume` number
  - `items` object[]

## Other responses

- `400`: Request is malformed.
- `401`: Missing or invalid bearer key.
- `403`: Keyword data is a Pro feature. Upgrade at https://vaneform.com/pricing.
- `429`: Credits or per-key rate limit (60/minute, 5,000/day).
- `500`: Unexpected server failure.

---

[API](https://skmtc.dev/vaneform/apis/vaneform-api.md) · [All operations](https://skmtc.dev/vaneform/apis/vaneform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vaneform/apis/vaneform-api/revisions/a23c06665548?raw)