MetaMonster

Keyword metrics

Keyword metrics

Look up cached SEO metrics for a single keyword in a given market — search volume, difficulty, CPC, competition, and intent.

This endpoint reads from MetaMonster's shared keyword cache. It never triggers a live fetch: if a keyword hasn't been looked up before (for the given market), you get a 404.

Requires the sites:read scope.

GET /keywords/metrics

Scope: sites:read

Query parameters

Parameter Type Default Notes
keyword string — Required. The keyword to look up (1–200 chars). Matched case-insensitively.
location integer 2840 Location code for the target market. 2840 is the United States.
language string en Language code.

Request

curl "https://new.metamonster.ai/api/v1/keywords/metrics?keyword=example%20pricing&location=2840&language=en" \
  -H "Authorization: Bearer mm_YOUR_API_KEY"

Response 200

{
  "data": {
    "keyword": "example pricing",
    "search_volume": 1900,
    "keyword_difficulty": 34,
    "cpc": 4.20,
    "competition": 0.65,
    "search_intent": "commercial",
    "monthly_searches": [
      { "year": 2026, "month": 7, "search_volume": 2100 }
    ]
  }
}
Field Type Description
keyword string The matched keyword
search_volume number | null Average monthly search volume
keyword_difficulty number | null Difficulty score
cpc number | null Average cost per click
competition number | null Competition index
search_intent string | null Detected search intent (e.g. commercial, informational)
monthly_searches array | null Per-month search-volume history

Errors

Status When
400 invalid_request No keyword provided (No keyword provided)
404 not_found The keyword isn't in the cache for that market (Keyword metrics not found)

Not organization-scoped. The keyword cache is global and shared across all MetaMonster customers, so results don't depend on your sites. This is the one read endpoint whose data isn't tied to your organization.