Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Captapi Google Maps API
version: 0.1.0
summary: Structured public data from social platforms through one REST API.
description: 'Captapi returns public data (profiles, posts, comments, transcripts, search, ads, commerce) from social platforms as JSON.
Auth: send your key as `Authorization: Bearer capt_live_...` or `X-API-Key: capt_live_...`. Keys are created by a human at https://captapi.com/dashboard/api-keys.
Billing: each operation states its cost in `x-credit-cost`. The `X-Captapi-Credits` response header shows what was charged. Failed requests (4xx/5xx) are not billed. `cache=true` serves from the 24h cache, free on a hit where `billedOnCacheHit` is false. Where the price depends on which path served the call, `x-credit-cost.note` gives the full rule and the range we have observed.
Empty results: on many list and search endpoints a call that ran but found nothing is charged 0 credits (for example an ad-library or profile search with no matches). Where an empty result is still billed, the endpoint description says so; Google Maps business search, for instance, bills its one page because the lookup ran. The `X-Captapi-Credits` header always shows the actual charge.
Errors: every non-2xx response uses the same envelope, `{ success: false, error: { code, message, retryable } }`. Retry only when `retryable` is true, honouring `Retry-After`.
Timing: every response carries `Server-Timing: total;dur=`, the total time the request took. Deprecated: the `timings` object some endpoints still return in `data` will be removed from response bodies on 2026-12-17; use the header instead. It is not part of the response schemas below.
Response schemas are inferred from real captured responses and list the fields seen there plus documented top-level fields. Fields can be null when a platform does not expose them.
Endpoint list: https://captapi.com/llms-endpoints.txt · Guide for agents: https://captapi.com/llms.txt · MCP: https://captapi.com/mcp.json'
contact:
name: Captapi support
email: support@captapi.com
url: https://captapi.com
termsOfService: https://captapi.com/legal/terms
license:
name: Captapi Terms of Service
url: https://captapi.com/legal/terms
servers:
- url: https://api.captapi.com
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Google Maps
description: Public data from Google Maps.
paths:
/v1/google/business-search:
get:
operationId: google_maps_business_search
tags:
- Google Maps
summary: Google Maps Business Search API
description: 'Local businesses from a Maps search — name, address, phone, website, rating, hours, place id.
Search Google Maps for a keyword and get up to 100 businesses. q is required (min 2 characters). Pass location as a place name — Austin, TX, Istanbul, Turkey, Paris, France, Brooklyn, NY, or a country such as Germany — or omit it and use locationCode (default 2840, the United States). The response echoes the matched place name and its locationCode. A city name shared by several places (Paris, London) returns 400 with suggestions and costs nothing; add the region or country. language defaults to en. limit is 1–100 and is not a page you can walk: there is no nextCursor. A call that returns businesses costs 2 credits. An empty result (businesses: []) costs 0 credits, and failures cost 0. phone, website, rating, and reviewCount are null when Maps does not publish them — null is not zero. hoursStatus is Maps'' own open/closed label (for example open or close), not a boolean we invented. image URLs are hosted by Google and can expire; there is no expiresAt. Ads and other non-business rows are left out and counted in omittedCount. This endpoint does not return owner emails. cache defaults to false. cache=true reuses a 24 hour response, and cache hits are free. The sample is one live listing captured on 10 October 2026, with every field Maps published on that row filled in. Other listings still leave unpublished fields null.
Docs: https://captapi.com/apis/google-maps-business-search'
security:
- bearerAuth: []
- apiKeyHeader: []
parameters:
- name: q
in: query
required: true
description: Keyword, for example plumber or coffee. Min 2 characters.
schema:
type: string
minLength: 2
maxLength: 200
example: The Backspace
- name: location
in: query
required: false
description: 'Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored.'
schema:
type: string
maxLength: 180
- name: locationCode
in: query
required: false
description: Numeric place code, used only when location is omitted. Default 2840 (United States).
schema:
type: integer
maximum: 10000000
minimum: 1
- name: language
in: query
required: false
description: Language code, for example en. Default en.
schema:
type: string
minLength: 2
maxLength: 5
default: en
example: en
- name: limit
in: query
required: false
description: Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits per call; zero businesses is 0 credits.
schema:
type: integer
maximum: 100
minimum: 1
default: 20
example: 20
- name: cache
in: query
required: false
description: Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
schema:
type: boolean
default: false
example: false
x-credit-cost:
credits: 2
label: 2 credits
billedOnCacheHit: false
x-one-liner: Local businesses from a Maps search — name, address, phone, website, rating, hours, place id.
responses:
'200':
description: Success. The data object for this endpoint.
headers:
X-Captapi-Credits:
$ref: '#/components/headers/Credits'
X-Captapi-Cache:
$ref: '#/components/headers/Cache'
X-Captapi-Request-Id:
$ref: '#/components/headers/RequestId'
Server-Timing:
$ref: '#/components/headers/ServerTiming'
content:
application/json:
schema:
type: object
required:
- success
- data
properties:
success:
const: true
data:
type: object
properties:
query:
type: string
description: The keyword you sent.
location:
type: string
description: Place the search ran in, as Maps names it (Austin,Texas,United States). Null when you used locationCode instead.
locationCode:
type: integer
description: Numeric place code that was used. 2840 is the United States.
language:
type: string
description: Language code that was used. Default en.
limit:
type: integer
description: Max businesses requested (1–100). Not a page cursor.
totalReturned:
type: integer
description: How many businesses are in businesses[].
omittedCount:
type: integer
description: Rows that were not businesses (ads and other listing types) and were left out of businesses[].
businesses:
type: array
items:
type: object
properties:
rank:
type: integer
description: Position in the Maps results (1-based).
title:
type: string
description: Business name.
category:
type: string
description: Primary Maps category. Null when omitted.
additionalCategories:
type: array
items:
type: string
description: Extra Maps categories. Null when the listing has none.
snippet:
type: string
description: Short Maps blurb. Null when omitted.
address:
type: string
description: Single-line address. Null when omitted.
city:
type: string
description: City from the address. Null when omitted.
region:
type: string
description: Region or state from the address. Null when omitted.
zip:
type: string
description: Postal code. Null when omitted.
countryCode:
type: string
description: Country code from the address. Null when omitted.
phone:
type: string
description: Phone number as published. Null when Maps does not show one — not an empty string.
website:
type: string
description: Business website. Null when Maps does not show one.
contactUrl:
type: string
description: Maps contact link when published. Null otherwise.
bookOnlineUrl:
type: string
description: Maps booking link when published. Null otherwise.
rating:
type: number
description: Star rating when published. Null when omitted — not zero.
reviewCount:
type: integer
description: Number of ratings when published. Null when omitted — not zero.
ratingDistribution:
type: object
properties:
'1':
type: integer
'2':
type: integer
'3':
type: integer
'4':
type: integer
'5':
type: integer
description: Count of 1–5 star ratings when published. Null when omitted.
priceLevel:
type: string
description: Maps price label when published, such as inexpensive or moderate. Null when omitted.
latitude:
type: number
description: Latitude. Null when omitted.
longitude:
type: number
description: Longitude. Null when omitted.
placeId:
type: string
description: Maps place id.
cid:
type: string
description: Maps customer id, when published.
mapsUrl:
type: string
description: Maps URL for this place, built from placeId (or cid when placeId is missing).
image:
type: string
description: Photo URL hosted by Google. It can expire. There is no expiresAt.
photoCount:
type: integer
description: Photo count when published. Null when omitted.
isClaimed:
type: boolean
description: Whether the listing is claimed. Null when omitted.
hoursStatus:
type: string
description: Maps' current open/closed label when published (for example open or close). Null when omitted. Not a boolean.
hours:
type: object
properties:
sunday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
monday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
tuesday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
wednesday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
thursday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
friday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
saturday:
type: array
items:
type: object
properties:
open:
type: object
properties:
hour:
type: integer
minute:
type: integer
close:
type: object
properties:
hour:
type: integer
minute:
type: integer
description: Weekly timetable when published. Null when omitted.
isDirectoryItem:
type: boolean
description: True when the row is a directory listing. Null when omitted.
example:
success: true
data:
query: The Backspace
location: Austin,Texas,United States
locationCode: 1026201
language: en
limit: 1
totalReturned: 1
omittedCount: 0
businesses:
- rank: 1
title: The Backspace
category: Pizza
additionalCategories:
- Italian restaurant
- Restaurant
snippet: 507 San Jacinto Blvd, Austin, TX 78701
address: 507 San Jacinto Blvd, Austin, TX 78701
city: Austin
region: Texas
zip: '78701'
countryCode: US
phone: +1512-474-9899
website: https://www.backspacepizza.com/?utm_source=GMBlisting&utm_medium=organic
contactUrl: https://party-request.tripleseat.com/venues/O476HqLy/?rwg_token=AE37R_i_o_MnaL1e65JJJvaOltQTL9_QXm5sl_BttOhPUA7uJzO396kceRBPO9SmXs8ST8w4slgTPqEDJNYOTalzcn2EkPCQ-w%3D%3D
bookOnlineUrl: https://www.google.com/maps/reserve/v/dine/c/ooA7fdRRGqw?source=pa&opi=79508299&hl=en-US&gei=HD7KarawF_38wbkP5Mq6wQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26authuser%3D0%26hl%3Den%26gl%3Dus%26pb%3D!4m9!1m3!1d546887.6385058826!2d-97.7430608!3d30.267153!2m0!3m2!1i1920!2i945!4f13.1!7i1!8i0!10b1!12m28!1m1!18b1!2m3!5m1!6e2!20e3!6m12!4b1!49b1!63m0!73m0!74i150000!75b1!85b1!89b1!91b1!110m0!114b1!149b1!10b1!14b1!16b1!17m1!3e1!20m3!5e2!6b1!14b1!19m4!2m3!1i360!2i120!4i8!20m57!2m2!1i203!2i100!3m2!2i4!5b1!6m6!1m2!1i86!2i86!1m2!1i408!2i240!7m42!1m3!1e1!2b0!3e3!1m3!1e2!2b1!3e2!1m3!1e2!2b0!3e3!1m3!1e8!2b0!3e3!1m3!1e10!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e9!2b1!3e2!1m3!1e10!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e10!2b0!3e4!2b1!4b1!9b0!22m6!1s!2s!4m1!2i20588!7e81!12e3!24m78!1m25!13m9!2b1!3b1!4b1!6i1!8b1!9b1!14b1!20b1!25b1!18m14!3b1!4b1!5b1!6b1!13b1!14b1!15b1!17b1!21b1!22b0!25b0!27m1!1b0!28b0!2b1!5m6!2b1!3b1!5b1!6b1!7b1!10b1!10m1!8e3!11m1!3e1!14m1!3b1!17b1!20m2!1e3!1e6!24b1!25b1!26b1!29b1!30m1!2b1!36b1!39m3!2m2!2i1!3i1!43b1!52b1!54m1!1b1!55b1!56m2!1b1!3b1!65m5!3m4!1m3!1m2!1i224!2i298!71b1!72m4!1m2!3b1!5b1!4b1!89b1!103b1!113b1!26m4!2m3!1i80!2i92!4i8!30m28!1m6!1m2!1i0!2i0!2m2!1i530!2i945!1m6!1m2!1i1870!2i0!2m2!1i1920!2i945!1m6!1m2!1i0!2i0!2m2!1i1920!2i20!1m6!1m2!1i0!2i925!2m2!1i1920!2i945!31b1!34m19!2b1!3b1!4b1!6b1!7b1!8m6!1b1!3b1!4b1!5b1!6b1!7b1!9b1!12b1!14b1!20b1!23b1!25b1!26b1!37m1!1e81!42b1!46m1!1e2!47m0!49m6!3b1!6m2!1b1!2b1!7m1!1e3!50m32!1m28!2m7!1u3!4s!5e1!9s!10m2!3m1!1e1!2m7!1u2!4s!5e1!9s!10m2!2m1!1e1!3m6!1u17!2m4!1m2!17m1!1e2!2s!3m1!1u2!3m1!1u3!4BIAE!2e2!3m1!3b1!61b1!67m5!7b1!10b1!14b1!15m1!1b0!69i780!77b1%26q%3DThe%2BBackspace%26ech%3D1
rating: 4.5
reviewCount: 842
ratingDistribution:
'1': 22
'2': 21
'3': 41
'4': 149
'5': 609
priceLevel: moderate
latitude: 30.2670094
longitude: -97.7404066
placeId: ChIJVaujmae1RIYRpGyZcs9VBao
cid: '12251292710800551076'
mapsUrl: https://www.google.com/maps/search/?api=1&query=The%20Backspace&query_place_id=ChIJVaujmae1RIYRpGyZcs9VBao
image: https://lh3.googleusercontent.com/grass-cs/AABkmLcIWRZviuv3jSiEDY36-7lOH1ag7TpPvLt3kIn-Dig0aM8HLNWGc9Lekz7Ia46FSyBDdDPZuc30kK8DEb4ebQejzCJke055K3jXy0SQcTLTe_KgHToXulcT4YIpyLhWGBnqzPLS=w408-h306-k-no
photoCount: 629
isClaimed: true
hoursStatus: close
hours:
sunday:
- open:
hour: 17
minute: 0
close:
hour: 21
minute: 0
monday:
- open:
hour: 17
minute: 0
close:
hour: 21
minute: 0
tuesday:
- open:
hour: 11
minute: 30
close:
hour: 21
minute: 0
wednesday:
- open:
hour: 11
minute: 30
close:
hour: 21
minute: 0
thursday:
- open:
hour: 11
minute: 30
close:
hour: 21
minute: 0
friday:
- open:
hour: 11
minute: 30
close:
hour: 22
minute: 0
saturday:
- open:
hour: 11
minute: 30
close:
hour: 22
minute: 0
isDirectoryItem: false
'400':
$ref: '#/components/responses/Error400'
'401':
$ref: '#/components/responses/Error401'
'402':
$ref: '#/components/responses/Error402'
'404':
$ref: '#/components/responses/Error404'
'422':
$ref: '#/components/responses/Error422'
'429':
$ref: '#/components/responses/Error429'
'502':
$ref: '#/components/responses/Error502'
components:
responses:
Error429:
description: Rate limit reached. Wait for Retry-After seconds. Not billed.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: rate_limit_exceeded
message: rate limit exceeded
retryable: true
plan: starter
limit_per_minute: 120
Error422:
description: A required parameter is missing or has the wrong type. Not billed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: VALIDATION_ERROR
message: Request validation failed. Fix the listed fields and retry.
retryable: false
issues:
- type: missing
loc:
- query
- url
msg: Field required
input: null
Error404:
description: The resource does not exist or is not public. Not billed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: NOT_FOUND
message: Monitor not found
retryable: false
Error502:
description: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.
headers:
Retry-After:
$ref: '#/components/headers/RetryAfter'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: UPSTREAM_UNAVAILABLE
message: The upstream data source failed for this request. Retry shortly.
retryable: true
Error401:
description: Missing, invalid or revoked API key. Not billed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: UNAUTHORIZED
message: Invalid or revoked API key
retryable: false
Error400:
description: 'Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: WRONG_RESOURCE_TYPE
message: Expected a TikTok URL, but received a YouTube URL. Use the YouTube endpoint for that URL, or pass a TikTok URL like https://www.tiktok.com/@user/video/1234567890.
retryable: false
suggestedEndpoint: /v1/youtube/video-details
Error402:
description: Not enough credits for this request. Not billed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
success: false
error:
code: insufficient_credits
message: This call needs 2 credits; 1 available. No credits charged.
retryable: false
required: 2
available: 1
upgrade_url: /dashboard/billing
headers:
ServerTiming:
description: 'Total time the request took, in milliseconds: `total;dur=<ms>`. No per-step breakdown.'
schema:
type: string
example: total;dur=4387
Cache:
description: 1 when the response was served from the 24h cache, 0 otherwise.
schema:
type: string
enum:
- '0'
- '1'
RequestId:
description: Request id. Include it when contacting support.
schema:
type: string
RetryAfter:
description: Seconds to wait before retrying.
schema:
type: integer
Credits:
description: Credits charged for this request. 0 on a free cache hit or a failed request.
schema:
type: integer
schemas:
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: object
required:
- code
- message
- retryable
properties:
code:
type: string
description: Machine-readable error code, e.g. WRONG_RESOURCE_TYPE, NOT_FOUND, insufficient_credits, rate_limit_exceeded. Compare case-sensitively; both upper and lower case codes exist.
message:
type: string
description: Human-readable explanation.
retryable:
type: boolean
description: true when the same request may succeed later (429, most 5xx). Do not retry when false.
suggestedEndpoint:
type:
- string
- 'null'
description: On platform mismatch, the endpoint that matches the URL you sent.
additionalProperties: true
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Your API key: `Authorization: Bearer capt_live_...`. Create one at https://captapi.com/dashboard/api-keys.'
apiKeyHeader:
type: apiKey
in: header
name: X-API-Key
description: 'Alternative to the bearer header: `X-API-Key: capt_live_...`.'
externalDocs:
description: Docs
url: https://captapi.com/docs