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

# maps

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">3 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">per request</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`I want to make an API call to https://api.keyapi.ai/v1/google/maps.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/google/maps

Description: Google maps search

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- q (Required): Queryq Example: apple inc
- ll (Required): GPS position & zoom level  This parameter allows you to adjust the focus of your search area by specifying GPS coordinates in this format: @latitude,longitude,zoom.  For example:@40.6973709,-74.1444871,11z.  You can find a search area by going to Google Maps, dragging around the map to your desired location, and then looking at the URL to get the coordinates.  The zoom level, while optional, is recommended for higher precision. It ranges from 3z (completely zoomed out) to 21z (completely zoomed in).  Setting the search area with this parameter only applies to search queries with q, not when you look up by placeId or cid.  This parameter is optional by default but required for paginated searches (page > 1). Example: @40.6973709,-74.1444871,11z
- placeId (Optional): Place ID This parameter allows you to search by Place ID. A Google Place ID uniquely identifies a location on Google Maps. Place IDs are available for most places, including businesses, landmarks, parks, and intersections. It's possible for the same place to have multiple different place IDs, and these IDs may change over time.
- cid (Optional): This parameter allows you to search by CID. A Google CID (Customer Identification) number is a unique identification number for a specific business listing on Google Maps.
- hl (Optional): Language Example: en
- page (Optional): page Example: 1

Example Response:
{
"code": 0,
"message": "success",
"data": {
"organic": [
  {
    "title": "Apple",
    "link": "https://www.apple.com/",
    "snippet": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, ...",
    "sitelinks": [
      {
        "title": "Careers at Apple",
        "link": "https://www.apple.com/careers/us/"
      },
      {
        "title": "Store",
        "link": "https://www.apple.com/store"
      },
      {
        "title": "Support",
        "link": "https://support.apple.com/"
      },
      {
        "title": "iPhone",
        "link": "https://www.apple.com/iphone/"
      },
      {
        "title": "Apple Leadership",
        "link": "https://www.apple.com/leadership/"
      }
    ],
    "position": 1
  },
  {
    "title": "Apple Inc. - Wikipedia",
    "link": "https://en.wikipedia.org/wiki/Apple_Inc.",
    "snippet": "Apple Inc. is an American multinational technology company headquartered in Cupertino, California, in Silicon Valley, and known for consumer electronics, ...",
    "position": 2
  },
  {
    "title": "Apple Inc. (AAPL) Stock Price, News, Quote & History - Yahoo Finance",
    "link": "https://finance.yahoo.com/quote/AAPL/",
    "snippet": "Find the latest Apple Inc. (AAPL) stock quote, history, news and other vital information to help you with your stock trading and investing.",
    "position": 3
  },
  {
    "title": "Apple Inc. | History, Products, Headquarters, & Facts - Britannica",
    "link": "https://www.britannica.com/money/Apple-Inc",
    "snippet": "Apple Inc. is an American multinational technology company that revolutionized the technology sector through its innovation of computer software, personal ...",
    "position": 4
  },
  {
    "title": "Apple - LinkedIn",
    "link": "https://www.linkedin.com/company/apple",
    "snippet": "Company size: 10,001+ employees. Headquarters: Cupertino, California. Type: Public Company. Founded: 1976. Specialties: Innovative Product ...",
    "date": "Jun 5, 2025",
    "position": 5
  },
  {
    "title": "Apple Inc - Company Profile and News - Bloomberg Markets",
    "link": "https://www.bloomberg.com/profile/company/AAPL:US",
    "snippet": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables and accessories, and sells a variety of related accessories.",
    "position": 6
  },
  {
    "title": "Apple Inc | Computer Science | Research Starters - EBSCO",
    "link": "https://www.ebsco.com/research-starters/computer-science/apple-inc",
    "snippet": "Apple Inc. is a leading American technology company known for its innovative consumer electronics, software, and online services.",
    "position": 7
  }
]
}
}
... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/Google.openapi.json GET /v1/google/maps
openapi: 3.0.1
info:
  title: Google API english documentation
  description: >-
    The english reference documentation of the Google API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security:
  - JWT Bearer: []
tags: []
paths:
  /v1/google/maps:
    get:
      tags: []
      summary: maps
      parameters:
        - name: q
          in: query
          description: Queryq
          required: true
          example: apple inc
          schema:
            type: string
            example: apple inc
        - name: ll
          in: query
          description: >-
            GPS position & zoom level


            This parameter allows you to adjust the focus of your search area by
            specifying GPS coordinates in this format: @latitude,longitude,zoom.


            For example:@40.6973709,-74.1444871,11z.


            You can find a search area by going to Google Maps, dragging around
            the map to your desired location, and then looking at the URL to get
            the coordinates.


            The zoom level, while optional, is recommended for higher precision.
            It ranges from 3z (completely zoomed out) to 21z (completely zoomed
            in).


            Setting the search area with this parameter only applies to search
            queries with q, not when you look up by placeId or cid.


            This parameter is optional by default but required for paginated
            searches (page > 1).
          required: true
          example: '@40.6973709,-74.1444871,11z'
          schema:
            type: string
            example: '@40.6973709,-74.1444871,11z'
        - name: placeId
          in: query
          description: >-
            Place ID

            This parameter allows you to search by Place ID. A Google Place ID
            uniquely identifies a location on Google Maps. Place IDs are
            available for most places, including businesses, landmarks, parks,
            and intersections. It's possible for the same place to have multiple
            different place IDs, and these IDs may change over time.
          required: false
          schema:
            type: string
        - name: cid
          in: query
          description: >-
            This parameter allows you to search by CID. A Google CID (Customer
            Identification) number is a unique identification number for a
            specific business listing on Google Maps.
          required: false
          schema:
            type: string
        - name: hl
          in: query
          description: Language
          required: false
          example: en
          schema:
            type: string
            default: en
            example: zh-cn
        - name: page
          in: query
          description: page
          required: false
          example: 1
          schema:
            type: integer
            default: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  organic:
                    - title: Apple
                      link: https://www.apple.com/
                      snippet: >-
                        Discover the innovative world of Apple and shop
                        everything iPhone, iPad, Apple Watch, Mac, and Apple TV,
                        plus explore accessories, entertainment, ...
                      sitelinks:
                        - title: Careers at Apple
                          link: https://www.apple.com/careers/us/
                        - title: Store
                          link: https://www.apple.com/store
                        - title: Support
                          link: https://support.apple.com/
                        - title: iPhone
                          link: https://www.apple.com/iphone/
                        - title: Apple Leadership
                          link: https://www.apple.com/leadership/
                      position: 1
                    - title: Apple Inc. - Wikipedia
                      link: https://en.wikipedia.org/wiki/Apple_Inc.
                      snippet: >-
                        Apple Inc. is an American multinational technology
                        company headquartered in Cupertino, California, in
                        Silicon Valley, and known for consumer electronics, ...
                      position: 2
                    - title: >-
                        Apple Inc. (AAPL) Stock Price, News, Quote & History -
                        Yahoo Finance
                      link: https://finance.yahoo.com/quote/AAPL/
                      snippet: >-
                        Find the latest Apple Inc. (AAPL) stock quote, history,
                        news and other vital information to help you with your
                        stock trading and investing.
                      position: 3
                    - title: >-
                        Apple Inc. | History, Products, Headquarters, & Facts -
                        Britannica
                      link: https://www.britannica.com/money/Apple-Inc
                      snippet: >-
                        Apple Inc. is an American multinational technology
                        company that revolutionized the technology sector
                        through its innovation of computer software, personal
                        ...
                      position: 4
                    - title: Apple - LinkedIn
                      link: https://www.linkedin.com/company/apple
                      snippet: >-
                        Company size: 10,001+ employees. Headquarters:
                        Cupertino, California. Type: Public Company. Founded:
                        1976. Specialties: Innovative Product ...
                      date: Jun 5, 2025
                      position: 5
                    - title: Apple Inc - Company Profile and News - Bloomberg Markets
                      link: https://www.bloomberg.com/profile/company/AAPL:US
                      snippet: >-
                        Apple Inc. designs, manufactures, and markets
                        smartphones, personal computers, tablets, wearables and
                        accessories, and sells a variety of related accessories.
                      position: 6
                    - title: Apple Inc | Computer Science | Research Starters - EBSCO
                      link: >-
                        https://www.ebsco.com/research-starters/computer-science/apple-inc
                      snippet: >-
                        Apple Inc. is a leading American technology company
                        known for its innovative consumer electronics, software,
                        and online services.
                      position: 7
                requestId: e8h489c2-ee3g-499f-d8hc-h7i569791878
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: q'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/google/maps?q=apple+inc&ll=@40.6973709,-74.1444871,11z&hl=en&page=1' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/google/maps',
                params={'q': 'apple inc', 'll': '@40.6973709,-74.1444871,11z', 'hl': 'en', 'page': 1},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"q": "apple inc", "ll":
            "@40.6973709,-74.1444871,11z", "hl": "en", "page": 1});


            const response = await
            fetch(`https://api.keyapi.ai/v1/google/maps?${params}`, {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````