Google Web Search API

Fast, reliable Google Search API that returns structured search results in JSON format. Runs in Standby mode as a real-time HTTP API — send a request, get instant results.

Features

• Instant HTTP API — No waiting for Actor runs, get results in real-time
• Structured JSON — Clean results with titles, URLs, descriptions, and timestamps
• Knowledge Panels — Returns Google Knowledge Panel data when available
• Pagination — Cursor-based pagination for navigating through results
• Related Keywords — Optionally get related search suggestions
• Pay Per Request — You only pay for successful API calls

Quick Start

Send a GET request to the Standby endpoint:

https://glavier--google-web-search.apify.actor?query=web+scraping&token={YOUR_APIFY_TOKEN}

Example Response

{
    "search_term": "web scraping",
    "next_cursor": "CAo=",
    "knowledge_panel": null,
    "results": [
        {
            "url": "https://www.example.com/",
            "title": "Example Result",
            "description": "Description of the search result...",
            "timestamp": null
        }
    ]
}

Parameters

Parameter	Type	Required	Default	Description
query	string	Yes	—	Search term to look up
limit	integer	No	10	Number of results (1–100)
related_keywords	boolean	No	false	Include related search keywords
cursor	string	No	—	Pagination cursor from previous response

Authentication

Include your Apify API token in one of two ways:

Query parameter (simple):

https://glavier--google-web-search.apify.actor?query=hello&token={YOUR_APIFY_TOKEN}

Authorization header (recommended):

curl "https://glavier--google-web-search.apify.actor?query=hello" \
  -H "Authorization: Bearer {YOUR_APIFY_TOKEN}"

Pagination

Use the next_cursor value from the response to fetch the next page:

# First page
curl "https://glavier--google-web-search.apify.actor?query=web+scraping&token={TOKEN}"

# Next page (use next_cursor from previous response)
curl "https://glavier--google-web-search.apify.actor?query=web+scraping&cursor=CAo%3D&token={TOKEN}"

Pricing

This Actor uses Pay Per Event pricing. You are charged per request, not per result.

Event	Description
request	Each successful API call (non-5xx response)

The price per request is shown on the Actor's pricing page. Requests that result in a server error (5xx) are not charged.

Integration Examples

JavaScript / Node.js

const response = await fetch(
    'https://glavier--google-web-search.apify.actor?query=web+scraping&limit=10',
    { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } }
);
const data = await response.json();
console.log(data.results);

Python

import requests

response = requests.get(
    'https://glavier--google-web-search.apify.actor',
    params={'query': 'web scraping', 'limit': 10},
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()
print(data['results'])

cURL

curl "https://glavier--google-web-search.apify.actor?query=web+scraping&limit=10" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN"

Support

For issues or feature requests, please use the Issues tab on this Actor's page.