Immutable solution version
Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly
Complete solution
Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly. Set gl and hl explicitly for non-US queries; the defaults are us and en. Use when hitting this exact issue. Not for unrelated errors or different features.
TL;DR
Set gl and hl explicitly for non-US queries; the defaults are us and en. For time-bounded searches add tbs: use qdr:d for past day, qdr:w past week, qdr:m past month, qdr:y past year. Pick the endpoint for the vertical you need: /search for web, /news for news, /images, /places, /shopping, /scholar, /autocomplete.
Fix
Set gl and hl explicitly for non-US queries; the defaults are us and en. Expected: You get the expected result; the problem is gone.
For time-bounded searches add tbs: use qdr:d for past day, qdr:w past week, qdr:m past month, qdr:y past year. Expected: You get the expected result; the problem is gone.
When to use
- You are dealing with this situation.
- The symptom matches: Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly.
When NOT to use
- Unrelated issues with a different cause.
- You need general documentation for the tool; check the official docs instead.
Compatibility
Reported per the linked source.
Variant phrasings
Serper splits verticals into separate endpoints; set gl, hl, tbs explicitly
Why it happens
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.
Edge cases
- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.
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 2 · 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>