​
Get started

​
Overview

The Google Search API provides programmatic access to Google Search results with additional features for proxy handling and result formatting. This documentation covers the API endpoints, parameters, and response structure.

​
Request Parameters

​
Required Parameters

  • Search term: The query string to search for (e.g., “best pizza in atlanta, ga”)

​
Optional Parameters

  • Proxy: Toggle for proxy usage
  • Built-in Proxy: Option to use the API’s built-in proxy service
  • Raw HTML: Option to receive raw HTML results
  • Choose best: Option to receive optimized results
  • Proxies: Dropdown to select proxy location (e.g., “US”)

​
Response Structure

The API returns a JSON object with the following main sections:

​
Results Object

{
    "results": {
        "bottom_ads": [],
        "local_results": [],
        "people_also_ask": [],
        "related": [],
        "results": [],
        "top_ads": []
    }
}

​
Key Components

  • bottom_ads: Array of advertisements displayed at the bottom of results
  • local_results: Array of location-based results
  • people_also_ask: Array of related questions and answers
  • related: Array of related search suggestions
  • results: Main search results array
  • top_ads: Array of advertisements displayed at the top of results

​
People Also Ask Structure

Each item in the people_also_ask array contains:
  • question: The related question
  • answer: The corresponding answer
  • source: URL source of the answer

​
Usage Statistics

{
    "usage": {
        "requests_left": 99952,
        "credits_left": 0
    }
}

​
Status Information

  • message: Status of the request (e.g., “success”)
  • errors: Array of any error messages

API Reference

Learn how to use Tinq.ai’s Google Search API