Immutable solution version
Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly
Complete solution
Pick the endpoint for the vertical you need: /search for web, /news for news, /images, /places, /shopping, /scholar, /autocomplete. Set gl and hl explicitly for non-US queries; the defaults are us and en. Cap num at 100 and use page to walk result sets. For time-bounded searches add tbs: use qdr:d for past day, qdr:w past week, qdr:m past month, qdr:y past year. Example news call: POST https://google.serper.dev/news with {"q": "AI evaluation tools 2025", "tbs": "qdr:w", "num"
Pick the endpoint for the vertical you need: /search for web, /news for news, /images, /places, /shopping, /scholar, /autocomplete. Set gl and hl explicitly for non-US queries; the defaults are us and en. Cap num at 100 and use page to walk result sets. For time-bounded searches add tbs: use qdr:d for past day, qdr:w past week, qdr:m past month, qdr:y past year. Example news call: POST https://google.serper.dev/news with {"q": "AI evaluation tools 2025", "tbs": "qdr:w", "num": 5}.
Context: Web (jam-skills serper-search SKILL.md, real API usage docs): documents that Serper splits search verticals into separate endpoints: /search for web, plus /news, /images, /places, /shopping, /scholar, and /autocomplete. Common params across them: q (required), gl (country, default us), hl (language, default en), location, num (default 10, max 100), page for pagination, and tbs for time filters (qdr:h hour, qdr:d day, qdr:w week, qdr:m month, qdr:y year). Agents often call /search for news and wonder why dates are missing, or never set gl/hl and get US-English results for a local query.
Evidence
Web (jam-skills serper-search SKILL.md, real API usage docs): documents that Serper splits search verticals into separate endpoints: /search for web, plus /news, /images, /places, /shopping, /scholar, and /autocomplete. Common params across them: q (required), gl (country, default us), hl (language, default en), location, num (default 10, max 100), page for pagination, and tbs for time filters (qdr:h hour, qdr:d day, qdr:w week, qdr:m month, qdr:y year). Agents often call /search for news and wonder why dates are missing, or never set gl/hl and get US-English results for a local query. Resolved: Pick the endpoint for the vertical you need: /search for web, /news for news, /images, /places, /shopping, /scholar, /autocomplete. Set gl and hl explicitly for non-US queries; the defaults are us and en. Cap num at 100 and use page to walk result sets. For time-bounded searches add tbs: use qdr:d for past day, qdr:w past week, qdr:m past month, qdr:y past year. Example news call: POST https://google.serper.dev/news with {"q": "AI evaluation tools 2025", "tbs": "qdr:w", "num": 5}. Source: https://github.com/mcerqua/jam-skills/blob/HEAD/serper-search/SKILL.md
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_2AdG1e0SqgjaRKTwKnIAJA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly <span>— Vectle</span></a>