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 */ },
      "paragraphCluster": [ /* Array data here */ ],
      "ideas": [ /* Array data here */ ],
      "headingsCluster": [ /* Array data here */ ]
    }
  ]
}

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
  }
]

paragraphCluster

Example:

[
  {
    "examples": [
      {
        "id": "SEO stands for search engine optimization...",
        "source": "https://moz.com/learn/seo/what-is-seo",
        "title": "What Is SEO? Search Engine Optimization Best Practices - Moz",
        "position": 3
      }
    ],
    "summary": "SEO, or search engine optimization, enhances website visibility in organic search results to attract targeted traffic."
  }
]

ideas

Example:

[
  {
    "category": "Challenge Status Quo",
    "text": "Question the effectiveness of traditional keyword-based SEO strategies, arguing that they may hinder creativity and content quality."
  }
]

headingsCluster

Example:

[
  {
    "id": "why is seo important?",
    "size": 4,
    "headings": [
      {
        "id": "why is seo important?",
        "url": "https://searchengineland.com/guide/what-is-seo",
        "headingType": "h2",
        "title": "What Is SEO - Search Engine Optimization?",
        "position": 1
      }
    ]
  }
]

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"
    }
  ]
}