news-shopping

News & Shopping Search with Serper Access Google News and Google Shopping through x402-protected endpoints. Setup See rules/getting-started.md for installation and wallet setup. Quick Reference Task Endpoint Price Description News search https://stableenrich.dev/api/serper/news $0.04 Google News search Shopping search https://stableenrich.dev/api/serper/shopping $0.04 Google Shopping search 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 (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 Filter Meaning qdr:h Past hour qdr:d Past 24 hours qdr:w Past week qdr:m Past month qdr:y Past year 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 (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: npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "MacBook Pro M3", "gl": "us"}' Workflows News Monitoring (Optional) Check balance: npx agentcash@latest wallet info 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 Both endpoints are $0.04 per call. Task Calls Cost Quick news check 1 $0.04 Daily news summary 2-3 $0.08-0.12 Product research 1-2 $0.04-0.08 Full market research 3-5 $0.12-0.20