​
Overview

​
Purpose

This guide walks you through obtaining a Google Serper Search API key and setting it up in the WebAccess configuration interface. By following these steps, your bots or workflows can programmatically perform Google searches via Serper’s API, enhancing data retrieval and automation potential.

​
Steps

1

Base URL Verification

Acquire and securely store an API key from the Serper service for Google Search queries.

2

Secure WebAccess Configuration

Input the key into the WebAccess interface, ensuring only authorized processes can invoke searches.

3

Testing & Troubleshooting

Validate the integration by performing test queries and monitoring potential errors or usage limits.

​
Step-by-Step Setup

​
Step 1: Navigate to the API Key Setup Page

  1. Open Web Access Setup

    • Access the WebAccess configuration page within the Genesis Bots environment.

  2. Locate Serper Search API Key Section

    • Look for a labeled field: “Google Serper Search API Key.”

    • You’ll find:

      • An input field to paste your API key.

      • A link labeled “here” pointing to Serper’s website for obtaining the key.

​
Step 2: Obtain the Serper API Key

  1. Follow the Provided Link

  2. Sign Up or Log In

    • If you’re new, create an account; otherwise, log in with your existing credentials.

  3. Go to API Key Section

    • Look for “API Tokens” or “API Key Management” in your account settings or dashboard.

  4. Generate Your API Key

    Important: This key is shown only once – store it securely to avoid losing access.

    • Click “Create API Key,” label it (e.g., “Bot Integration”), and copy the generated key.

​
Step 3: Input the API Key in the WebAccess Setup

  1. Return to the Setup Page

    • Navigate back to the “Google Serper Search API Key” field in WebAccess.

  2. Paste Your Key

    • Enter the key you copied from Serper.

    • Check for trailing spaces or hidden characters.

​
Step 4: Save and Apply the Configuration

  1. Click Save or Submit

    • Look for a confirmation message once you apply your key.

  2. Success Confirmation

    • A green “Web Access External Access Integration is available” message indicates correct setup.

​
Step 5: Test the WebAccess API Integration

  1. Perform a Test Query

    • For instance, run “Weather today” to verify search results come from the Serper API.

  2. Check for Errors

    • If you see “Unauthorized” or “API Key Invalid,” re-check your key or Serper account settings.

Additional Tips

  • Treat your API key like a password—don’t share it publicly.

  • If compromised, revoke it in Serper’s dashboard.

  • Check free-tier limits or daily usage to avoid interruptions.

​
Integration Relevance

  • Search-Based Workflows: Once configured, the WebAccess integration can run Google queries within tasks or automation flows.

  • Report Generation: Combine query results with analytics to enrich dataset insights.

  • Monitoring & Alerts: Periodically search for relevant news or updates (e.g., competitor activity) and notify team members.

​
Configuration Details

  • Credentials: Store the API key in a secure location—environment variables or a credential manager—to maintain best practices.

  • Permissions: Validate Serper usage limits and confirm your plan supports the number of queries required.

  • Network Check: Ensure the bot or workflow environment can reach https://serper.dev/ or any associated endpoints.

​
How It Works

Once the Serper API key is integrated into WebAccess, any Google search requests you initiate (e.g., _search_google) will use the Serper API to fetch results. The system returns structured data—titles, snippets, links—to power advanced automation or data enrichment tasks.

Example After entering your key and seeing a success message, you might instruct a bot to search “Snowflake scaling best practices.” The bot uses WebAccess + Serper to retrieve search snippets, which can then be processed or integrated into your workflow logs.