> ## Documentation Index
> Fetch the complete documentation index at: https://voyant.travel/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a Google restaurant search synchronously

> Execute a live Google Maps restaurant search and return the results immediately. Requires scope `data:restaurants:read`.



## OpenAPI

````yaml /api-specs/data.json post /data/restaurants/v1/google/restaurant-searches:run
openapi: 3.1.0
info:
  title: Voyant Data API
  version: 1.0.0
  description: >-
    Public REST API for the Voyant Data product. Voyant Data is a set of
    Cloudflare Workers served behind the public gateway at
    https://api.voyant.travel. Each sub-product worker mounts internally at
    /v1/... and is exposed publicly under /data/{product}/v1/*. Sub-products:
    geo, air, fx, reviews, hotels, restaurants, experiences. Authentication is a
    bearer API token scoped per sub-product (data:{product}:read). List/search
    endpoints return { data, totalCount, nextCursor? }; single-item endpoints
    return { data }. Error bodies carry a stable code (NOT_FOUND,
    INVALID_REQUEST, INVALID_CURSOR, UPSTREAM_FAILED, INTERNAL_AUTH_REQUIRED,
    RATE_LIMITED).
servers:
  - url: https://api.voyant.travel
    description: Voyant Data public gateway
security:
  - bearerAuth: []
tags:
  - name: Geo
    description: >-
      Canonical travel geography (countries, regions, cities, ports, waterways)
      plus language and timezone reference lookups. Scope: data:geo:read
  - name: Air
    description: >-
      Aviation reference data: airports, airlines, aircraft. Scope:
      data:air:read
  - name: FX
    description: >-
      Currency exchange (exchangerate-api.com white-label) plus the ISO 4217
      currency catalog. Scope: data:fx:read
  - name: Reviews
    description: >-
      Google Reviews / Extended Reviews / Q&A and Trustpilot. Scope:
      data:reviews:read
  - name: Hotels
    description: 'Google Hotels and TripAdvisor (hotel-scoped). Scope: data:hotels:read'
  - name: Restaurants
    description: 'TripAdvisor restaurants. Scope: data:restaurants:read'
  - name: Experiences
    description: 'TripAdvisor attractions / experiences. Scope: data:experiences:read'
paths:
  /data/restaurants/v1/google/restaurant-searches:run:
    post:
      tags:
        - Restaurants
      summary: Run a Google restaurant search synchronously
      description: >-
        Execute a live Google Maps restaurant search and return the results
        immediately. Requires scope `data:restaurants:read`.
      operationId: restaurantsRunGoogleRestaurantSearch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpaqueRecord'
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SingleResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '502':
          $ref: '#/components/responses/UpstreamFailed'
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >-
            import { createVoyantDataClient } from "@voyant-travel/data-sdk";


            const data = createVoyantDataClient({ apiKey:
            process.env.VOYANT_API_KEY });


            const result = await
            data.restaurants.google.restaurantSearches.run({});
        - lang: bash
          label: cURL
          source: |-
            curl --request POST \
              --url https://api.voyant.travel/data/restaurants/v1/google/restaurant-searches:run \
              --header 'Authorization: Bearer <token>' \
              --header 'Content-Type: application/json' \
              --data '{}'
        - lang: javascript
          label: Node
          source: >-
            const response = await
            fetch("https://api.voyant.travel/data/restaurants/v1/google/restaurant-searches:run",
            {
              method: "POST",
              headers: {
                "Content-Type": "application/json",
                "Authorization": "Bearer <token>"
              },
              body: JSON.stringify({}),
            });


            const data = await response.json();
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.post(
                "https://api.voyant.travel/data/restaurants/v1/google/restaurant-searches:run",
                headers={
                    "Authorization": "Bearer <token>"
                },
                json={}
            )

            data = response.json()
components:
  schemas:
    OpaqueRecord:
      type: object
      additionalProperties: true
      description: >-
        Provider passthrough record (camelCased on the wire). Kept open so
        provider-side field additions do not break clients.
    SingleResponse:
      type: object
      required:
        - data
      properties:
        data: {}
      description: Standard envelope for single-resource endpoints.
    Error:
      type: object
      required:
        - code
      properties:
        code:
          type: string
          enum:
            - NOT_FOUND
            - INVALID_REQUEST
            - INVALID_CURSOR
            - UPSTREAM_FAILED
            - INTERNAL_AUTH_REQUIRED
            - RATE_LIMITED
          description: Stable machine-readable error code.
        message:
          type: string
          description: Human-readable error detail.
  responses:
    BadRequest:
      description: Invalid request (code INVALID_REQUEST or INVALID_CURSOR).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: >-
        Missing or invalid bearer token / insufficient scope (code
        INTERNAL_AUTH_REQUIRED).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UpstreamFailed:
      description: Upstream provider request failed (code UPSTREAM_FAILED).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Voyant Data API token, scoped per sub-product (data:{product}:read).
        Sent as `Authorization: Bearer <token>`.

````