thruuu SERP API: Detailed Response Fields

Samuel Schmitt 4 Nov 2024

The thruuu SERP API provides detailed data about the Google Search Engine Results Page (SERP) for a specific query.

Below is an in-depth breakdown of each property returned in the API response, along with examples for reference.

Response Object Structure

{
  "eventType": "bulk-scrape",
  "id": "670a84ec12cc6e264a111a97",
  "reference": "123",
  "serps": [
    {
      "id": "670a851c0534e12f04af917d",
      "query": "100 serp",
      "search_url": "https://www.google.com/search?q=100+serp&gl=us&hl=en&uule=w+CAIQICIEbnVsbA&num=100",
      "device": "desktop",
      "hl": "en",
      "gl": "us",
      "search_engine": "google",
      "number_of_results": 11500000,
      "related_searches": [ /* Array data here */ ],
      "result": [ /* Array data here */ ],
      "keywords_title": [ /* Array data here */ ],
      "keywords_description": [ /* Array data here */ ],
      "keywords_description_meta": [ /* Array data here */ ],
      "keywords_h1": [ /* Array data here */ ],
      "keywords_title_10": [ /* Array data here */ ],
      "keywords_description_10": [ /* Array data here */ ],
      "keywords_description_meta_10": [ /* Array data here */ ],
      "keywords_h1_10": [ /* Array data here */ ],
      "similar_questions": { /* Object data here */ },
      "similar_headings": [ /* Array data here */ ],
      "similar_headings_10": [ /* Array data here */ ],
      "similar_headings_20": [ /* Array data here */ ],
      "search_volume": { /* Object data here */ },
      "heading_analysis": { /* Object or null — see heading_analysis section */ },
      "content_analysis": { /* Object or null — see content_analysis section */ }
    }
  ]
}

Top-Level Properties

  1. eventType
    • Description: Type of event triggering this response.
    • Type: String
  2. id
    • Description: Unique identifier for this specific API request/response.
    • Type: String
  3. reference
    • Description: User-specified reference ID associated with the scrape.
    • Type: String
  4. serps
    • Description: Array containing SERP data returned for the query.
    • Type: Array

SERP Object Properties (inside serps array)

id

query

search_url

device

hl

gl

search_engine

number_of_results

related_searches

[
  {
    "title": "What is SEO in digital marketing",
    "url": "https://www.google.com/search?sca_esv=2dac060d692f34ee&gl=us&hl=en&q=What+is+SEO+in+digital+marketing&sa=X&ved=2ahUKEwj0-LnYhYmJAxW1Q6QEHX7MGScQ1QJ6BAhNEAE"
  }
]

result

Keywords Arrays Structure

similar_questions

{
  "similarQuestionsH1": [
    {
      "sentence": "What Is SEO?",
      "index": 0,
      "count": 6,
      "similarity": [
        "What Is SEO?",
        "What Is SEO – Search Engine Optimization?"
      ]
    }
  ]
}

search_volume

top_topics

Description: An array of objects representing the most frequently discussed terms (n-gram) across the search results. Each topic includes details about its frequency, occurrences across pages, and information on the best pages containing that topic.

Type: Array of Objects

Object Structure:

Example

[
  {
    "term": "search engine",
    "tf": 286,
    "found": 7,
    "min": 20,
    "max": 88,
    "wordCount": 2,
    "bestPage": {
      "position": 1,
      "title": "What Is SEO - Search Engine Optimization?",
      "url": "https://searchengineland.com/guide/what-is-seo"
    },
    "foundInPages": [
      [
        {
          "position": 1,
          "title": "What Is SEO - Search Engine Optimization?",
          "url": "https://searchengineland.com/guide/what-is-seo"
        },
        58
      ]
    ],
    "foundAverage": 0.7,
    "foundAverageText": "7/10",
    "tfAverage": 40.85,
    "tIndex": 9.5
  }
]

>>>>

heading_analysis

Object Structure:

Cluster Object:

FieldTypeDescription
labelstringAI-generated 3-5 word topic name
summarystringOne-sentence description of the group
classificationstringCoverage tier: "very_high" | "high" | "medium" | "low"
aiSignalbooleantrue if the topic is predominantly cited by AI engines rather than organic search
keywordsstring[]Representative keywords for the group
sourcesarrayArray of Source Objects (see below)

Source Object:

FieldTypeDescription
urlstringURL of the source page
domainstringDomain name
pageTitlestringTitle of the page
positionnumber | nullOrganic search position. null for AI-engine sources
sourceTypestring"organic" or "llm"
enginestring"google" | "chatgpt" | "gemini" | "perplexity" | "google_ai_mode"
textstringThe heading text from this page

Idea Object:

FieldTypeDescription
labelstringTopic name for the content gap
summarystringOne-sentence description
keywordsstring[]Representative keywords
suggestedAnglestringA specific, data-grounded article angle to pursue
aiSignalbooleantrue if this topic appears in AI-engine sources but not organic results

Example:

json

{
  "type": "headings",
  "status": "completed",
  "analysis": "Most pages focus on individual CRM product reviews. LLM sources uniquely cover CRM definitions and benefits.",
  "clusters": [
    {
      "label": "Pipedrive CRM Review",
      "summary": "Pages frequently use headings about Pipedrive as a standalone CRM product entry in best-of lists.",
      "classification": "medium",
      "aiSignal": false,
      "keywords": ["Pipedrive", "CRM software", "sales pipeline"],
      "sources": [
        {
          "url": "https://www.creatio.com/glossary/crm-tools",
          "domain": "creatio.com",
          "pageTitle": "CRM Tools",
          "position": 5,
          "sourceType": "organic",
          "engine": "google",
          "text": "Pipedrive"
        },
        {
          "url": "https://www.maximizer.com/blog/the-best-crm-software-for-2026/",
          "domain": "maximizer.com",
          "pageTitle": "Best CRM Software for 2026",
          "position": 6,
          "sourceType": "llm",
          "engine": "perplexity",
          "text": "Pipedrive"
        }
      ]
    }
  ],
  "ideas": [
    {
      "label": "Industry-Specific CRM Solutions",
      "summary": "Few pages address CRM recommendations broken down by vertical industry.",
      "keywords": ["industry-specific CRM", "CRM for healthcare", "CRM for real estate"],
      "suggestedAngle": "Compare CRM features and pricing across healthcare, real estate, and manufacturing verticals.",
      "aiSignal": false
    }
  ]
}

content_analysis

Object Structure: Identical to heading_analysis, with the following differences:

Example:

json

{
  "type": "content",
  "status": "completed",
  "analysis": "Most pages focus on specific CRM platform reviews. Only LLM-cited sources cover CRM's role in building customer loyalty.",
  "clusters": [
    {
      "label": "HubSpot CRM Platform",
      "summary": "Pages frequently discuss HubSpot as an all-in-one CRM combining marketing, sales, and service tools.",
      "classification": "high",
      "aiSignal": false,
      "keywords": ["HubSpot CRM", "inbound marketing", "freemium CRM"],
      "sources": [
        {
          "url": "https://www.creatio.com/glossary/crm-tools",
          "domain": "creatio.com",
          "pageTitle": "CRM Tools",
          "position": 5,
          "sourceType": "organic",
          "engine": "google",
          "text": "HubSpot is widely recognized for its marketing capabilities, particularly inbound lead generation, but it also offers a comprehensive Smart CRM solution."
        }
      ]
    }
  ],
  "ideas": [
    {
      "label": "CRM Implementation Cost Reality",
      "summary": "No source addresses the true total cost of CRM implementation beyond subscription pricing.",
      "keywords": ["CRM implementation cost", "CRM total cost of ownership"],
      "suggestedAngle": "Break down hidden costs of CRM adoption including data migration, training, and integration expenses.",
      "aiSignal": false
    }
  ]
}

Minified Response Format

  1. eventType
    • Description: Indicates the type of event triggering this response.
    • Type: String
  2. id
    • Description: A unique identifier for this specific API request/response.
    • Type: String
    • Example:jsonCopy code"670a8dc8f3fafb5ac638db9d"
  3. reference
    • Description: An optional user-specified reference ID associated with the scrape.
    • Type: String
    • Example:jsonCopy code"123"
  4. serps
    • Description: A simplified array containing the query and unique ID for each SERP result.Type: ArraySERP Object Structure (Minified):
      • query: The search query for which this SERP data was retrieved.id: A unique identifier for this specific SERP result.
  5. Example
{
  "eventType": "bulk-scrape",
  "id": "670a8dc8f3fafb5ac638db9d",
  "reference": "123",
  "serps": [
    {
      "query": "best seo tools",
      "id": "670a8dde995ce28fb209aea2"
    },
    {
      "query": "what is seo",
      "id": "670a8e6fae4aa46557720e63"
    }
  ]
}