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

# Google Search

> API endpoint allows you to scrape the results from Google search engine

<ResponseExample>
  ```json 200 theme={null}
  {
    "searchParameters": {
      "q": "car",
      "hl": "en",
      "type": "search",
      "tbs": "",
      "location": "",
      "engine": "google",
      "gl": "us"
    },
    "organic": [
      {
        "title": "New Cars, Used Cars, Car Dealers, Prices & Reviews | Cars.com",
        "link": "https://www.cars.com/",
        "snippet": "Find the perfect car for your needs at Cars.com. Shop new and used cars, sell your car, compare prices, and explore financing options to find your dream car ..." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Cars for Sale",
            "link": "https://www.cars.com/shopping/"
          },{
            "title": "Car Shipping",
            "link": "https://www.cars.com/car-shipping/"
          },{
            "title": "Car Warranty",
            "link": "https://www.cars.com/car-warranty/"
          },{
            "title": "Advanced Search",
            "link": "https://www.cars.com/shopping/advanced-search/"
          }
        ],
        "position": 1
      },{
        "title": "Car - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/Car",
        "snippet": "A car, or an automobile, is a motor vehicle with wheels. Most definitions of cars state that they run primarily on roads, seat 1-8 people, have four wheels, and ..." ,
        "date": "",
        "sitelinks": [
          
        ],
        "position": 2
      },{
        "title": "CARFAX - Shop, Buy, Own, & Sell Cars with Confidence",
        "link": "https://www.carfax.com/",
        "snippet": "Don't run the risk of buying a used car with costly hidden problems. Shop with confidence for a car with the CARFAX vehicle history that's right for you." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Used Cars for Sale",
            "link": "https://www.carfax.com/cars-for-sale"
          },{
            "title": "Get a CARFAX Report",
            "link": "https://www.carfax.com/vehicle-history-reports/"
          },{
            "title": "Car Research",
            "link": "https://www.carfax.com/car-research"
          },{
            "title": "Sell My Car",
            "link": "https://www.carfax.com/sell-my-car/"
          }
        ],
        "position": 3
      },{
        "title": "Car and Driver: New Car Reviews, Buying Advice and News",
        "link": "https://www.caranddriver.com/",
        "snippet": "Covering the automotive industry since 1955 with in-depth reviews and analysis, features, auto show reporting, and advice for car owners and buyers." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Reviews",
            "link": "https://www.caranddriver.com/reviews/"
          },{
            "title": "Used Cars for Sale Near You",
            "link": "https://www.caranddriver.com/cars-for-sale/used"
          },{
            "title": "News",
            "link": "https://www.caranddriver.com/news/"
          },{
            "title": "Contact Us",
            "link": "https://www.caranddriver.com/about/a15064611/contact-us/"
          }
        ],
        "position": 4
      },{
        "title": "Tesla: Electric Cars, Solar & Clean Energy",
        "link": "https://www.tesla.com/",
        "snippet": "Tesla is accelerating the world's transition to sustainable energy with electric cars, solar and integrated renewable energy solutions for homes and ..." ,
        "date": "",
        "sitelinks": [
          
        ],
        "position": 5
      },{
        "title": "CALIFORNIA ASSOCIATION OF REALTORS® - www.car.org",
        "link": "https://www.car.org/",
        "snippet": "A real estate trade association to develop and promote programs/services that enhance a member's ability to conduct business with integrity and competency." ,
        "date": "",
        "sitelinks": [
          
        ],
        "position": 6
      },{
        "title": "New Cars, Trucks, SUVs & Hybrids | Toyota Official Site",
        "link": "https://www.toyota.com/",
        "snippet": "Explore all vehicles, cars & minivan, trucks, crossovers & SUVs, electrified, upcoming vehicles, crossovers & SUVs." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Toyota Vehicles",
            "link": "https://www.toyota.com/all-vehicles/"
          },{
            "title": "Build Your Toyota",
            "link": "https://www.toyota.com/configurator/"
          },{
            "title": "Toyota Cars",
            "link": "https://www.toyota.com/cars/"
          },{
            "title": "Toyota Motor Sales",
            "link": "https://www.toyota.com/usa"
          }
        ],
        "position": 7
      },{
        "title": "Edmunds: New Cars, Used Cars, Car Reviews and Pricing",
        "link": "https://www.edmunds.com/",
        "snippet": "Research new and used cars including car prices, view incentives and dealer inventory listings, compare vehicles, get car buying advice and reviews at ..." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Instant used car value",
            "link": "https://www.edmunds.com/appraisal/"
          },{
            "title": "Car Reviews",
            "link": "https://www.edmunds.com/car-reviews/"
          },{
            "title": "Used Cars For Sale Near Me",
            "link": "https://www.edmunds.com/used-cars-for-sale/"
          },{
            "title": "Car Research",
            "link": "https://www.edmunds.com/research/"
          }
        ],
        "position": 8
      },{
        "title": "CarMax - Shop for used cars, then buy online or at a store",
        "link": "https://www.carmax.com/",
        "snippet": "Upfront prices, CarMax Certified quality, and detailed history reports on every car. Shop online, in-store, or both. We provide no-pressure help along the way." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Used cars for sale",
            "link": "https://www.carmax.com/cars"
          },{
            "title": "Sell My Car",
            "link": "https://www.carmax.com/sell-my-car"
          },{
            "title": "Find a store near you",
            "link": "https://www.carmax.com/stores"
          },{
            "title": "Cars under $10000",
            "link": "https://www.carmax.com/cars?price=10000"
          }
        ],
        "position": 9
      },{
        "title": "Ford® - New Hybrid & Electric Vehicles, SUVs, Crossovers, Trucks ...",
        "link": "https://www.ford.com/",
        "snippet": "Ford® is Built for America. Discover the latest lineup in new Ford vehicles! Explore hybrid & electric vehicle options, see photos, build & price, ..." ,
        "date": "",
        "sitelinks": [
          {
            "title": "Locate a Ford Dealer Near You",
            "link": "https://www.ford.com/dealerships/"
          },{
            "title": "Ford Trucks and Vans",
            "link": "https://www.ford.com/new-trucks/"
          },{
            "title": "Cars",
            "link": "https://www.ford.com/new-cars/"
          },{
            "title": "Ford Credit",
            "link": "https://www.ford.com/finance/"
          }
        ],
        "position": 10
      }
    ],
    "relatedSearches": [
       {
        "query": "Car game"
      },  {
        "query": "Car photo"
      },  {
        "query": "Cars for sale"
      },  {
        "query": "Car fax"
      },  {
        "query": "Car drawing"
      },  {
        "query": "Car price"
      },  {
        "query": "Cars movie"
      },  {
        "query": "Car brands"
      }
    ],
    "credits": 1
  }
  ```
</ResponseExample>


## OpenAPI

````yaml api-reference/openapi-3.0.json get /wf/google-search
openapi: 3.0.3
info:
  title: Riona API Docs
  version: 1.0.0
  contact:
    email: info@riona.ai
    url: https://riona.ai
servers:
  - url: https://riona.ai/api/1.1
security:
  - bearerAuth: []
tags:
  - name: Workflow
    description: Use this to trigger a workflow
  - name: Data
    description: Use this to fetch, modify and delete data
paths:
  /wf/google-search:
    get:
      tags:
        - Workflow
      description: Triggers the workflow google-search
      operationId: get_wf_google-search
      parameters:
        - name: q
          in: query
          required: true
          description: >-
            Parameter defines the query you want to search. You can use anything
            that you would use in a regular Google search.
          schema:
            type: string
        - name: gl
          in: query
          required: true
          description: >-
            Parameter defines the country to use for the Google search. It's a
            two-letter country code. (e.g., `us` for the United States, `uk` for
            United Kingdom, or `fr` for France) [Country
            List](/api-reference/other/countries)
          schema:
            type: string
            default: us
        - name: hl
          in: query
          required: true
          description: >-
            Parameter defines the language to use for the Google search. It's a
            two-letter language code. (e.g., `en` for English, `es` for Spanish,
            or `fr` for French). [Languages
            List](/api-reference/other/languages)
          schema:
            type: string
            default: en
        - name: location
          in: query
          required: false
          description: >-
            This optional parameter determines where your Google search
            originates, allowing for more specific locations such as cities and
            neighborhoods.

             Examples: 
            - Country: `United States` 

            - State: `California, United States` 

            - Region: `San Fransisco Bay Area, United States` 

            - City: `London, England, United Kingdom` 

            - Neighborhood: `SoHo, Ney York, United States` 

            - Airport: `Dubai International Airport, Dubai, United Arab
            Emirates`
          schema:
            type: string
        - name: tbs
          in: query
          required: false
          description: |-
            Date range
            - Anytime leave empty
            - Past hour = `qdr:h`
            - Past 24 hours = `qdr:d`
            - Past week = `qdr:w`
            - Past month = `qdr:m`
            - Past year = `qdr:y`
          schema:
            type: string
        - name: autocorrect
          in: query
          required: false
          description: '`true` , `false`'
          schema:
            type: boolean
            default: 'true'
        - name: num
          in: query
          required: true
          description: >-
            This sets the maximum number of results per page. Possible option:
            `10`
          schema:
            type: number
            default: 10
        - name: page
          in: query
          required: true
          description: Requested page
          schema:
            type: number
            default: 1
        - name: api_key
          in: query
          required: true
          description: >-
            This is your account API Key. You can easily locate it in your
            account dashboard.
          schema:
            type: string
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````