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

# Consume Search API

> Execute a search query using the SERP API, returning organic results, related searches, people also ask, top stories, and other search engine result page components.



## OpenAPI

````yaml post /go-serpapi-server/open/consume
openapi: 3.0.1
info:
  title: GoProxy API Documentation
  description: ''
  version: 1.0.0
servers: []
security: []
tags: []
paths:
  /go-serpapi-server/open/consume:
    post:
      tags: []
      summary: Consume Search API
      description: >-
        Execute a search query using the SERP API, returning organic results,
        related searches, people also ask, top stories, and other search engine
        result page components.
      parameters:
        - name: apiKey
          in: header
          description: API key used for authentication.
          required: true
          example: 2pp0z51id0xyveo127dm5atcop1f6d
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
                - gl
                - lang
                - domain
                - page
              properties:
                query:
                  type: string
                  description: Search keywords
                  example: Iphone
                gl:
                  type: string
                  description: Geographic location for search results
                  example: California,United States
                lang:
                  type: string
                  description: Search language code
                  example: en
                domain:
                  type: string
                  description: Search domain (e.g., com, co.uk)
                  example: com
                retry:
                  type: boolean
                  description: Whether to retry on failure
                  default: false
                  example: false
                hostLang:
                  type: string
                  description: Host language
                  example: en
                page:
                  type: integer
                  description: Page number, range 1-100
                  minimum: 1
                  maximum: 100
                  example: 1
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    description: Response status code
                    example: 200
                  msg:
                    type: string
                    description: Response message
                    example: success
                  data:
                    type: object
                    properties:
                      organic:
                        type: array
                        description: Organic search results
                        items:
                          type: object
                          properties:
                            pos:
                              type: integer
                              description: Position in organic results
                            pos_overall:
                              type: integer
                              description: Overall position on the page
                            title:
                              type: string
                              description: Result title
                            favicon_text:
                              type: string
                              description: Favicon or source text
                            url_shown:
                              type: string
                              description: Displayed URL
                            url:
                              type: string
                              description: Actual URL
                            desc:
                              type: string
                              description: Result description
                      images:
                        type: object
                        description: Image search results
                      related_searches:
                        type: object
                        properties:
                          related_searches:
                            type: array
                            description: Related search suggestions
                            items:
                              type: string
                          pos_over_all:
                            type: integer
                            description: Overall position
                      people_also_ask:
                        type: object
                        properties:
                          items:
                            type: array
                            description: People also ask questions
                            items:
                              type: string
                          pos_overall:
                            type: integer
                            description: Overall position
                      top_stories:
                        type: object
                        properties:
                          items:
                            type: array
                            description: Top stories items (JSON strings)
                            items:
                              type: string
                          pos_overall:
                            type: integer
                            description: Overall position
                      what_people_are_saying:
                        type: object
                        description: What people are saying section
                      total_results_count:
                        type: integer
                        description: Total number of results
                        nullable: true
                        example: null
      deprecated: false
      security: []

````