news-shopping

# 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](rules/getting-started.md) for installation and wallet setup. ## Quick Reference | Task | Endpoint | Price | Description | |------|----------|-------|-------------| | News search | `https://enrichx402.com/api/serper/news` | $0.04 | Google News search | | Shopping search | `https://enrichx402.com/api/serper/shopping` | $0.04 | Google Shopping search | ## News Search Search Google News for articles: ```mcp 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 | 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: ```mcp x402.fetch( url=".../serper/news", body={ "q": "AI startups funding", "tbs": "qdr:w" } ) ``` ### Country/Language Filtering ```mcp 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: ```mcp 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: ```mcp 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 ```mcp 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 ```mcp 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 ```mcp 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 ```mcp 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. | 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 |