# Google Search API

> Google Search returns web results, images, jobs, events, questions, and suggestions as a workflow and API.

Google Search, also called Google, returns web results, featured answers, and related searches for a required query. Get related questions and Get search suggestions return questions or autocomplete suggestions for required search words. Search images needs a subject; Search jobs needs a role and location; Search events needs an event type and city.

- Page: https://fous.com/tools/google-search
- Handle: `@google-search`
- Category: [Search](https://fous.com/tools/category/search)
- Source website: https://google.com
- Last verified: Sep 29, 2026

## Methods

### Get related questions

Operation `get_related_questions`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the People also ask questions for a Google search, with their displayed answers and a cited website where available. Questions and answer formats vary by search and location; some AI summaries cite several websites.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"how to calculate payroll tax"` | Topic or question to search for, for example how to calculate payroll tax. |
| `country` | string | no | `"United States"` | Country name or two-letter code, for example United States or US. |
| `language` | string | no | `"English"` | Language name or two-letter code, for example English or en. |
| `max_results` | integer | no | `5` | Most questions to open, for example 10. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Topic or question to search for, for example how to calculate payroll tax.",
      "examples": [
        "how to calculate payroll tax",
        "how do plants grow"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or US.",
      "examples": [
        "United States"
      ]
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Language name or two-letter code, for example English or en.",
      "examples": [
        "English"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Most questions to open, for example 10.",
      "x-fous-developer": true,
      "examples": [
        5,
        4
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "how to calculate payroll tax",
      "country": "United States",
      "language": "English",
      "max_results": 5
    },
    {
      "query": "how do plants grow",
      "max_results": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `questions` | array |  |  |
| `questions[].answer` | string or null | `"Around $23 to $30 (about 7.65% to 10%+) will typically be taken out of a $300 W-2 paycheck for a standard employee in t` |  |
| `questions[].question` | string | `"How much tax is taken out of a $300 paycheck?"` |  |
| `questions[].source_link` | string or null | `"https://www.reddit.com/r/tax/comments/useywg/guys_how_much_is_taken_out_of_taxes_on_300/"` |  |
| `questions[].source_website` | string or null | `"Reddit"` |  |

**Example input**

```json
{
  "query": "how to calculate payroll tax",
  "country": "United States",
  "language": "English",
  "max_results": 5
}
```

**Example output**

```json
{
  "questions": [
    {
      "answer": "Around $23 to $30 (about 7.65% to 10%+) will typically be taken out of a $300 W-2 paycheck for a standard employee in the United States.",
      "question": "How much tax is taken out of a $300 paycheck?",
      "source_link": "https://www.reddit.com/r/tax/comments/useywg/guys_how_much_is_taken_out_of_taxes_on_300/",
      "source_website": "Reddit"
    },
    {
      "answer": "The basic formula for calculating net payroll pay is Gross Pay – Pre-Tax Deductions – Taxes – Post-Tax Deductions = Net Pay.\nTo learn more about business compliance, look over the Investopedia Payroll…",
      "question": "What is the formula for calculating payroll?",
      "source_link": "https://fridayapp.com/how-to-calculate-payroll-manually/",
      "source_website": "fridayapp.com"
    },
    {
      "answer": "You can calculate your effective tax percentage by dividing your total paycheck deductions by your gross pay, or use a tool like the SmartAsset Paycheck Calculator for a detailed breakdown.\nExample: I…",
      "question": "How to calculate what percentage of tax is taken out of a paycheck?",
      "source_link": "https://smartasset.com/taxes/paycheck-calculator",
      "source_website": "SmartAsset.com"
    }
  ]
}
```

### Get search suggestions

Operation `get_search_suggestions`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get Google Search autocomplete suggestions for words typed so far, in Google’s order. Results vary by country and language and may be empty.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"how to start a"` | Words typed so far, for example how to start a. |
| `country` | string | no | `"France"` | Country name or two-letter code, for example United States or US. |
| `language` | string | no | `"French"` | Language name or code, for example French or fr. |
| `max_results` | integer | no | `5` | Most suggestions to return, for example 10. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words typed so far, for example how to start a.",
      "examples": [
        "how to start a",
        "recette de",
        "zzzzzzzzzxzzzzzzzzzxzzzzqwertyuiop"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or US.",
      "examples": [
        "France",
        "GB"
      ]
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Language name or code, for example French or fr.",
      "examples": [
        "French",
        "en"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Most suggestions to return, for example 10.",
      "x-fous-developer": true,
      "examples": [
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "how to start a"
    },
    {
      "query": "recette de",
      "country": "France",
      "language": "French",
      "max_results": 5
    },
    {
      "query": "zzzzzzzzzxzzzzzzzzzxzzzzqwertyuiop",
      "country": "GB",
      "language": "en"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `query` | string | `"how to start a"` | Words used to request suggestions. |
| `suggestions` | array |  | Autocomplete suggestions in Google order. |
| `suggestions[].page_url` | string | `"https://www.google.com/search?q=how+to+start+a+business&hl=en&gl=us"` | Google Search page for this suggestion. |
| `suggestions[].position` | integer | `1` | Rank in the suggestion list, starting at 1. |
| `suggestions[].suggested_search_text` | string | `"how to start a business"` | Suggested search words. |

**Example input**

```json
{
  "query": "how to start a"
}
```

**Example output**

```json
{
  "query": "how to start a",
  "suggestions": [
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+business&hl=en&gl=us",
      "position": 1,
      "suggested_search_text": "how to start a business"
    },
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+podcast&hl=en&gl=us",
      "position": 2,
      "suggested_search_text": "how to start a podcast"
    },
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+jam+on+spotify&hl=en&gl=us",
      "position": 3,
      "suggested_search_text": "how to start a jam on spotify"
    }
  ]
}
```

### Search events

Operation `search_events`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find upcoming public Google Events near a city, with dates, venues, descriptions and ticket sellers when shown. Google may show fewer events or omit details.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `city` | string | yes | `"Austin, TX"` | City or place near the events, for example Austin, TX. |
| `what` | string | yes | `"jazz concerts"` | Kind of event or performer, for example jazz concerts. |
| `when` | string | no | `"this_weekend"` | Date range for the events, for example this_weekend. |
| `max_results` | integer | no | `3` | Maximum events to return, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "what",
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City or place near the events, for example Austin, TX.",
      "examples": [
        "Austin, TX"
      ]
    },
    "what": {
      "type": "string",
      "description": "Kind of event or performer, for example jazz concerts.",
      "examples": [
        "jazz concerts",
        "food festival",
        "zzzxxyy123456789notarealevent"
      ]
    },
    "when": {
      "enum": [
        "any",
        "today",
        "tomorrow",
        "this_weekend",
        "this_week",
        "next_week",
        "this_month"
      ],
      "type": "string",
      "default": "any",
      "description": "Date range for the events, for example this_weekend.",
      "examples": [
        "this_weekend"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum events to return, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "city": "Austin, TX",
      "what": "jazz concerts",
      "max_results": 3
    },
    {
      "city": "Austin, TX",
      "what": "food festival",
      "when": "this_weekend",
      "max_results": 3
    },
    {
      "city": "Austin, TX",
      "what": "zzzxxyy123456789notarealevent",
      "max_results": 3
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `events` | array |  | Upcoming events in start-date order. |
| `events[].date_text` | string | `"Sep 30, 6:30 PM"` | Event date as Google displays it. |
| `events[].event_link` | string |  | Google event detail page. |
| `events[].event_name` | string | `"The Hank Hehmsoth Trio"` | Event title. |
| `events[].venue_name` | string or null | `"Nica on 4th"` | Venue name when shown. |
| `events[].ticket_links` | array |  | Ticket sellers and prices where shown. |
| `events[].venue_address` | string or null | `"117 W 4th St Ste 101A, Austin, TX 78701"` | Venue address when shown. |
| `events[].start_datetime` | string or null | `"2026-09-30T18:30:00-05:00"` | Local event start with UTC offset when a time and time zone are known. |
| `events[].short_description` | string or null | `"Modern swing, jazz history, and 1920s elegance in Austin’s newest Prohibition-style jazz lounge. Join pianist Hank Hehm` | Short summary when shown. |

**Example input**

```json
{
  "city": "Austin, TX",
  "what": "jazz concerts",
  "max_results": 3
}
```

**Example output**

```json
{
  "events": [
    {
      "date_text": "Sep 30, 6:30 PM",
      "event_link": "https://www.google.com/search?q=jazz+concerts+near+Austin%2C+TX&hl=en&gl=us&sei=e8C7apj-JpCgiLMPo_vkuAs#sv=CAMS1ggaowgKjwgSjAgKzAdBSmlUNHRLWlBpVDQ5amRaLVU4S3ZKOGpxNHJISHp6dU1BSklQNzRRbDkyUTZvU3VBLWVIT…",
      "event_name": "The Hank Hehmsoth Trio",
      "venue_name": "Nica on 4th",
      "ticket_links": [
        {
          "link": "https://www.google.com/goto?url=CAESwAEB6zswFcwYDJC8Rx80U0QkNGvcsZcSlzDhr846O6_s8Wc8tD0jXMKa992zZW_nK7Z67NgQb8KQpx0si-UpP0_eZnKwEoUmM6UImEpNmGjuRxZyMyd4fhR-2D7WYPjEE1bHZDfN9Yk6oYPwGfSJVs-o0ORJsY5BpC1m…",
          "price_text": null,
          "seller_name": "Bandsintown"
        }
      ],
      "venue_address": "117 W 4th St Ste 101A, Austin, TX 78701",
      "start_datetime": "2026-09-30T18:30:00-05:00",
      "short_description": "Modern swing, jazz history, and 1920s elegance in Austin’s newest Prohibition-style jazz lounge. Join pianist Hank Hehmsoth and trio for an evening of swing, standards, and modern jazz in the intimate…"
    }
  ]
}
```

### Search images

Operation `search_images`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find public Google Images pictures of a subject in displayed order, with image links, page links, source websites, and dimensions. Google may show fewer results than requested.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"red panda"` | Subject to find pictures of, for example golden retriever puppy. |
| `country` | string | no | `"Canada"` | Country name or two-letter country code, for example Canada or CA. |
| `max_results` | integer | no | `100` | Maximum number of pictures, for example 20. |
| `safe_search` | boolean | no | `false` | Use SafeSearch to filter explicit pictures, for example true. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Subject to find pictures of, for example golden retriever puppy.",
      "examples": [
        "red panda",
        "golden retriever puppy",
        "site:thisdomainneverexistsxyzzy999.invalid golden retriever puppy"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, for example Canada or CA.",
      "examples": [
        "Canada"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of pictures, for example 20.",
      "x-fous-developer": true,
      "examples": [
        100,
        3
      ]
    },
    "safe_search": {
      "type": "boolean",
      "default": true,
      "description": "Use SafeSearch to filter explicit pictures, for example true.",
      "examples": [
        false
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "red panda",
      "country": "Canada",
      "max_results": 100,
      "safe_search": false
    },
    {
      "query": "golden retriever puppy"
    },
    {
      "query": "site:thisdomainneverexistsxyzzy999.invalid golden retriever puppy",
      "max_results": 3,
      "safe_search": false
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `images` | array |  | Images in Google Images order. |
| `images[].title` | string | `"Red panda - Wikipedia"` | Image title shown in results. |
| `images[].width` | integer | `1280` | Full-size image width in pixels. |
| `images[].height` | integer | `853` | Full-size image height in pixels. |
| `images[].page_link` | string | `"https://en.wikipedia.org/wiki/Red_panda"` | Page containing the image. |
| `images[].image_link` | string | `"https://thumb.wikimedia.org/wikipedia/commons/thumb/f/fd/Red_Panda%2C_Gentle_Tree-Dweller_of_the_Himalayas.jpg/1280px-R` | Full-size image link. |
| `images[].website_name` | string | `"Wikipedia"` | Source website name. |
| `images[].thumbnail_image_link` | string | `"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSvyvIJmzchwYABsdeQ7YavtlaOswZhZbT5OEz4VCkjRQ&s"` | Thumbnail image link. |

**Example input**

```json
{
  "query": "red panda",
  "country": "Canada",
  "max_results": 100,
  "safe_search": false
}
```

**Example output**

```json
{
  "images": [
    {
      "title": "Red panda - Wikipedia",
      "width": 1280,
      "height": 853,
      "page_link": "https://en.wikipedia.org/wiki/Red_panda",
      "image_link": "https://thumb.wikimedia.org/wikipedia/commons/thumb/f/fd/Red_Panda%2C_Gentle_Tree-Dweller_of_the_Himalayas.jpg/1280px-Red_Panda%2C_Gentle_Tree-Dweller_of_the_Himalayas.jpg?utm_source=en.wikipedia.org&…",
      "website_name": "Wikipedia",
      "thumbnail_image_link": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSvyvIJmzchwYABsdeQ7YavtlaOswZhZbT5OEz4VCkjRQ&s"
    },
    {
      "title": "Red Panda | National Geographic Kids",
      "width": 1200,
      "height": 675,
      "page_link": "https://kids.nationalgeographic.com/animals/mammals/facts/red-panda",
      "image_link": "https://i.natgeofe.com/k/63b1a8a7-0081-493e-8b53-81d01261ab5d/red-panda-full-body_16x9.jpg?w=1200",
      "website_name": "National Geographic Kids",
      "thumbnail_image_link": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvo_cV_NYgCn5uPBsrIsLRRcEFq8pGchNV9MXmHn1Ew&s=10"
    },
    {
      "title": "Eight Amazing Red Panda Facts",
      "width": 1026,
      "height": 684,
      "page_link": "https://www.smithsonianmag.com/science-nature/eight-amazing-facts-about-red-pandas-180979708/",
      "image_link": "https://th-thumbnailer.cdn-si-edu.com/uFK2PPu26wPdJ5weXf6mpKIAkXw=/1026x684/filters:focal(4381x2523:4382x2524)/https://tf-cmsv2-smithsonianmag-media.s3.amazonaws.com/filer_public/e0/58/e058c2c2-b1d9-4…",
      "website_name": "Smithsonian Magazine",
      "thumbnail_image_link": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQwo07nwNbAQQ9bf9yfDmeTv6HGJ1RHrNiqaUWDWcmd3w&s=10"
    }
  ]
}
```

### Search jobs

Operation `search_jobs`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find public Google Jobs openings in Google order, with pay, posting dates, descriptions and application sites when shown. Google may show fewer jobs or omit details; searches can be temporarily blocked.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `location` | string | yes | `"Chicago, IL"` | City and state, or remote, for example Chicago, IL. |
| `job_title` | string | yes | `"payroll specialist"` | Job title or keywords, for example payroll specialist. |
| `max_results` | integer | no | `3` | Maximum number of openings, for example 20. |
| `company_name` | string | no | `"Intuit"` | Only openings from this company, for example Intuit. |
| `posted_within` | string | no | `"3_days"` | When the job was posted, for example week. |
| `employment_type` | string | no | `"contract"` | Job arrangement, for example full_time. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "job_title",
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "City and state, or remote, for example Chicago, IL.",
      "examples": [
        "Chicago, IL",
        "Austin, TX"
      ]
    },
    "job_title": {
      "type": "string",
      "description": "Job title or keywords, for example payroll specialist.",
      "examples": [
        "payroll specialist",
        "zzzxxyy123456789notarealword",
        "software engineer"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of openings, for example 20.",
      "x-fous-developer": true,
      "examples": [
        3,
        4,
        5
      ]
    },
    "company_name": {
      "type": "string",
      "description": "Only openings from this company, for example Intuit.",
      "examples": [
        "Intuit"
      ]
    },
    "posted_within": {
      "enum": [
        "any",
        "today",
        "3_days",
        "week",
        "month"
      ],
      "type": "string",
      "default": "any",
      "description": "When the job was posted, for example week.",
      "examples": [
        "3_days"
      ]
    },
    "employment_type": {
      "enum": [
        "any",
        "full_time",
        "part_time",
        "contract",
        "internship"
      ],
      "type": "string",
      "default": "any",
      "description": "Job arrangement, for example full_time.",
      "examples": [
        "contract"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "location": "Chicago, IL",
      "job_title": "payroll specialist"
    },
    {
      "location": "Chicago, IL",
      "job_title": "zzzxxyy123456789notarealword",
      "max_results": 3
    },
    {
      "location": "Chicago, IL",
      "job_title": "payroll specialist",
      "max_results": 4,
      "company_name": "Intuit"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `jobs` | array |  | Job openings in Google order. |
| `jobs[].remote` | string | `"no"` | Whether the role is remote. |
| `jobs[].salary` | string or null | `"90K–95K a year"` | Salary. |
| `jobs[].company` | string | `"LaSalle Network"` | Company. |
| `jobs[].currency` | string or null |  | Currency. |
| `jobs[].location` | string | `"Chicago, IL"` | Location. |
| `jobs[].job_title` | string | `"HR & Payroll Coordinator"` | Job title. |
| `jobs[].page_link` | string |  | Page link. |
| `jobs[].pay_period` | string or null | `"year"` | Pay period. |
| `jobs[].salary_max` | number or null | `95000` | Salary max. |
| `jobs[].salary_min` | number or null | `90000` | Salary min. |
| `jobs[].apply_links` | array |  | Available application pages and their sites. |
| `jobs[].posted_date` | string or null | `"2026-09-28"` | Posted date. |
| `jobs[].employment_type` | string or null | `"Full-time"` | Employment type. |
| `jobs[].short_description` | string or null | `"LaSalle Network has partnered with a client to find a detail-oriented, proactive HR & Payroll Coordinator to join their` | Short description. |

**Example input**

```json
{
  "location": "Chicago, IL",
  "job_title": "payroll specialist"
}
```

**Example output**

```json
{
  "jobs": [
    {
      "remote": "no",
      "salary": null,
      "company": "LaSalle Network",
      "currency": null,
      "location": "Chicago, IL",
      "job_title": "HR & Payroll Coordinator",
      "page_link": "https://www.google.com/search?ibp=htl;jobs&q=payroll+specialist+jobs+in+Chicago,+IL&htidocid=uncfX1tUyznEmd7MAAAAAA%3D%3D&hl=en-US&shem=epsd1,esd2e,rimspwouoe&shndl=37&shmd=H4sIAAAAAAAA_xXEOwoCMRAAUGz…",
      "pay_period": null,
      "salary_max": null,
      "salary_min": null,
      "apply_links": [
        {
          "link": "https://www.thelasallenetwork.com/jobs/hr-payroll-coordinator-163032/?utm_campaign=google_jobs_apply&utm_source=google_jobs_apply&utm_medium=organic",
          "site_name": "LaSalle Network"
        }
      ],
      "posted_date": "2026-09-28",
      "employment_type": "Full-time",
      "short_description": "LaSalle Network has partnered with a client to find a detail-oriented, proactive HR & Payroll Coordinator to join their team on a contract-to-hire basis! Sitting on the HR team and partnering closely …"
    }
  ]
}
```

### Search web

Operation `search_web`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Search public Google web results in displayed order, excluding ads, with an answer box and related searches when shown. Google may show fewer results than requested.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `query` | string | yes | `"what is photosynthesis"` | Search words or a question, for example best CRM for small business. |
| `country` | string | no | `"Canada"` | Country name or two-letter country code, for example Canada or CA. |
| `language` | string | no | `"French"` | Language name or code, for example French or fr. |
| `max_results` | integer | no | `5` | Maximum regular web results, for example 10. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search words or a question, for example best CRM for small business.",
      "examples": [
        "what is photosynthesis",
        "zzzxxyy123456789notarealword",
        "best CRM for small business"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter country code, for example Canada or CA.",
      "examples": [
        "Canada"
      ]
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Language name or code, for example French or fr.",
      "examples": [
        "French"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum regular web results, for example 10.",
      "x-fous-developer": true,
      "examples": [
        5,
        3,
        12
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "query": "what is photosynthesis",
      "max_results": 5
    },
    {
      "query": "zzzxxyy123456789notarealword",
      "max_results": 3
    },
    {
      "query": "best CRM for small business"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `results` | array |  | Regular results in the order Google displays them. |
| `results[].link` | string | `"https://www.ck12.org/flexi/life-science/leaves-and-photosynthesis/what-is-the-main-purpose-of-photosynthesis/"` | Result page link. |
| `results[].title` | string | `"Flexi answers - What is the main purpose of photosynthesis?"` | Page title. |
| `results[].position` | integer | `1` | Rank among returned regular results. |
| `results[].description` | string or null | `"Photosynthesis is a process by which specific organisms (including all plants) use the sun's energy to make their own f` | Short description shown with the result. |
| `results[].website_name` | string or null | `"CK-12 Foundation"` | Website name shown by Google. |
| `featured_answer` | string or null | `"4"` | Text in a featured answer box, when shown. |
| `related_searches` | array |  | Search suggestions shown beneath the results. |

**Example input**

```json
{
  "query": "what is photosynthesis",
  "max_results": 5
}
```

**Example output**

```json
{
  "results": [
    {
      "link": "https://www.ck12.org/flexi/life-science/leaves-and-photosynthesis/what-is-the-main-purpose-of-photosynthesis/",
      "title": "Flexi answers - What is the main purpose of photosynthesis?",
      "position": 1,
      "description": "Photosynthesis is a process by which specific organisms (including all plants) use the sun's energy to make their own food from carbon dioxide and water; ...",
      "website_name": "CK-12 Foundation"
    },
    {
      "link": "https://brainly.in/question/34071877",
      "title": "what is photosynthesis explain each and every word wit full ...",
      "position": 2,
      "description": "Jan 27, 2021 — So, photosynthesis actually means to put together using light . Plants, algae and plant-like protists use sunlight to put together carbon dioxide ... Read more",
      "website_name": "Brainly.in"
    },
    {
      "link": "https://www.facebook.com/groups/880709219146928/posts/1106966299854551/",
      "title": "What is photosynthesis in science??",
      "position": 3,
      "description": "Photosynthesis is the process where by plants produce their own food with the help of the sun light,water and chlorophyll and mineralsalt. 4y · ... Read more",
      "website_name": "Facebook · WASSCE/ BECE CANDIDATES"
    }
  ],
  "featured_answer": null,
  "related_searches": [
    "What is photosynthesis process",
    "What is photosynthesis answer"
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@google-search",
  "visibility": "public",
  "operation": "get_related_questions",
  "version": 1,
  "input": {
    "query": "how to calculate payroll tax",
    "country": "United States",
    "language": "English",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@google-search\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_related_questions\",\n  \"version\": 1,\n  \"input\": {\n    \"query\": \"how to calculate payroll tax\",\n    \"country\": \"United States\",\n    \"language\": \"English\",\n    \"max_results\": 5\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@google-search",
  "visibility": "public",
  "operation": "get_related_questions",
  "version": 1,
  "input": {
    "query": "how to calculate payroll tax",
    "country": "United States",
    "language": "English",
    "max_results": 5
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/google-search`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_related_questions`: Get related questions. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_search_suggestions`: Get search suggestions. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_events`: Search events. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_images`: Search images. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_jobs`: Search jobs. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_web`: Search web. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-google-search https://api.fous.com/mcp/tools/google-search --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Research public web results and featured answers for a topic.
- Find images and source websites for a subject.
- Compare job openings, pay, posting dates, and application sites.
- Track upcoming events, venues, dates, and ticket sellers.
- Explore related questions and autocomplete suggestions for search terms.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Google Search tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Google Search account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from google.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What pages appear for a search query?

Search web returns regular results in displayed order, with featured answer text and related searches when shown.

### What questions do people also ask about a topic?

Get related questions returns displayed questions and answers, with a cited website where available.

### What jobs are available for a role and location?

Search jobs returns openings in Google order, with pay, posting dates, descriptions, and application sites when shown.

## Related

- [DuckDuckGo API](https://fous.com/tools/duckduckgo.md): Private web search and instant answers.
- [Bing API](https://fous.com/tools/bing.md): Bing returns ordered web results and recent news, plus AI answers with sources when available; news times are approximate, and images may be missing.
- [Eventbrite API](https://fous.com/tools/eventbrite.md): Eventbrite helps discover live and online events, with public search results that may be limited and event details that may omit public ticket listings.
- [Indeed API](https://fous.com/tools/indeed.md): Indeed returns public first-page listings and details for available, unexpired jobs, company employee ratings and CEO approval when available, and typical pay from public salary pages.
- [Meetup API](https://fous.com/tools/meetup.md): Find local groups and public events.
- [Google Books API](https://fous.com/tools/google-books.md): Google Books searches books and provides book details, reader ratings, and local ebook prices when available; newest results sort by publication date.
- [Google Lens API](https://fous.com/tools/google-lens.md): Identify images and find visually similar pages online.
- [Google News API](https://fous.com/tools/google-news.md): Google News returns recent publisher articles, up to 100 per search, current top stories by topic, country, and language, and local stories by city or region when available.
- [All Search tools](https://fous.com/tools/category/search)