search-operations

Enhance Your Applications with Real-Time Google Search Actions

16 Jun 2025
Enhance Your Applications with Real-Time Google Search Actions

The Real Time Google Search API provides developers with powerful tools for integrating live search capabilities into their applications. With its Cognitive Actions, you can effortlessly perform web and image searches that yield immediate and relevant results. This API not only simplifies the process of retrieving data but also enhances user experience by delivering quick and accurate search outcomes. Imagine building applications that can respond to user inquiries in real time, providing them with the most up-to-date information from the web.

Common use cases for the Real Time Google Search API include content discovery, market research, competitive analysis, and media management. Whether you’re developing a news aggregator, an e-commerce platform, or a content management system, these search functionalities can significantly enrich your applications.

Prerequisites

To get started, you will need a valid Cognitive Actions API key and a basic understanding of making API calls.

The Perform Image Search action allows you to execute real-time image searches using the Google Search API. This action retrieves relevant image results based on customizable parameters such as search query, sorting order, pagination, geolocation, language region, and the number of results.

Input Requirements

  • query (string): The search term for the image results (e.g., "rapidapi").
  • sort (string): Defines the sorting order of results, either by "relevance" or "date".
  • startIndex (number): The index of the first result for pagination.
  • geolocation (string): The geographic location for localized results, defaulting to "us".
  • languageRegion (string): The language and region setting for the results, defaulting to "en".
  • numberOfResults (number): The maximum number of results to return, defaulting to 10.

Expected Output

The response includes an array of image objects, each containing properties such as:

  • url: The direct link to the image.
  • origin: Information about where the image was sourced from, including the title and website.
  • preview: A smaller version of the image for quick viewing.

Use Cases

Utilize this action when you need to integrate visual content into your applications. For instance, if you're creating a blog that showcases relevant images based on specific topics, the Perform Image Search action can help you fetch and display images that enhance your articles.


```python
import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "14a8e49f-7720-4a1f-b9aa-bb4bddc0f4b7" # Action ID for: Perform Image Search

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "sort": "relevance",
  "query": "rapidapi",
  "geolocation": "us",
  "languageRegion": "en",
  "numberOfResults": 10
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Perform Web and Image Search
The **Perform Web and Image Search** action allows you to conduct comprehensive searches across both web pages and images. This action enables developers to leverage customizable search parameters such as page number, sorting criteria, query terms, language preference, result count, and geographic location, providing versatile and efficient data retrieval.

### Input Requirements
- **query** (string): The search string used to query the database (e.g., "\"59898297150\" OR \"+59898297150\"").
- **page** (number): The page number of the search results, defaulting to 1.
- **sort** (string): Criteria for sorting results, either by "relevance" or "date".
- **language** (string): The preferred language for the results, defaulting to "en".
- **numberOfResults** (number): The number of results to return per page, defaulting to 10.
- **geographicLocation** (string): The geographic location code to filter results, defaulting to "us".

### Expected Output
The output contains structured data including:
- **total**: Total number of results found.
- **results**: An array of search results, each with properties such as title, URL, position, and description.

### Use Cases
This action is particularly useful for applications that require extensive information retrieval. For example, if you're developing a customer service tool that needs to pull relevant data based on user queries, the Perform Web and Image Search action can deliver the necessary information quickly, improving response times and user satisfaction.


import requests
import json

# Replace with your actual Cognitive Actions API key and endpoint
# Ensure your environment securely handles the API key
COGNITIVE_ACTIONS_API_KEY = "YOUR_COGNITIVE_ACTIONS_API_KEY"
# This endpoint URL is hypothetical and should be documented for users
COGNITIVE_ACTIONS_EXECUTE_URL = "https://api.cognitiveactions.com/actions/execute"

action_id = "8373b8ca-5f6d-4a33-9235-48ca95445135" # Action ID for: Perform Web and Image Search

# Construct the exact input payload based on the action's requirements
# This example uses the predefined example_input for this action:
payload = {
  "page": 1,
  "sort": "relevance",
  "query": "\"59898297150\" OR \"+59898297150\"",
  "language": "en",
  "numberOfResults": 10,
  "geographicLocation": "us"
}

headers = {
    "Authorization": f"Bearer {COGNITIVE_ACTIONS_API_KEY}",
    "Content-Type": "application/json",
    # Add any other required headers for the Cognitive Actions API
}

# Prepare the request body for the hypothetical execution endpoint
request_body = {
    "action_id": action_id,
    "inputs": payload
}

print(f"--- Calling Cognitive Action: {action.name or action_id} ---")
print(f"Endpoint: {COGNITIVE_ACTIONS_EXECUTE_URL}")
print(f"Action ID: {action_id}")
print("Payload being sent:")
print(json.dumps(request_body, indent=2))
print("------------------------------------------------")

try:
    response = requests.post(
        COGNITIVE_ACTIONS_EXECUTE_URL,
        headers=headers,
        json=request_body
    )
    response.raise_for_status() # Raise an exception for bad status codes (4xx or 5xx)

    result = response.json()
    print("Action executed successfully. Result:")
    print(json.dumps(result, indent=2))

except requests.exceptions.RequestException as e:
    print(f"Error executing action {action_id}: {e}")
    if e.response is not None:
        print(f"Response status: {e.response.status_code}")
        try:
            print(f"Response body: {e.response.json()}")
        except json.JSONDecodeError:
            print(f"Response body (non-JSON): {e.response.text}")
    print("------------------------------------------------")



## Conclusion
Integrating the Real Time Google Search API into your applications can significantly enhance their functionality and user experience. By leveraging the capabilities of both the Perform Image Search and Perform Web and Image Search actions, developers can provide real-time data retrieval that is both efficient and relevant. 

As the next step, consider exploring how these actions can be combined with other services or used in different contexts to create innovative solutions that meet your users' needs. Start building smarter applications today!
← Back to All Articles