News & Shopping Search with Serper

STOP — Read before making any API call. enrichx402.com endpoints are not the same as each provider's native API. All paths use the format https://enrichx402.com/api/{provider}/{action}. You MUST either:

1. •Copy exact URLs from the Quick Reference table below, OR
2. •Run x402.discover_api_endpoints(url="https://enrichx402.com") to get the correct paths

Guessing paths will fail with 405 errors (wrong path) or 404 errors (missing /api/ prefix).

Access Google News and Google Shopping through x402-protected endpoints.

Setup

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

Quick Reference

News Search

Search Google News for articles:

x402.fetch(
  url="https://enrichx402.com/api/serper/news",
  method="POST",
  body={
    "q": "artificial intelligence regulation"
  }
)

Parameters:

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

Time Filters

Example - news from past week:

x402.fetch(
  url=".../serper/news",
  body={
    "q": "AI startups funding",
    "tbs": "qdr:w"
  }
)

Country/Language Filtering

x402.fetch(
  url=".../serper/news",
  body={
    "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:

x402.fetch(
  url="https://enrichx402.com/api/serper/shopping",
  method="POST",
  body={
    "q": "wireless noise cancelling headphones"
  }
)

Parameters:

• •q - Search query (required)
• •num - Number of results (default: 10)
• •gl - Country code for pricing/availability
• •hl - Language

Returns:

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

Shopping with Location

Get local pricing and availability:

x402.fetch(
  url=".../serper/shopping",
  body={
    "q": "MacBook Pro M3",
    "gl": "us"
  }
)

Workflows

News Monitoring

1. •(Optional) Check balance: x402.get_wallet_info
2. •Discover endpoints (required before first fetch): x402.discover_api_endpoints(url="https://enrichx402.com")
3. •Search with appropriate time filter
4. •Review and summarize top stories

x402.fetch(
  url="https://enrichx402.com/api/serper/news",
  method="POST",
  body={"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

x402.fetch(
  url="https://enrichx402.com/api/serper/news",
  method="POST",
  body={"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

x402.fetch(
  url="https://enrichx402.com/api/serper/shopping",
  method="POST",
  body={"q": "ergonomic office chair under $500", "num": 20}
)

Price Comparison

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

x402.fetch(
  url="https://enrichx402.com/api/serper/shopping",
  method="POST",
  body={"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

Both endpoints are $0.04 per call.