news-shopping

# 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](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 | | Image search | `https://stableenrich.dev/api/serper/images` | $0.04 | Google Images search | | People image search | `https://stableenrich.dev/api/serper/people-image-search` | $0.04 | Google Images tuned for people/headshots | | Reverse image search | `https://stableenrich.dev/api/serper/lens` | $0.20 | Google Lens reverse image search | ## News Search Search Google News for articles: ```bash 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 | 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: ```bash npx agentcash@latest fetch https://stableenrich.dev/api/serper/news -m POST -b '{"q": "AI startups funding", "tbs": "qdr:w"}' ``` ### Country/Language Filtering ```bash 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: ```bash 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: ```bash npx agentcash@latest fetch https://stableenrich.dev/api/serper/shopping -m POST -b '{"q": "MacBook Pro M3", "gl": "us"}' ``` ## Image Search Search Google Images: ```bash 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: ```bash 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): ```bash 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 ```bash 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 ```bash 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 ```bash 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 ```bash 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. | 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 | | Image or headshot search | 1 | $0.04 | | Reverse image lookup (Lens) | 1 | $0.20 |