# 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/workflows/google-search
- Handle: `@google-search`
- Category: [Search](https://fous.com/workflows/category/search)
- Source website: https://google.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Google Search.

## Methods

### Get related questions

Operation `get_related_questions`, version 1. 1 credit per call.

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 call.

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 call.

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 | `"Oct 3, 10:00 AM"` | Event date as Google displays it. |
| `events[].event_link` | string |  | Google event detail page. |
| `events[].event_name` | string | `"Fall Salsa + Hot Sauce Festival"` | Event title. |
| `events[].venue_name` | string or null | `"Lago Vista Farmer's Market"` | Venue name when shown. |
| `events[].ticket_links` | array |  | Ticket sellers and prices where shown. |
| `events[].venue_address` | string or null | `"8001 Bronco Ln, Lago Vista, TX 78645"` | Venue address when shown. |
| `events[].start_datetime` | string or null | `"2026-10-03T10:00:00-05:00"` | Local event start with UTC offset when a time and time zone are known. |
| `events[].short_description` | string or null | `"🌶️🔥 Fall Salsa + Hot Sauce Festival 🔥🌶️\n\nSaturday, October 3 \| 10:00 AM – 2:00 PM\nLago Vista Brewing Co.\n8001 B` | Short summary when shown. |

**Example input**

```json
{
  "city": "Austin, TX",
  "what": "food festival",
  "when": "this_weekend",
  "max_results": 3
}
```

**Example output**

```json
{
  "events": [
    {
      "date_text": "Oct 3, 10:00 AM",
      "event_link": "https://www.google.com/search?q=food+festival+near+Austin%2C+TX+this+weekend&hl=en&gl=us&sei=e8C7auqxK6jU5NoPnZLZmAc#sv=CAMS1ggaowgKjwgSjAgKzAdBSmlUNHRKektSenRPTUhZV3puN0xMZHEzWVFzQWJfTHNlZUhkVmFPRlJC…",
      "event_name": "Fall Salsa + Hot Sauce Festival",
      "venue_name": "Lago Vista Farmer's Market",
      "ticket_links": [
        {
          "link": "https://www.google.com/goto?url=CAESsAEB6zswFVAAttT6FTJ34J6wERtI8xASimysdW2UfgEtExc6ouqMevbj2VIWGrg7l8UQvFDXvX8sSKND1fi91-LucEAPnj2kYW3lOjVnmc3ZMCFr01Cc_NpoeatCs-xk2m1S7DolXXXW595doUnKlpECloQ_mBHGOzLz…",
          "price_text": null,
          "seller_name": "Facebook"
        }
      ],
      "venue_address": "8001 Bronco Ln, Lago Vista, TX 78645",
      "start_datetime": "2026-10-03T10:00:00-05:00",
      "short_description": "🌶️🔥 Fall Salsa + Hot Sauce Festival 🔥🌶️\n\nSaturday, October 3 | 10:00 AM – 2:00 PM\nLago Vista Brewing Co.\n8001 Bronco Lane • Lago Vista, Texas\n\nGet ready to turn up the flavor at one of the spicies…"
    }
  ]
}
```

### Search images

Operation `search_images`, version 1. 1 credit per call.

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 |  | Image title shown in results. |
| `images[].width` | integer |  | Full-size image width in pixels. |
| `images[].height` | integer |  | Full-size image height in pixels. |
| `images[].page_link` | string |  | Page containing the image. |
| `images[].image_link` | string |  | Full-size image link. |
| `images[].website_name` | string |  | Source website name. |
| `images[].thumbnail_image_link` | string |  | Thumbnail image link. |

**Example input**

```json
{
  "query": "site:thisdomainneverexistsxyzzy999.invalid golden retriever puppy",
  "max_results": 3,
  "safe_search": false
}
```

**Example output**

```json
{
  "images": []
}
```

### Search jobs

Operation `search_jobs`, version 1. 1 credit per call.

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 | `"65–70 an hour"` | Salary. |
| `jobs[].company` | string | `"CyberNodes LLC"` | Company. |
| `jobs[].currency` | string or null |  | Currency. |
| `jobs[].location` | string | `"Austin, TX"` | Location. |
| `jobs[].job_title` | string | `"Software Developer 3 – IAM / SailPoint Identity Security Cloud"` | Job title. |
| `jobs[].page_link` | string |  | Page link. |
| `jobs[].pay_period` | string or null | `"hour"` | Pay period. |
| `jobs[].salary_max` | number or null | `70` | Salary max. |
| `jobs[].salary_min` | number or null | `65` | Salary min. |
| `jobs[].apply_links` | array |  | Available application pages and their sites. |
| `jobs[].posted_date` | string or null | `"2026-09-29"` | Posted date. |
| `jobs[].employment_type` | string or null | `"Contractor"` | Employment type. |
| `jobs[].short_description` | string or null |  | Short description. |

**Example input**

```json
{
  "location": "Chicago, IL",
  "job_title": "zzzxxyy123456789notarealword",
  "max_results": 3
}
```

**Example output**

```json
{
  "jobs": []
}
```

### Search web

Operation `search_web`, version 1. 1 credit per call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@google-search","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with Google Search?

No. Fous is not affiliated with Google Search. This workflow reads the public google.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/duckduckgo.md): Private web search and instant answers.
- [Bing API](https://fous.com/workflows/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/workflows/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/workflows/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/workflows/meetup.md): Find local groups and public events.
- [Google Books API](https://fous.com/workflows/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/workflows/google-lens.md): Identify images and find visually similar pages online.
- [Google News API](https://fous.com/workflows/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 workflows](https://fous.com/workflows/category/search)