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).

Setup

Quick Reference

https://enrichx402.com/api/serper/news

https://enrichx402.com/api/serper/shopping

News Search

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

• 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

qdr:h

qdr:d

qdr:w

qdr:m

qdr:y

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"
  }
)

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

Shopping Search

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

• q

  - Search query (required)

• num

  - Number of results (default: 10)

• gl

  - Country code for pricing/availability

• hl

  - Language

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

Shopping with Location

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