REST API Overview

The SearchMCP REST API gives you fast, reliable Google search results via JSON over HTTPS. Use it from any backend, script, or integration.

Prerequisite: You’ll need an API key. Create and manage keys at Manage Keys and read the API Keys guide.

🔑 Base URL & Authentication

Base URL

https://api.searchmcp.io

Headers

• X-API-Key — required
• Content-Type: application/json

API keys are tied to your team and enforce credits and rate limits.

📍 Endpoint

POST /v1/search

One endpoint, all search types — just set the resultType in your request.

📚 API Reference

👉 Explore request/response contracts and try live calls in the interactive API Reference page.

• Request Schema: SearchRequest
• Response Schema: SearchResponse

The API Reference is the source of truth for all fields, models, and error codes.

🚀 Next Steps

• Generate an API key at Manage Keys
• Explore the API Reference and download the OpenAPI spec
• Review Credits & Tiers and Rate Limits