Google web search for AI agents: title, link and snippet in Custom Search JSON API format.
One address for any MCP client. Your key stays in your Odel vault.
Not assessed yet.
Odel charges nothing per call. The publisher may charge for its own service.
| Access to | Read | Change |
|---|---|---|
| Full api access | Not stated: full_api_access | |
From the sign-in at console-backend.apify.com, as the endpoint publishes it. You approve it there.
Odel could not list its tools without signing in.
Google Custom Search API Alternative is an Apify Actor that replaces Google's Custom Search JSON API, which Google has closed to new customers and retires on 1 January 2027. It answers the same /customsearch/v1 requests with the same JSON (items with title, link, displayLink and snippet, plus image search), built from live Google results, at $5 per 1,000 searches with no daily cap.
Price: $5 per 1,000 searches of up to 10 results ($4 on Gold and above) · Run it: https://apify.com/automationnation/google-custom-search-api · Guide: https://retracn.github.io/automationnation-actors/google-custom-search-api/
Change the endpoint and the key; keep the rest of your code:
| Before | After | |
|---|---|---|
| Endpoint | https://www.googleapis.com/customsearch/v1 | https://automationnation--google-custom-search-api.apify.actor/customsearch/v1 |
| Auth | key=YOUR_GOOGLE_KEY&cx=YOUR_ENGINE_ID | token=YOUR_APIFY_TOKEN or header Authorization: Bearer YOUR_APIFY_TOKEN |
curl "https://automationnation--google-custom-search-api.apify.actor/customsearch/v1?q=best+crm+for+startups&num=10&token=$APIFY_TOKEN"
Python (examples/cse_requests.py) and JavaScript (examples/cse_fetch.mjs) versions are in examples/. The response is the API's JSON: items[].title, link, displayLink, snippet, queries.nextPage and searchInformation; searchType=image works too.
{
"queries": [
"best project management software"
],
"maxResultsPerQuery": 10
}
REST API
curl -X POST "https://api.apify.com/v2/acts/automationnation~google-custom-search-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"queries": ["best project management software"], "maxResultsPerQuery": 10}'
Python — see examples/python_example.py
# pip install apify-client
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("automationnation/google-custom-search-api").call(run_input={
"queries": [
"best project management software"
],
"maxResultsPerQuery": 10
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item.get("title"), item.get("link"), item.get("displayLink"), item.get("snippet"))
JavaScript — see examples/node_example.mjs
// npm install apify-client
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('automationnation/google-custom-search-api').call({
"queries": [
"best project management software"
],
"maxResultsPerQuery": 10
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.title, item.link, item.displayLink, item.snippet);
Hosted MCP server URL (Claude, ChatGPT, Cursor and other clients with remote MCP support):
https://mcp.apify.com?tools=automationnation/google-custom-search-api
Local config for Claude Desktop / Cursor — mcp/claude_desktop_config.json:
{
"mcpServers": {
"google-custom-search-api": {
"command": "npx",
"args": [
"-y",
"@apify/actors-mcp-server",
"--tools",
"automationnation/google-custom-search-api"
],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
When does the Custom Search JSON API stop working? Google closed it to new customers and says existing customers have until 1 January 2027 to move to an alternative.
Do I have to rewrite my code? No. Change the endpoint to https://automationnation--google-custom-search-api.apify.actor/customsearch/v1 and send an Apify API token instead of the Google key; the parameters and the JSON response stay the same.
Can I keep my Programmable Search Engine's site list? Not through cx, which is ignored. Pass one site as siteSearch, or several in the query as site:a.com OR site:b.com.
What does it cost? $5 per 1,000 searches of up to 10 results ($4.50 on Silver, $4 on Gold and above), with no daily cap. Google charged $5 per 1,000 after 100 free queries a day; Apify's free plan includes $5 of monthly credit, about 1,000 searches.
This repository holds usage examples. The scraper itself runs on the Apify platform; you need a free Apify account and API token. Examples are MIT licensed.