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

# Get Google search results



## OpenAPI

````yaml /openapi/serp.json post /serp/google
openapi: 3.0.0
info:
  title: Search Engine
  version: 1.0.0
  description: API reference for Search Engine on Ace Data Cloud.
servers:
  - url: https://api.acedata.cloud
    description: Ace Data Cloud API
security:
  - bearerAuth: []
paths:
  /serp/google:
    post:
      summary: Get Google search results
      parameters:
        - in: header
          name: accept
          schema:
            enum:
              - application/json
            type: string
          required: false
          description: Serp Google Param Accept
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                page:
                  type: number
                  description: Serp Google Page
                type:
                  enum:
                    - search
                    - images
                    - news
                    - maps
                    - places
                    - videos
                  type: string
                  default: search
                  description: Serp Google Type
                query:
                  type: string
                  example: apple inc
                  description: Serp Google Query
                range:
                  type: string
                  description: Serp Google Range
                number:
                  type: number
                  description: Serp Google Number
                country:
                  type: string
                  description: Serp Google Country
                language:
                  type: string
                  description: Serp Google Language
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                example:
                  images:
                    - link: https://en.wikipedia.org/wiki/Cat
                      title: upload.wikimedia.org/wikipedia/commons/0/0b/Cat_po...
                      image_url: >-
                        https://upload.wikimedia.org/wikipedia/commons/0/0b/Cat_poster_1.jpg
                    - link: >-
                        https://www.nationalgeographic.com/animals/mammals/facts/domestic-cat
                      title: Domestic cat
                      image_url: >-
                        https://i.natgeofe.com/n/548467d8-c5f1-4551-9f58-6817a8d2c45e/NationalGeographic_2572187_3x2.jpg
                    - link: >-
                        https://www.four-paws.org/our-stories/publications-guides/a-cats-personality
                      title: >-
                        A Cat's Personality - FOUR PAWS International - Animal
                        Welfare ...
                      image_url: >-
                        https://media.4-paws.org/d/2/5/f/d25ff020556e4b5eae747c55576f3b50886c0b90/cut%20cat%20serhio%2002-1813x1811-720x719.jpg
                    - link: https://en.wikipedia.org/wiki/Cat
                      title: Cat - Wikipedia
                      image_url: >-
                        https://upload.wikimedia.org/wikipedia/commons/1/15/Cat_August_2010-4.jpg
                  organic:
                    - link: https://en.wikipedia.org/wiki/Cat
                      title: Cat - Wikipedia
                      snippet: >-
                        The cat (Felis catus), commonly referred to as the
                        domestic cat or house cat, is a small domesticated
                        carnivorous mammal. It is the only domesticated ...
                      position: 1
                    - date: 3 days ago
                      link: https://www.britannica.com/animal/cat
                      title: >-
                        Cat | Breeds, Origins, History, Body Types, Senses ... -
                        Britannica
                      snippet: >-
                        Domestic cats are characterized by retractable claws,
                        powerful bodies, acute senses, long tails, and
                        specialized teeth adapted for hunting prey.
                      position: 2
                      sitelinks:
                        - link: https://www.britannica.com/animal/feral-cat
                          title: Feral cat
                        - link: >-
                            https://www.britannica.com/animal/Norwegian-forest-cat
                          title: Norwegian Forest Cat
                        - link: >-
                            https://www.britannica.com/animal/Siamese-breed-of-cat
                          title: Siamese
                        - link: >-
                            https://www.britannica.com/animal/cat/List-of-selected-shorthair-breeds
                          title: List of selected shorthair breeds
                    - link: >-
                        https://www.nationalgeographic.com/animals/mammals/facts/domestic-cat
                      title: Domestic cat - National Geographic
                      snippet: >-
                        As mostly nocturnal animals, cats have excellent vision
                        and hearing, with ears that can turn like satellite
                        dishes. Their reputation for having nine lives stems ...
                      position: 3
                    - date: May 17, 2022
                      link: >-
                        https://hakaimagazine.com/features/its-10-pm-do-you-know-where-your-cat-is/
                      title: >-
                        It's 10 PM. Do You Know Where Your Cat Is? - Hakai
                        Magazine
                      snippet: >-
                        This cat companionship is as old as the country itself.
                        The Norse who mastered sailing from northern Europe to
                        this middle-of-nowhere island ...
                      position: 4
                    - link: >-
                        https://www.avma.org/resources/pet-owners/petcare/selecting-pet-cat
                      title: >-
                        Selecting a pet cat | American Veterinary Medical
                        Association
                      snippet: >-
                        When choosing a cat, pick one that is active,
                        inquisitive, and seeks affection and attention from
                        people. Sometimes cats are uncomfortable in noisy or ...
                      position: 5
                    - link: >-
                        https://www.alleycat.org/resources/the-natural-history-of-the-cat/
                      title: The Natural History of Domestic Cats | Alley Cat Allies
                      snippet: >-
                        Cats began their unique relationship with humans 10,000
                        to 12,000 years ago in the Fertile Crescent, the
                        geographic region where some of the earliest ...
                      position: 6
                    - link: https://www.purina.com/cats/cat-breeds
                      title: All Cat Breed Information | Purina US
                      snippet: >-
                        Trying to decide what type of cat is right for you and
                        your family? Browse through our list of cat breeds, and
                        find the best cat for you.
                      position: 7
                      sitelinks:
                        - link: https://www.purina.com/cats/cat-breeds/birman-cat
                          title: Birman Cat Breed
                        - link: >-
                            https://www.purina.com/cats/cat-breeds/abyssinian-cat
                          title: Abyssinian Cat Breed
                        - link: >-
                            https://www.purina.com/cats/cat-breeds/american-shorthair
                          title: American Shorthair Cat
                        - link: https://www.purina.com/cats/cat-breeds/chartreux
                          title: Chartreux
                    - date: Apr 4, 2024
                      link: https://www.youtube.com/watch?v=Lsc-DRpEauY
                      title: A DAY IN THE LIFE OF A CAT OWNER - YouTube
                      snippet: >-
                        The struggle is real... Experience a day in the life of
                        Simon, all cat owners will relate! Check out ...
                      position: 8
                      image_url: >-
                        https://i.ytimg.com/vi/Lsc-DRpEauY/default.jpg?sqp=-oaymwEECHgQQw&rs=AMzJL3kwgvYkTQDoFf__9Ht7cBZ81s_sOA
                      attributes:
                        Posted: Apr 4, 2024
                        Duration: '12:24'
                    - link: https://www.aspca.org/pet-care/cat-care/general-cat-care
                      title: General Cat Care | ASPCA
                      snippet: >-
                        Get a host of handy information about your feline
                        companion in our general cat care guide. It also comes
                        in an easy-to-print PDF for tacking on your fridge ...
                      position: 9
                      sitelinks:
                        - link: >-
                            https://www.aspca.org/pet-care/cat-care/general-cat-care#:~:text=General%20Cat%20Care,-Have%20you%20recently%20added%20a
                          title: General Cat Care
                        - link: >-
                            https://www.aspca.org/pet-care/cat-care/general-cat-care#:~:text=Litter%20Box,-All%20indoor%20cats%20need%20a
                          title: Litter Box
                        - link: >-
                            https://www.aspca.org/pet-care/cat-care/general-cat-care#:~:text=Cat%20Supply%20Checklist
                          title: Cat Supply Checklist
                    - link: >-
                        https://www.freshpet.com/blog/10-reasons-why-cats-make-great-pets
                      title: 10 Reasons Why Cats Make Great Pets - Freshpet
                      snippet: >-
                        1. Cats are quiet. If noise levels are a concern in your
                        living situation, cats are a great choice of pet. · 2.
                        Cats are low maintenance. Compared to dogs, cats ...
                      position: 10
                  knowledge_graph:
                    type: Animal
                    title: Cat
                    image_url: >-
                      https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRJn19n5xv68EdzI0Vfp-GbACvr6Oh5_FHaqKDI55c&s=0
                    attributes:
                      Class: Mammalia
                      Domain: Eukaryota
                      Family: Felidae
                      Lifespan: "12 – 18\_years (Domesticated)"
                      Scientific name: Felis catus
                      Gestation period: "65\_days"
                    description: Serp Google Response 200 Example Knowledge Graph
                    description_link: https://en.wikipedia.org/wiki/Cat
                    description_source: Wikipedia
                  people_also_ask:
                    - link: https://en.wikipedia.org/wiki/Cat
                      title: Cat - Wikipedia
                      snippet: >-
                        Valued by humans for companionship and its ability to
                        kill vermin, the cat's retractable claws are adapted to
                        killing small prey like mice and rats. It has a strong,
                        flexible body, quick reflexes, and sharp teeth, and its
                        night vision and sense of smell are well developed.
                      question: What is a cat known for?
                    - link: https://en.wikipedia.org/wiki/Felidae
                      title: Felidae - Wikipedia
                      snippet: >-
                        Proailurus is the oldest known cat that occurred after
                        the Eocene–Oligocene extinction event about 33.9 million
                        years ago; fossil remains were excavated in France and
                        Mongolia's Hsanda Gol Formation. Fossil occurrences
                        indicate that the Felidae arrived in North America
                        around 18.5 million years ago.
                      question: What was the first cat on Earth?
                    - link: >-
                        https://mmilani.com/writing/articles/cats/what-makes-a-cat/
                      title: >-
                        Brief Overview of Cat Behavior: What Makes a Cat a Cat?
                        - MMilani.com
                      snippet: >-
                        To summarize then, five behaviors make cats cats:
                        They're nocturnal, territorial, solitary, predatory, and
                        maternal-sexual. And because cats are so newly
                        domesticated, we can be sure these same behaviors may
                        influence our pets every bit as much as they did their
                        ancient ancestors.
                      question: What makes a cat a cat?
                    - link: >-
                        https://cvillecatcare.com/veterinary-topics/101-amazing-cat-facts-fun-trivia-about-your-feline-friend/
                      title: >-
                        101 Amazing Cat Facts: Fun Trivia About Your Feline
                        Friend
                      snippet: >-
                        Cats are crepuscular, which means that they're most
                        active at dawn and dusk. Cats are fastidious creatures
                        about their “bathroom.” If you have more than one cat,
                        you should have one litter box for each. Cats can spend
                        up to a third of their waking hours grooming. Cats live
                        longer when they stay indoors.
                      question: What are some facts about cats behavior?
                  related_searches:
                    - query: Birds
                    - query: A cat meaning
                    - query: A cat movie
                    - query: Cat lifespan
                    - query: How to get a cat
                    - query: Black Cat
                    - query: Cat videos
                    - query: Cute cat
                    - query: History of cats timeline
                properties:
                  data:
                    type: object
                    description: Serp Google Response 200 Data
                  success:
                    type: boolean
                    description: Serp Google Response 200 Success
          description: Serp Google Response 200
        '400':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: token_mismatched
                        message: The specified token is not matched with API.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: token_mismatched
                            description: Serp Google Response 400 Error Code
                          message:
                            type: string
                            example: The specified token is not matched with API.
                            description: Serp Google Response 400 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 400 Trace Id
                  - type: object
                    example:
                      error:
                        code: api_not_implemented
                        message: The API is not implemented.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: api_not_implemented
                            description: Serp Google Response 400 Error Code 2
                          message:
                            type: string
                            example: The API is not implemented.
                            description: Serp Google Response 400 Error Message 2
                      trace_id:
                        type: string
                        description: Serp Google Response 400 Trace Id 2
                  - type: object
                    example:
                      error:
                        code: disabled
                        message: >-
                          Your application has been disabled by Ace Data Cloud
                          due to abnormal usage behavior, please contact our
                          support to get more information.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: disabled
                            description: Serp Google Response 400 Error Code 3
                          message:
                            type: string
                            example: >-
                              Your application has been disabled by Ace Data
                              Cloud due to abnormal usage behavior, please
                              contact our support to get more information.
                            description: Serp Google Response 400 Error Message 3
                      trace_id:
                        type: string
                        description: Serp Google Response 400 Trace Id 3
                  - type: object
                    example:
                      error:
                        code: bad_request
                        message: model is invalid.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: bad_request
                            description: Serp Google Response 400 Error Code 4
                          message:
                            type: string
                            example: model is invalid.
                            description: Serp Google Response 400 Error Message 4
                      trace_id:
                        type: string
                        description: Serp Google Response 400 Trace Id 4
                  - type: object
                    example:
                      error:
                        code: no_token
                        message: No token specified for the request.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: no_token
                            description: Serp Google Response 400 Error Code 5
                          message:
                            type: string
                            example: No token specified for the request.
                            description: Serp Google Response 400 Error Message 5
                      trace_id:
                        type: string
                        description: Serp Google Response 400 Trace Id 5
          description: Serp Google Response 400
        '401':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: invalid_token
                        message: The specified token is invalid or wrong.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: invalid_token
                            description: Serp Google Response 401 Error Code
                          message:
                            type: string
                            example: The specified token is invalid or wrong.
                            description: Serp Google Response 401 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 401 Trace Id
                  - type: object
                    example:
                      error:
                        code: token_expired
                        message: token expired.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: token_expired
                            description: Serp Google Response 401 Error Code 2
                          message:
                            type: string
                            example: token expired.
                            description: Serp Google Response 401 Error Message 2
                      trace_id:
                        type: string
                        description: Serp Google Response 401 Trace Id 2
                  - type: object
                    example:
                      error:
                        code: token_mismatched
                        message: token and api does not match.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: token_mismatched
                            description: Serp Google Response 401 Error Code 3
                          message:
                            type: string
                            example: token and api does not match.
                            description: Serp Google Response 401 Error Message 3
                      trace_id:
                        type: string
                        description: Serp Google Response 401 Trace Id 3
          description: Serp Google Response 401
        '403':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: used_up
                        message: >-
                          Your balance is not sufficient for current request,
                          please buy more in Ace Data Cloud.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: used_up
                            description: Serp Google Response 403 Error Code
                          message:
                            type: string
                            example: >-
                              Your balance is not sufficient for current
                              request, please buy more in Ace Data Cloud.
                            description: Serp Google Response 403 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 403 Trace Id
          description: Serp Google Response 403
        '404':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: no_api
                        message: API does not exist, please make sure url is correct.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: no_api
                            description: Serp Google Response 404 Error Code
                          message:
                            type: string
                            example: >-
                              API does not exist, please make sure url is
                              correct.
                            description: Serp Google Response 404 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 404 Trace Id
          description: Serp Google Response 404
        '429':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: too_many_requests
                        message: You have exceeded the rate limit.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: too_many_requests
                            description: Serp Google Response 429 Error Code
                          message:
                            type: string
                            example: You have exceeded the rate limit.
                            description: Serp Google Response 429 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 429 Trace Id
          description: Serp Google Response 429
        '500':
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    example:
                      error:
                        code: api_error
                        message: Internal server error.
                      trace_id: 2efa9340-b21b-4e26-9e14-4aac95f343ab
                    properties:
                      error:
                        type: object
                        properties:
                          code:
                            type: string
                            example: api_error
                            description: Serp Google Response 500 Error Code
                          message:
                            type: string
                            example: Internal server error.
                            description: Serp Google Response 500 Error Message
                      trace_id:
                        type: string
                        description: Serp Google Response 500 Trace Id
          description: Serp Google Response 500
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API token from https://platform.acedata.cloud

````