SERP API Update: Heading and Content Analysis Now Include AI Engine Data

The thruuu SERP API now returns AI search engine data in the heading and content analysis response.

If you use analyze_headings or analyze_content in your API calls, here’s what changed.

New Response Fields

Two new top-level fields replace the older headingsCluster, paragraphCluster, and ideas fields:

• heading_analysis: Structured heading group data with AI engine coverage
• content_analysis: Structured paragraph group data with AI engine coverage

Both fields return null when analysis hasn’t been run. Check status === "completed" before reading the data.

What’s Different

AI engine sources are now included

Each source in a group is tagged with the engine that cited it (google, chatgpt, gemini, perplexity, google_ai_mode) and whether it’s an organic or AI-engine result (sourceType: "organic" or "llm").

You can now build features that distinguish between what ranks on Google and what gets cited by AI engines.

Groups are classified by coverage

Every group carries a classification field (very_high, high, medium, low) reflecting how broadly the topic is covered across all sources.

This replaces the old size count with a normalized tier that accounts for both organic and AI coverage.

AI signal indicator

The aiSignal boolean on each group tells you whether a topic is predominantly cited by AI engines rather than organic search.

Use this to surface content gaps between traditional SEO and AI visibility.

Content gap ideas include angles

The ideas array now lives inside heading_analysis and content_analysis (instead of as a flat top-level array).

Each idea includes a suggestedAngle field with a specific, data-grounded direction for a new article.

Migration

The old fields (headingsCluster, paragraphCluster, ideas) are deprecated. Existing legacy data is preserved and still returned, but new analysis requests no longer write to them.

To migrate:

1. Replace headingsCluster with heading_analysis.clusters
2. Replace paragraphCluster with content_analysis.clusters
3. Replace the top-level ideas array with heading_analysis.ideas and content_analysis.ideas
4. Handle null values (analysis not yet run) and check status before reading data
5. Re-trigger analysis for existing SERPs where you need the new data. Old records are not backfilled automatically.

For the full response shape and field reference, see the updated API documentation.

Plan Availability

• Heading Analysis: Pro and Agency plans
• Content Analysis: Agency plan only

No change to credit cost. Both analyses are included as part of the SERP analysis.