Install the SerpApi client library and configure API key authentication. SerpApi provides structured JSON results from Google, Bing, YouTube, and 15+ search engines. Auth is API-key-based via the api_key parameter or SERPAPI_API_KEY env var.
# Python (official)
pip install serpapi
# Node.js (official)
npm install serpapi
# Alternative Python package (legacy but widely used)
pip install google-search-results
# .env
SERPAPI_API_KEY=your-api-key-here
import serpapi, os
client = serpapi.Client(api_key=os.environ["SERPAPI_API_KEY"])
result = client.search(engine="google", q="test", num=1)
print(f"Connected! Search ID: {result['search_metadata']['id']}")
import { getJson } from 'serpapi';
const result = await getJson({
engine: 'google', q: 'test', num: 1,
api_key: process.env.SERPAPI_API_KEY,
});
console.log(`Connected! Search ID: ${result.search_metadata.id}`);
curl "https://serpapi.com/account.json?api_key=$SERPAPI_API_KEY" | jq '{
plan: .plan_name, used: .this_month_usage, remaining: .plan_searches_left
}'
Connected! Search ID: 64a1b2c3d4e5f6
{ plan: "Developer", used: 42, remaining: 4958 }
| Error | Cause | Solution |
|---|---|---|
Invalid API key |
Wrong or missing key | Check serpapi.com/manage-api-key |
Your account is disabled |
Exceeded limits | Upgrade or wait for monthly reset |
ModuleNotFoundError |
Not installed | pip install serpapi |
Proceed to serpapi-hello-world for your first search.