News & Shopping Search with Serper

Access Google News, Google Shopping, Google Images, and Google Lens through x402-protected endpoints.

Setup

See rules/getting-started.md for installation and wallet setup.

Quick Reference

News Search

Search Google News for articles:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "artificial intelligence regulation"}'

Parameters:

• q - Search query (required)
• num - Number of results (1-100, default: 10)
• gl - Country code (e.g., "us", "uk", "de")
• hl - Language (e.g., "en", "es", "fr")
• location - Location (e.g., "New York, NY")
• tbs - Time filter (qdr:h, qdr:d, qdr:w, qdr:m, qdr:y)

Time Filters

Example - news from past week:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "AI startups funding", "tbs": "qdr:w"}'

Country/Language Filtering

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "technology news", "gl": "uk", "hl": "en"}'

Returns:

• Article title and snippet
• Source/publication name
• Published date
• Article URL
• Thumbnail image (if available)

Shopping Search

Search Google Shopping for products:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "wireless noise cancelling headphones"}'

Parameters:

• q - Search query (required)
• num - Number of results (1-100, default: 10)
• gl - Country code for pricing/availability
• hl - Language
• location - Location (e.g., "New York, NY")

Returns:

• Product title
• Price and currency
• Merchant/store name
• Product URL
• Rating (if available)
• Thumbnail image

Shopping with Location

Get local pricing and availability:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "MacBook Pro M3", "gl": "us"}'

Image Search

Search Google Images:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/images -m POST -b '{"q": "aurora borealis over mountains"}'

Parameters:

• q - Search query (required)
• num - Number of results (1-100, default: 10)
• gl - Country code
• hl - Language
• location - Location (e.g., "New York, NY")

Returns:

• Image title
• Full image URL with width/height
• Thumbnail URL with width/height
• Source page name, domain, and link

People Image Search

Google Images tuned for finding people/headshots:

npx agentcash@latest fetch https://stableenrich.dev/api/serper/people-image-search -m POST -b '{"q": "\"Jane Doe\" \"Acme\" LinkedIn headshot"}'

Parameters: Same as Image Search. Use an exact-name + company/context query.

Tips:

• For ambiguous people, resolve the profile slug/company/title first
• LinkedIn photos may be non-public; if the first search fails, retry with public non-LinkedIn source terms

Reverse Image Search (Lens)

Reverse-search a public image URL with Google Lens ($0.20 per call):

npx agentcash@latest fetch https://stableenrich.dev/api/serper/lens -m POST -b '{"url": "https://example.com/photo.jpg"}'

Parameters:

• url - Public URL of the image to reverse-search (required)
• gl - Country code
• hl - Language

Returns: organic matches with title, link, source, image/thumbnail URLs, price/priceRange (if available), and snippet.

Workflows

News Monitoring

• (Optional) Check balance: npx agentcash@latest balance
• Search with appropriate time filter
• Review and summarize top stories

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "company name OR competitor name", "tbs": "qdr:d", "num": 20}'

Breaking News Research

• Search with qdr:h for past hour
• Identify key sources and facts
• Note developing aspects

npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "breaking news topic", "tbs": "qdr:h"}'

Product Research

• Define search criteria (category, price range)
• Search Google Shopping
• Compare prices across merchants
• Present top options with pros/cons

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "ergonomic office chair under $500", "num": 20}'

Price Comparison

• Use exact product name/model
• Compare merchant prices
• Note shipping and availability

npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "exact product name model number"}'

Response Data

News Article Fields

• title - Article headline
• snippet - Article excerpt
• source - Publication name
• date - Published date
• link - Article URL
• imageUrl - Thumbnail (if available)

Shopping Product Fields

• title - Product name
• price - Price with currency
• source - Merchant/store
• link - Product URL
• rating - Star rating (if available)
• reviews - Number of reviews
• imageUrl - Product image
• delivery - Shipping info (if available)

Tips

News Search

• Use quotes for exact phrases: "climate change"
• Use OR for alternatives: AI OR "artificial intelligence"
• Be specific to get relevant results
• Use time filters to avoid old news

Shopping Search

• Include brand/model for specific products
• Add "under $X" or "best" for filtered results
• Check gl parameter for accurate local pricing
• More results = better price comparison

Cost Estimation

News, shopping, images, and people-image-search are $0.04 per call; Lens is $0.20.