Google Search Configuration Guide

October 30, 2025 · View on GitHub

Overview

Using Google Custom Search service requires configuring two key parameters:

Search Engine ID (Custom Search Engine ID)
API Key (API Key)

Prerequisites

Before starting configuration, please ensure you have a Google account and access the following official configuration pages:

📋 Official Documentation: https://developers.google.com/custom-search/v1/overview

Configuration Page

Step 1: Configure Search Engine ID

1.1 Access Configuration Page

🔗 Configuration URL: https://programmablesearchengine.google.com/controlpanel/all

1.2 Create Custom Search Engine

Follow these steps to create your custom search engine:

Step 1: Enter the search engine creation page Configuration Page

Step 2: Fill in basic search engine information Configuration Page

Step 3: Complete creation and get Search Engine ID Configuration Page

1.3 Get Search Engine ID

✅ After configuration is complete, you will get a unique custom search engine ID, which is the required Search Engine ID.

Step 2: Configure API Key

2.1 Access API Configuration Page

🔗 Configuration URL: https://developers.google.com/custom-search/v1/overview

2.2 Create API Key

Follow these steps to get your API key:

Step 1: Enter API key management page Configuration Page

Step 2: Create and configure API key Configuration Page

2.3 Enable Custom Search API

Go to Google Cloud Console
Select or create a project
Enable the "Custom Search JSON API"
Create credentials (API Key)
Copy the generated API key

Step 3: Configure Parameters in VoidMuse

3.1 Parameter Configuration

Configure the obtained Google search parameters in VoidMuse:

Configuration Page

3.2 Configuration Item Description

Configuration Item	Description	How to Obtain
Search Engine ID	Unique identifier for custom search engine	Obtained in Step 1
API Key	Google API access key	Obtained in Step 2

Pricing Information

Free Quota

🆓 Custom Search JSON API provides the following free services:

Daily free queries: 100 search queries
Use case: Personal development, small-scale testing

Paid Plans

💰 If you need more queries, you can upgrade through the following:

Quota Type	Query Count	Price	Description
Free Quota	100/day	Free	No payment required
Paid Quota	Additional queries	$5/1000 queries	Need to register billing service in API console
Maximum Limit	10,000/day	-	Daily query limit

Billing Information

📊 Important Information:

Billing is based on actual API calls
Free quota resets daily
Paid usage is charged monthly
Set up billing alerts to monitor usage

Configuration Verification

Test Search Functionality

After configuration, test the search functionality:

Open VoidMuse
Navigate to search settings
Enter test query
Verify search results are returned
Check for any error messages

Common Test Queries

"JavaScript tutorial"
"Python best practices"
"React hooks guide"
"Machine learning basics"

Troubleshooting

Common Issues

API Key Issues

Invalid API Key: Verify key is copied correctly
API Not Enabled: Ensure Custom Search JSON API is enabled
Quota Exceeded: Check daily usage limits
Billing Required: Set up billing for paid usage

Search Engine Issues

Invalid Search Engine ID: Verify ID is copied correctly
No Results: Check search engine configuration
Access Denied: Verify API key permissions
Rate Limiting: Respect API rate limits

Error Messages

Error Message	Cause	Solution
"Invalid API key"	Incorrect or expired API key	Regenerate and update API key
"Quota exceeded"	Daily limit reached	Wait for reset or upgrade plan
"Search engine not found"	Invalid Search Engine ID	Verify and update Search Engine ID
"Access forbidden"	Insufficient permissions	Check API key permissions

Debug Steps

Verify Credentials
- Check API key format
- Confirm Search Engine ID
- Test with Google's API Explorer
Check Configuration
- Verify VoidMuse settings
- Test with curl command
- Review error logs
Monitor Usage
- Check quota consumption
- Review billing status
- Set up usage alerts