Google Maps and local places search results.
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/valueserp:valueserp-places-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: ValueSERP Search Places API
description: Real-time Google SERP data API supporting organic search, shopping, news, images, places, and product results via simple GET requests authenticated with an API key. Returns structured JSON with organic results, ads, knowledge graphs, answer boxes, AI overviews, and more. Operated by Traject Data.
version: '1.0'
contact:
name: ValueSERP Support
url: https://trajectdata.com/serp/value-serp-api/
termsOfService: https://trajectdata.com/serp/value-serp-api/
x-api-id: valueserp-search
servers:
- url: https://api.valueserp.com
description: ValueSERP Production API
security:
- apiKeyQuery: []
tags:
- name: Places
description: Google Maps and local places search results.
paths:
/search#places:
get:
operationId: googlePlaces
summary: Google Maps / Places Search
description: Retrieve real-time Google Maps local business listings and places results for a given search term. Set search_type=places.
tags:
- Places
parameters:
- $ref: '#/components/parameters/api_key'
- name: search_type
in: query
required: true
schema:
type: string
enum:
- places
description: Must be set to "places" for Maps/Places search.
example: places
- $ref: '#/components/parameters/q'
- $ref: '#/components/parameters/location'
- $ref: '#/components/parameters/location_auto'
- $ref: '#/components/parameters/google_domain'
- $ref: '#/components/parameters/gl'
- $ref: '#/components/parameters/hl'
- $ref: '#/components/parameters/nfpr'
- $ref: '#/components/parameters/page'
- $ref: '#/components/parameters/max_page'
- $ref: '#/components/parameters/uule'
responses:
'200':
description: Successful places search response
content:
application/json:
schema:
$ref: '#/components/schemas/PlacesResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
'503':
$ref: '#/components/responses/ServiceUnavailable'
components:
parameters:
nfpr:
name: nfpr
in: query
required: false
schema:
type: integer
enum:
- 0
- 1
description: Exclude auto-corrected spelling results. Set to 1 to exclude, 0 to include (default).
example: 0
hl:
name: hl
in: query
required: false
schema:
type: string
default: en
description: Determines the Google UI language to return results in. BCP-47 language code.
example: en
max_page:
name: max_page
in: query
required: false
schema:
type: integer
minimum: 1
description: Retrieve multiple result pages in a single API request. Specifies the maximum page number to retrieve.
example: 3
google_domain:
name: google_domain
in: query
required: false
schema:
type: string
default: google.com
description: The Google domain to use for the search.
example: google.com
location:
name: location
in: query
required: false
schema:
type: string
description: Geographic location for the search. Accepts location names (e.g., "manhattan,new york,united states") or GPS coordinates (e.g., "lat 43.437677,lon 3.8392765").
example: united states
page:
name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
description: The results page number to retrieve. Defaults to 1.
example: 1
q:
name: q
in: query
required: true
schema:
type: string
description: The keyword or search query to use.
example: pizza
location_auto:
name: location_auto
in: query
required: false
schema:
type: boolean
default: true
description: When true, automatically updates gl and hl parameters based on the built-in location value. Defaults to true.
api_key:
name: api_key
in: query
required: true
schema:
type: string
description: Your ValueSERP API key. Use "demo" for testing limited queries.
example: demo
uule:
name: uule
in: query
required: false
schema:
type: string
description: Custom Google UULE parameter to override the location.
gl:
name: gl
in: query
required: false
schema:
type: string
default: us
description: Determines the Google country to use for the query. ISO 3166-1 alpha-2 country code.
example: us
schemas:
SearchMetadata:
type: object
description: Metadata about the search execution.
properties:
id:
type: string
description: Unique identifier for this search request.
google_url:
type: string
format: uri
description: The Google URL that was scraped to generate results.
total_time_taken:
type: number
format: float
description: Total time taken to process the request in seconds.
created_at:
type: string
format: date-time
description: Timestamp when the search was created.
RequestInfo:
type: object
description: Meta-information about the API request status.
properties:
success:
type: boolean
description: Whether the request was processed successfully.
message:
type: string
description: Status message (present on errors or incidents).
credits_used:
type: integer
description: Number of credits consumed by this request.
credits_remaining:
type: integer
description: Number of credits remaining in the account.
SearchParameters:
type: object
description: Echo of the parameters used for the search.
properties:
q:
type: string
description: The search query keyword used.
search_type:
type: string
description: The type of search performed.
gl:
type: string
description: Country code used.
hl:
type: string
description: Language code used.
google_domain:
type: string
description: Google domain used.
PlacesResponse:
type: object
description: Google Maps / Places search results response.
properties:
request_info:
$ref: '#/components/schemas/RequestInfo'
search_metadata:
$ref: '#/components/schemas/SearchMetadata'
search_parameters:
$ref: '#/components/schemas/SearchParameters'
places:
type: array
items:
$ref: '#/components/schemas/PlaceResult'
description: Local business/place listings.
ErrorResponse:
type: object
description: Error response body.
properties:
request_info:
type: object
properties:
success:
type: boolean
example: false
message:
type: string
description: Human-readable error message.
PlaceResult:
type: object
description: A single Google Maps / Places result.
properties:
position:
type: integer
description: Position in results.
title:
type: string
description: Name of the place.
place_id:
type: string
description: Google Place ID.
address:
type: string
description: Physical address.
rating:
type: number
format: float
description: Average star rating (1-5).
reviews:
type: integer
description: Total number of reviews.
type:
type: string
description: Business category/type.
phone:
type: string
description: Phone number.
website:
type: string
format: uri
description: Business website URL.
hours:
type: string
description: Business hours.
latitude:
type: number
format: double
description: Geographic latitude.
longitude:
type: number
format: double
description: Geographic longitude.
responses:
Unauthorized:
description: Unauthorized - The api_key supplied is not valid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
ServiceUnavailable:
description: Service Unavailable - Returned during parsing incidents. Requests are not charged. Use skip_on_incident=true to opt out automatically.
headers:
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
TooManyRequests:
description: Too Many Requests - Your plan's rate limit has been exceeded.
headers:
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalServerError:
description: Internal Server Error - Retry after a delay; contact support if the issue persists.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
PaymentRequired:
description: Payment Required - Your ValueSERP account has run out of available credits or there is a payment issue.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
BadRequest:
description: Bad Request - Invalid parameters or unsupported parameter combinations.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
apiKeyQuery:
type: apiKey
in: query
name: api_key
description: API key for authentication. Pass as the api_key query parameter. Use "demo" as the key for testing.