Skip to main content

​
Overview

Integrate powerful search capabilities into your workflows with Serper, providing access to Google Search results, images, news, and more.

Google Search

Access Google search results programmatically

Multiple Search Types

Web, images, news, shopping, videos, and more

Real-time Data

Get fresh, up-to-date search results

Rich Results

Structured data with snippets and metadata

​
Serper

Serper provides Google Search API access with multiple search types and rich result formatting.

​
Setup

  1. Sign up at serper.dev
  2. Get your API key from the dashboard
  3. Add integration in Splox: Settings > Integrations > Serper
  4. Enter your API key
Free Tier: 2,500 free searches, then pay-as-you-go pricing.

​
Available Actions

Search for images on Google.Parameters:
  • q - Search query
  • num - Number of results
  • gl - Country code
  • hl - Language code
  • tbs - Image filters (size, color, type, etc.)
Returns:
  • images - Array of image results
    • title - Image title
    • imageUrl - Direct image URL
    • imageWidth - Image width
    • imageHeight - Image height
    • thumbnailUrl - Thumbnail URL
    • source - Source website
    • link - Source page URL
Search for news articles.Parameters:
  • q - Search query
  • num - Number of results
  • gl - Country code
  • hl - Language code
  • tbs - Time filter (qdr:h = past hour, qdr:d = past day, etc.)
Returns:
  • news - Array of news articles
    • title - Article title
    • link - Article URL
    • snippet - Article excerpt
    • date - Publication date
    • source - News source
    • imageUrl - Article image
Search for products and shopping results.Parameters:
  • q - Product search query
  • num - Number of results
  • gl - Country code
  • hl - Language code
  • tbs - Price range filters
Returns:
  • shopping - Array of product results
    • title - Product name
    • link - Product page
    • price - Product price
    • source - Seller/website
    • rating - Product rating
    • reviews - Number of reviews
    • imageUrl - Product image
Search for videos on Google.Parameters:
  • q - Search query
  • num - Number of results
  • gl - Country code
  • hl - Language code
Returns:
  • videos - Array of video results
    • title - Video title
    • link - Video URL
    • snippet - Video description
    • imageUrl - Thumbnail URL
    • duration - Video duration
    • source - Video platform
    • channel - Channel name
    • date - Upload date
Search for local business and location information.Parameters:
  • q - Search query
  • location - Location to search near
  • num - Number of results
  • gl - Country code
Returns:
  • places - Array of place results
    • title - Business name
    • address - Business address
    • rating - Average rating
    • reviews - Number of reviews
    • phone - Phone number
    • cid - Google CID
    • position - Geographic coordinates
Search Google Scholar for academic papers.Parameters:
  • q - Search query
  • num - Number of results
  • year - Publication year
Returns:
  • organic - Array of scholarly articles
    • title - Paper title
    • link - Paper URL
    • snippet - Abstract excerpt
    • publication - Publication venue
    • authors - List of authors
    • citedBy - Citation count
    • year - Publication year
Reverse image search using Google Lens.Parameters:
  • url - Image URL to search for
  • gl - Country code
  • hl - Language code
Returns:
  • visualMatches - Similar images
  • knowledgeGraph - Entity information
  • textResults - Text found in image

​
Advanced Features

​
Time-Based Filtering

Use tbs parameter to filter by time: Get localized results:

​
Autocorrect

Control spelling correction:

​
Pagination

Get multiple pages of results:

​
Use Cases

Gather competitive intelligence and market trends by searching for industry news, product reviews, and competitor mentions.
Find relevant sources, statistics, and references for content creation and fact-checking.
Discover potential clients by searching for businesses in specific industries and locations.
Track product prices across different retailers using shopping search.
Stay updated on specific topics, brands, or events with real-time news search.
Find scholarly articles and research papers for literature reviews and citations.
Analyze search results and competitor rankings for SEO strategy.
Use reverse image search to verify image sources and detect duplicates.

​
Rate Limits

  • Free Tier: 2,500 searches/month
  • Paid Plans: Up to 1M searches/month
  • Rate Limit: 100 requests/second
Monitor your usage in the Serper dashboard to avoid exceeding limits.

​
Best Practices

Query Optimization

Use specific, well-formed queries for better results

Result Filtering

Use time and location filters to narrow results

Error Handling

Handle API errors and rate limits gracefully

Caching

Cache results to reduce API calls

Cost Management

Monitor usage and optimize queries

Data Extraction

Parse structured data from results

​
Troubleshooting

Causes:
  • Query too specific
  • Typos in query
  • Location restrictions
Solutions:
  • Broaden query terms
  • Enable autocorrect
  • Remove location filters
Causes:
  • Too many requests
  • Exceeded monthly quota
Solutions:
  • Implement rate limiting
  • Upgrade plan
  • Cache results
Causes:
  • Wrong API key
  • Key expired or revoked
Solutions:
  • Verify API key in dashboard
  • Generate new key if needed

​
Next Steps

Web Scraping

Extract detailed data from search results

AI Providers

Analyze search results with AI

Social Media

Share search insights

Tool Node

Use search in workflows