SERP ANALYZE API
Beyond positions.
See the whole picture.
Turn supplied search-result observations into useful comparisons. Keep the query, location, device, time, and collection method attached to the result.
WHAT GOES IN
The right input.
The right question.
Permitted search-result datasets with query, locale, device, and collection context.
KEEP THE SCOPE CLEARA single result snapshot is not a stable ranking measurement. Missing collection data is not evidence that a page is absent.
WHAT COMES OUT
A report you can use.
- Result-type and destination breakdowns
- Like-for-like query comparisons
- Observation coverage and failed collection records
Keep the evidence, interpretation, and next action separate. Document missing inputs instead of filling them with guessed values.
A PRACTICAL WORKFLOW
Understand what a query group needs
Review whether observed results are tutorials, documentation, product pages, or comparisons. Translate that pattern into a reader-need hypothesis rather than a promise of future rankings.
Explore integration patternsLOOK INSIDE THE OUTPUT
Evidence, not a mystery score.
An illustrative report for this workflow. Download the JSON to inspect the complete structure.
Illustrative search-results dataset
The result means more when its context stays attached.
The supplied phrase is “what is an analysis API”.
The sample record specifies English and desktop.
The example has no repeat observations.
{
"schema_version": "1.0",
"report_id": "sample-serp-analysis",
"sample": true,
"analysis_type": "serp-analysis",
"status": "complete",
"target": {
"label": "Sample query observation",
"input_kind": "Illustrative search-results dataset"
},
"summary": "The result means more when its context stays attached.",
"findings": [
{
"id": "f01",
"outcome": "note",
"title": "The query has a learning focus",
"evidence": "The supplied phrase is “what is an analysis API”.",
"action": "Review whether a definition answers the reader’s need."
},
{
"id": "f02",
"outcome": "pass",
"title": "Collection context is recorded",
"evidence": "The sample record specifies English and desktop.",
"action": "Keep context consistent in comparisons."
},
{
"id": "f03",
"outcome": "review",
"title": "Only one observation is supplied",
"evidence": "The example has no repeat observations.",
"action": "Do not infer a stable ranking pattern."
}
],
"not_measured": [
"Current rankings",
"Search demand",
"Comprehensive search coverage"
]
}TAKE IT FURTHER
A little context goes a long way.
Keep queries, locations, devices, and collection methods attached to every search-result comparison.
Read the full guideBefore you connect a real source
Confirm that you are authorized to use the input. Preserve its collection context and version, agree on an acceptance rule, and decide how incomplete results should be reviewed.
- Validate the report before consuming it.
- Keep secrets out of public browser code.
- Show what was—and was not—measured.
Make your next move
a clearer one.
Explore the workflows. Inspect the evidence. Build something useful.