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 patterns

LOOK INSIDE THE OUTPUT

Evidence, not a mystery score.

An illustrative report for this workflow. Download the JSON to inspect the complete structure.

THE ANALYSIS PLAYGROUND
Interactive sample

Illustrative search-results dataset

Sample query observation

The result means more when its context stays attached.

·
The query has a learning focus

The supplied phrase is “what is an analysis API”.

✓
Collection context is recorded

The sample record specifies English and desktop.

!
Only one observation is supplied

The example has no repeat observations.

report.json
{
  "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"
  ]
}
Illustrative data. No live analysis or uploads.Download JSON Explore workflow

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 guide

Before 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.