Core search endpoint. One GET operation returns Google web, image, video, news, shopping and maps results (selected with tbm) plus Bing, Yandex, DuckDuckGo and YouTube results (selected with search_engine), with geolocation targeting across 200+ countries. Includes the account quota endpoint.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/zenserp-search-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Zenserp Search API
description: Zenserp SERP API.
version: '2.0'
contact:
name: Zenserp Support
url: https://zenserp.com/
email: support@zenserp.com
termsOfService: https://zenserp.com/terms-of-service/
x-logo:
url: https://zenserp.com/wp-content/uploads/2019/07/zenserp-logo.png
x-source: https://app.zenserp.com/documentation (endpoint list decompiled from the docs SPA bundle /js/app.js) + live unauthenticated probes 2026-08-13
servers:
- url: https://app.zenserp.com
description: Zenserp API host. Search, status and the list endpoints are under /api/v2; batches, trends and shopping product pages are under /api/v1.
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Search
description: Core search endpoints supporting all search types and engines.
paths:
/api/v2/search:
get:
operationId: search
summary: Universal Search
description: Submit a search query to Google (default), Bing, Yandex, or DuckDuckGo. The search type is controlled via the `tbm` parameter for Google variants (images, news, shopping, maps, video, trends) and via `engine` for alternative search engines.
tags:
- Search
parameters:
- name: q
in: query
required: true
description: The search query string.
schema:
type: string
example: pied piper
- name: apikey
in: query
required: false
description: Your Zenserp API key (alternative to header-based auth).
schema:
type: string
- name: tbm
in: query
required: false
description: Google search type modifier. Omit for web search. Use `isch` for image search, `nws` for news, `shop` for shopping, `map` for maps, `vid` for YouTube/video search, `trends` for Google Trends.
schema:
type: string
enum:
- isch
- nws
- shop
- map
- vid
- trends
- name: engine
in: query
required: false
description: Target search engine. Defaults to `google`. Set to `bing`, `yandex`, or `duckduckgo` for alternative engines.
schema:
type: string
enum:
- google
- bing
- yandex
- duckduckgo
default: google
- name: gl
in: query
required: false
description: Country code for geolocation targeting (ISO 3166-1 alpha-2). Determines the country-specific Google domain and results.
schema:
type: string
example: us
- name: hl
in: query
required: false
description: Language code for results (IETF BCP 47 / Google hl parameter).
schema:
type: string
example: en
- name: location
in: query
required: false
description: Canonical location name used for geolocation-specific results. Use the /locations list endpoint to get valid values.
schema:
type: string
example: New York,New York,United States
- name: num
in: query
required: false
description: Number of results to return (1–100).
schema:
type: integer
minimum: 1
maximum: 100
default: 10
- name: start
in: query
required: false
description: Offset for pagination (0-based index of the first result).
schema:
type: integer
minimum: 0
default: 0
- name: device
in: query
required: false
description: Emulate results for a specific device type.
schema:
type: string
enum:
- desktop
- mobile
- tablet
default: desktop
- name: tbs
in: query
required: false
description: 'Advanced Google search filters (time range, etc.). Example: `qdr:d` for past day, `qdr:w` for past week.'
schema:
type: string
- name: cr
in: query
required: false
description: Filter results to a specific country using a `country<ISO>` value (e.g., `countryUS`).
schema:
type: string
- name: lr
in: query
required: false
description: Restrict results to a specific language (e.g., `lang_en`).
schema:
type: string
- name: safe
in: query
required: false
description: Safe search setting.
schema:
type: string
enum:
- active
- false
default: false
- name: reverse
in: query
required: false
description: Set to `true` to perform a reverse image search. Requires `tbm=isch` and supplying an image URL via `q`.
schema:
type: boolean
default: false
responses:
'200':
description: Successful search response with structured JSON results.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResponse'
example:
request_info:
success: true
credits_used: 1
credits_remaining: 99
query:
q: pied piper
gl: us
hl: en
num: 10
engine: google
organic_results:
- position: 1
title: Pied Piper - Wikipedia
url: https://en.wikipedia.org/wiki/Pied_Piper
domain: en.wikipedia.org
description: The Pied Piper of Hamelin is a character in a German legend...
favicon: https://www.google.com/s2/favicons?domain=en.wikipedia.org
'500':
description: Internal Server Error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Validation failed -- one or more request parameters were rejected.
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationErrorResponse'
'403':
description: Forbidden -- API key is wrong, you don't have enough requests or you don't have enough rights to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found -- There were no results found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/api/v2/status:
get:
operationId: getStatus
summary: Status & Left Requests
description: This endpoint allows you to check the remaining requests of your API Key.
tags:
- Search
responses:
'200':
description: Remaining request quota for the API key.
content:
application/json:
schema:
$ref: '#/components/schemas/StatusResponse'
example:
remaining_requests: 1500
'403':
description: Forbidden -- API key is wrong, you don't have enough requests or you don't have enough rights to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found -- There were no results found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal Server Error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
post:
operationId: getStatusPost
summary: Status & Left Requests
description: This endpoint allows you to check the remaining requests of your API Key.
tags:
- Search
responses:
'200':
description: Remaining request quota for the API key.
content:
application/json:
schema:
$ref: '#/components/schemas/StatusResponse'
example:
remaining_requests: 1500
'403':
description: Forbidden -- API key is wrong, you don't have enough requests or you don't have enough rights to access it.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found -- There were no results found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: Internal Server Error.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
MapResult:
type: object
description: A single Google Maps local business result.
properties:
position:
type: integer
title:
type: string
address:
type: string
phone:
type: string
website:
type: string
format: uri
rating:
type: number
format: float
reviews:
type: integer
category:
type: string
hours:
type: string
description: Business hours summary.
latitude:
type: number
format: double
longitude:
type: number
format: double
OrganicResult:
type: object
description: A single organic (non-paid) search result.
properties:
position:
type: integer
description: 1-based ranking position in results.
title:
type: string
description: Title of the result.
url:
type: string
format: uri
description: URL of the result page.
domain:
type: string
description: Domain of the result.
description:
type: string
description: Snippet/description text for the result.
favicon:
type: string
format: uri
description: URL of the site favicon.
sitelinks:
type: array
description: Additional sub-links shown below the main result.
items:
type: object
properties:
title:
type: string
url:
type: string
format: uri
RelatedSearch:
type: object
description: A related search suggestion.
properties:
query:
type: string
description: Related query text.
VideoResult:
type: object
description: A single YouTube/video search result.
properties:
position:
type: integer
title:
type: string
url:
type: string
format: uri
channel:
type: string
description: Channel or uploader name.
published_at:
type: string
description: Video publication date or relative time.
duration:
type: string
description: Video duration (e.g., "5:32").
views:
type: string
description: View count as formatted string.
thumbnail:
type: string
format: uri
RequestInfo:
type: object
description: Metadata about the API request.
properties:
success:
type: boolean
description: Whether the request was successful.
credits_used:
type: integer
description: Number of API credits consumed by this request.
credits_remaining:
type: integer
description: Remaining credits in the current billing period.
QueryInfo:
type: object
description: Echo of the query parameters used for this search.
properties:
q:
type: string
description: The search query.
gl:
type: string
description: Country code used.
hl:
type: string
description: Language code used.
num:
type: integer
description: Number of results requested.
engine:
type: string
description: Search engine used.
tbm:
type: string
description: Search type modifier used.
location:
type: string
description: Geo location used.
FeaturedSnippet:
type: object
description: Google featured snippet (answer box).
properties:
title:
type: string
url:
type: string
format: uri
description:
type: string
type:
type: string
description: Snippet type (paragraph, table, list, etc.).
ShoppingResult:
type: object
description: A single Google Shopping product result.
properties:
position:
type: integer
title:
type: string
url:
type: string
format: uri
price:
type: string
description: Product price as a formatted string (e.g., "$29.99").
store:
type: string
description: Merchant/store name.
rating:
type: number
format: float
description: Product rating (0-5).
reviews:
type: integer
description: Number of reviews.
thumbnail:
type: string
format: uri
SearchResponse:
type: object
description: Top-level search result object returned by the /search endpoint.
properties:
request_info:
$ref: '#/components/schemas/RequestInfo'
query:
$ref: '#/components/schemas/QueryInfo'
organic_results:
type: array
description: List of organic (non-paid) search results.
items:
$ref: '#/components/schemas/OrganicResult'
paid_results:
type: array
description: List of paid advertisement results.
items:
$ref: '#/components/schemas/PaidResult'
featured_snippet:
$ref: '#/components/schemas/FeaturedSnippet'
knowledge_graph:
$ref: '#/components/schemas/KnowledgeGraph'
related_questions:
type: array
description: People Also Ask questions and answers.
items:
$ref: '#/components/schemas/RelatedQuestion'
related_searches:
type: array
description: Related search suggestions.
items:
$ref: '#/components/schemas/RelatedSearch'
image_results:
type: array
description: Image results (when tbm=isch).
items:
$ref: '#/components/schemas/ImageResult'
news_results:
type: array
description: News article results (when tbm=nws).
items:
$ref: '#/components/schemas/NewsResult'
shopping_results:
type: array
description: Shopping product results (when tbm=shop).
items:
$ref: '#/components/schemas/ShoppingResult'
map_results:
type: array
description: Local business results (when tbm=map).
items:
$ref: '#/components/schemas/MapResult'
video_results:
type: array
description: Video/YouTube results (when tbm=vid).
items:
$ref: '#/components/schemas/VideoResult'
trends_results:
type: array
description: Google Trends data points (when tbm=trends).
items:
$ref: '#/components/schemas/TrendsResult'
PaidResult:
type: object
description: A paid advertisement result.
properties:
position:
type: integer
description: Ad position.
title:
type: string
url:
type: string
format: uri
domain:
type: string
description:
type: string
displayed_url:
type: string
description: The URL as displayed in the ad.
StatusResponse:
type: object
description: Remaining request quota for the authenticated API key.
properties:
remaining_requests:
type: integer
description: Number of searches left in the current billing period.
example: 1500
TrendsResult:
type: object
description: A Google Trends comparison data point.
properties:
query:
type: string
description: The search term being tracked.
date:
type: string
description: Date or time period.
value:
type: integer
description: Relative popularity score (0-100).
RelatedQuestion:
type: object
description: A People Also Ask question-answer pair.
properties:
question:
type: string
answer:
type: string
url:
type: string
format: uri
title:
type: string
ValidationErrorResponse:
type: object
description: Zenserp validation error envelope, documented verbatim in the Error Codes section of the Zenserp documentation.
properties:
errors:
type: array
description: One object per failing request, keyed by parameter name.
items:
type: object
additionalProperties:
type: string
example:
errors:
- q: no query specified.
search_engine: search engine not found.
ErrorResponse:
type: object
description: 'Zenserp error envelope for request-level failures. Verbatim example from the live API: {"error": "No apikey provided."}'
properties:
error:
type: string
description: Human-readable error message.
example: No apikey provided.
KnowledgeGraph:
type: object
description: Google Knowledge Graph panel data.
properties:
title:
type: string
type:
type: string
description:
type: string
url:
type: string
format: uri
image:
type: string
format: uri
attributes:
type: object
additionalProperties:
type: string
description: Key-value entity attributes from the knowledge panel.
NewsResult:
type: object
description: A single news article result.
properties:
position:
type: integer
title:
type: string
url:
type: string
format: uri
source:
type: string
description: News source name.
published_at:
type: string
description: Publication timestamp or relative time.
thumbnail:
type: string
format: uri
ImageResult:
type: object
description: A single image search result.
properties:
position:
type: integer
title:
type: string
url:
type: string
format: uri
image_url:
type: string
format: uri
description: Direct URL to the image.
thumbnail:
type: string
format: uri
description: URL to thumbnail version.
source:
type: string
description: Originating website domain.
securitySchemes:
apiKeyHeader:
type: apiKey
in: header
name: apikey
description: API key passed in the request header.
apiKeyQuery:
type: apiKey
in: query
name: apikey
description: API key passed as a query parameter.