Search analytics API | Blogizi Docs

Read cached Google Search Console performance for a project. Bind a property in the dashboard first; see Search Console.

Request

GET /api/search-analytics?days=28
Authorization: Bearer YOUR_ACCOUNT_API_KEY
X-Blogizi-Project: your-project-slug

Parameter	Values	Default
`days`	`7`, `28`, `90`, `180`, `365`, `480`	`28`
`refresh`	`1` to sync before responding (5-minute cooldown)	off

X-Blogizi-Project is required when the account has more than one project.

curl -s "https://blogizi.com/api/search-analytics?days=28" \
  -H "Authorization: Bearer $BLOGIZI_API_KEY" \
  -H "X-Blogizi-Project: my-blog"

Response

{
  "property": "sc-domain:yourapp.com",
  "range": { "startDate": "2026-09-08", "endDate": "2026-10-05", "days": 28 },
  "lastSyncedAt": "2026-10-09T06:00:12.000Z",
  "totals": { "clicks": 41, "impressions": 2210, "ctr": 0.0186, "position": 24.7 },
  "queries": [
    { "keys": ["what is yaml frontmatter"], "clicks": 3, "impressions": 96, "ctr": 0.031, "position": 9.4 }
  ],
  "pages": [
    { "keys": ["https://yourapp.com/blog/yaml-frontmatter-explained"], "clicks": 5, "impressions": 423, "ctr": 0.0118, "position": 10.3 }
  ],
  "chart": [
    { "date": "2026-10-05", "label": "Oct 5", "clicks": 1, "impressions": 99 }
  ]
}

ctr is a fraction (0.0186 = 1.86%). position is Google's average position.
queries and pages hold every stored row (up to 1,000 each), sorted by clicks. previousTotals holds the same totals for the period before.
A range that hasn't been synced yet is fetched from Google on the first request, which takes a few seconds.

Errors

Status	Meaning
401	Missing or invalid API key
402	No active subscription on the account
400	Project not found, multiple projects and none selected, or Search Console not bound for this project

Prefer tool calls? The same data is available to agents as the get_search_performance MCP tool.