> ## 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.

# places

<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/places.

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/places

Description: Google places search

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

Parameters:
- q (Required): Queryq Example: apple inc
- gl (Optional): Country Example: us
- location (Optional): This optional parameter determines where your Google search originates, allowing for more specific locations such as cities and neighborhoods. You can find a list of supported locations here. Options: United States, United Kingdom, Mexico, Japan, California, United States, San Francisco Bay Area, United States, New York, New York, United States, Mumbai, Maharashtra, India, London, England, United Kingdom, Mexico City, Mexico City, Mexico, Bangkok, Bangkok, Thailand, Paris, Paris, Ile-de-France, France, SoHo, New York, United States, Dubai International Airport, Dubai, United Arab Emirates.
- 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/places
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/places:
    get:
      tags: []
      summary: places
      parameters:
        - name: q
          in: query
          description: Queryq
          required: true
          example: apple inc
          schema:
            type: string
            example: apple inc
        - name: gl
          in: query
          description: Country
          required: false
          example: us
          schema:
            type: string
            default: us
            example: us
        - name: location
          in: query
          description: >-
            This optional parameter determines where your Google search
            originates, allowing for more specific locations such as cities and
            neighborhoods. You can find a list of supported locations here.
          required: false
          schema:
            type: string
            enum:
              - United States
              - United Kingdom
              - Mexico
              - Japan
              - California, United States
              - San Francisco Bay Area, United States
              - New York, New York, United States
              - Mumbai, Maharashtra, India
              - London, England, United Kingdom
              - Mexico City, Mexico City, Mexico
              - Bangkok, Bangkok, Thailand
              - Paris, Paris, Ile-de-France, France
              - SoHo, New York, United States
              - Dubai International Airport, Dubai, United Arab Emirates
            x-apifox-enum:
              - value: United States
                name: ''
                description: ''
              - value: United Kingdom
                name: ''
                description: ''
              - value: Mexico
                name: ''
                description: ''
              - value: Japan
                name: ''
                description: ''
              - value: California, United States
                name: ''
                description: ''
              - value: San Francisco Bay Area, United States
                name: ''
                description: ''
              - value: New York, New York, United States
                name: ''
                description: ''
              - value: Mumbai, Maharashtra, India
                name: ''
                description: ''
              - value: London, England, United Kingdom
                name: ''
                description: ''
              - value: Mexico City, Mexico City, Mexico
                name: ''
                description: ''
              - value: Bangkok, Bangkok, Thailand
                name: ''
                description: ''
              - value: Paris, Paris, Ile-de-France, France
                name: ''
                description: ''
              - value: SoHo, New York, United States
                name: ''
                description: ''
              - value: Dubai International Airport, Dubai, United Arab Emirates
                name: ''
                description: ''
        - 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: d7g378b1-dd2f-488e-c7gb-g6h458680767
          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/places?q=apple+inc&gl=us&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/places',
                params={'q': 'apple inc', 'gl': 'us', '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", "gl": "us",
            "hl": "en", "page": 1});


            const response = await
            fetch(`https://api.keyapi.ai/v1/google/places?${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).

````