> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Search API

> Scrape Google Search results (organic links, snippets, titles) with country/language filters and search operators

`POST /v1/data/google/search/run`

**Pricing:** $0.001 per result ($1.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**queries** `string` *required*

A Google search query or full search URL. Supports operators like site:, OR, intitle:, etc.

Format e.g. `https://www.example.com`.

**maxPages** `integer`

Number of Google result pages to scrape (\~10 organic results per page). Use 0 for all. Google itself returns at most \~10 pages (\~100 results) per query, so higher values won't return more.

**startDate** `date`

Earliest result date. Leave blank for no lower bound.

**endDate** `date`

Latest result date. Leave blank for no upper bound.

**country** `string`

Country to search from (uses google.\<tld> domain). Defaults to US (google.com).

240 allowed values, for example `af` (Afghanistan), `al` (Albania), `dz` (Algeria), `as` (American Samoa), `ad` (Andorra), `ao` (Angola), `ai` (Anguilla), `aq` (Antarctica), `ag` (Antigua and Barbuda), `ar` (Argentina). Fetch the full list with `GET /v1/data/google/search?expand=options`.

**searchLanguage** `string`

Language of search results (e.g. only German pages).

35 allowed values, for example `ar` (Arabic), `bg` (Bulgarian), `ca` (Catalan), `cs` (Czech), `da` (Danish), `de` (German), `el` (Greek), `en` (English), `es` (Spanish), `et` (Estonian). Fetch the full list with `GET /v1/data/google/search?expand=options`.

**site** `string`

Limit to a specific site (e.g. example.com).

Format e.g. `stripe.com`.

**relatedToSite** `string`

Find pages related to a specific site (e.g. example.com). Ignored if Site Filter is set.

Format e.g. `stripe.com`.

**fileTypes** `string[]`

Filter to specific file types (e.g. pdf, doc).

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google/search/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "queries": "best CRM tools 2026"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/google/search/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "queries": "best CRM tools 2026"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google/search/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "queries": "best CRM tools 2026"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one result, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `rank` | Rank | number |
| `title` | Title | text |
| `link` | Link | url |
| `domain` | Domain | text |
| `source` | Source | text |
| `snippet` | Snippet | text |
| `publishedDate` | Published Date | text |
| `aiAnswer` | AI Answer | text |
| `aiAnswerSources` | AI Answer Sources | object\_array |
| `relatedSearches` | Related Searches | object\_array |
| `relatedQuestions` | Related Questions | object\_array |
| `organicResultType` | Organic Result Type | text |
| `organicProductInfo` | Organic Product Info | object |
| `displayedUrl` | Displayed URL | text |
| `emphasizedKeywords` | Emphasized Keywords | array |
| `views` | Views | text |
| `commentsAmount` | Comments Amount | text |
| `likes` | Likes | text |
| `reactions` | Reactions | text |
| `channelName` | Channel Name | text |
| `followersAmount` | Followers Amount | text |
| `lastUpdated` | Last Updated | text |
| `siteLinks` | Site Links | object |
| `personalInfo` | Personal Info | text |
| `hasNextPage` | Has Next Page | boolean |
| `resultsTotal` | Results Total | number |
| `paidResults` | Paid Results | object |
| `paidProducts` | Paid Products | object |
| `suggestedResults` | Suggested Results | object |
| `customData` | Custom Data | object |
| `htmlSnapshotUrl` | HTML Snapshot URL | text |
| `serpProviderCode` | Serp Provider Code | text |
| `googleUrl` | Google URL | text |
| `error` | Error | text |
| `searchQueryUrl` | Search Query URL | text |
| `searchQueryDomain` | Search Query Domain | text |
| `searchQueryDevice` | Search Query Device | text |
| `searchQueryPage` | Search Query Page | number |
| `searchQueryType` | Search Query Type | text |
| `searchQueryResultsPerPage` | Search Query Results Per Page | number |
| `searchQueryLocationUule` | Search Query Location Uule | text |
| `debugBlock` | Debug Block | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google/search",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "relatedSearches": [
        {
          "title": "Best crm tools 2026 reddit"
        },
        {
          "title": "Best crm tools 2026 free"
        }
      ],
      "source": "HubSpot",
      "link": "https://www.hubspot.com/comparisons/best-crm",
      "rank": 1,
      "domain": "www.hubspot.com",
      "relatedQuestions": [
        {
          "question": "Which CRM is the best in 2026?",
          "answer": null,
          "url": null
        },
        {
          "question": "What are the top 5 CRM tools in the world?",
          "answer": null,
          "url": null
        }
      ],
      "aiAnswerSources": null,
      "snippet": "Compare the best CRM solutions to choose the one that suits the needs of your business and will scale with you as you grow.",
      "aiAnswer": null,
      "publishedDate": null,
      "title": "Best CRM Software of 2026 | Compare Top CRMs"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.