Set the Google search parameters you need and copy the URL. You also get the equivalent JustSERP API request. Everything runs in your browser, and the tool is free.
Already have a Google search URL? Paste it and the form below fills in for you, so you can see the API request for it.
The URL and the API request below update as you type.
Google uses udm or tbm for this. The API uses a different endpoint for each type.
Only used in the Google URL. The API ignores the domain, so the request leaves it out.
Pick a name from Google's list. It becomes uule in the URL and location in the API.
Google uses start, which is (page - 1) x 10.
Blur has no Google URL form, so the URL leaves it out.
API only. Device is not a Google URL parameter.
Only show pages written in this language, like lang_fr.
Only show pages from this country, like countryDE. Join several with |.
JustSERP API request
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=" \ --data-urlencode "gl=us" \ --data-urlencode "hl=en"
Replace YOUR_API_KEY with your key. Parameters the endpoint does not accept are left out of both outputs.
Every setting in the builder, what it does in a Google URL, and the matching JustSERP API parameter.
| Parameter | What it does | Example values | JustSERP API |
|---|---|---|---|
| q | The search query. | q=coffee | q |
| udm, tbm | The search type. udm=14 is the Web filter, without AI Overview. | udm=2 (images), udm=28 (shopping), udm=14, tbm=nws (news), tbm=vid (videos) | Endpoint: /v1/google/search, images, news, videos, shopping |
| gl | The country to search from. | gl=us, gl=gb, gl=de | gl |
| hl | The interface language. | hl=en, hl=es-419, hl=pt-BR | hl |
| uule | A location, as an encoded canonical name or GPS point. | uule=w+CAIQICIf... | location (a name) or uule |
| tbs=qdr | Results from the past hour, day, week, month or year. | qdr:h, qdr:d, qdr:w, qdr:m, qdr:y | time_period = last_hour, last_day, last_week, last_month, last_year |
| tbs=cdr | A custom date range. | cdr:1,cd_min:01/15/2024,cd_max:03/31/2024 | time_period_min, time_period_max (MM/DD/YYYY; web and news) |
| tbs=li:1 | Verbatim: match the words as typed. | tbs=li:1, or tbs=li:1,qdr:w | verbatim=true (web) |
| start | How many results to skip. Ten per page. | start=10 (page 2), start=20 (page 3) | page=2, page=3 |
| safe | SafeSearch. | safe=active, safe=off | safe = active, blur, off |
| nfpr | Do not auto-correct the query. | nfpr=1 | nfpr=1 |
| filter | filter=0 shows results Google hides as similar. | filter=0 | filter=0 |
| lr | Only pages written in a language. | lr=lang_en, lr=lang_ja | lr |
| cr | Only pages from a country. | cr=countryUS | cr |
| Domain | The Google site the URL points to. | www.google.com, www.google.co.uk | Not needed. The API ignores it. |
| Device | Not a URL parameter. Google decides from the browser. | n/a | device=mobile |
Each example shows the Google URL and the JustSERP request that asks for the same thing.
Use the news type, set the country and language for the UK, and limit the time.
Google URL
https://www.google.co.uk/search?q=budget%20announcement&tbm=nws&gl=gb&hl=en-GB&tbs=qdr:w
JustSERP API
curl -G "https://api.justserp.com/v1/google/news" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=budget announcement" \ --data-urlencode "gl=gb" \ --data-urlencode "hl=en-GB" \ --data-urlencode "time_period=last_week"
Set hl to Japanese and add lr so only Japanese pages count.
JustSERP API
curl -G "https://api.justserp.com/v1/google/images" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=桜" \ --data-urlencode "gl=jp" \ --data-urlencode "hl=ja" \ --data-urlencode "lr=lang_ja"
Verbatim stops Google from swapping or dropping words.
Google URL
https://www.google.com/search?q=running%20shoes%20for%20flat%20feet&gl=us&hl=en&tbs=li:1
JustSERP API
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=running shoes for flat feet" \ --data-urlencode "gl=us" \ --data-urlencode "hl=en" \ --data-urlencode "verbatim=true"
Page 3 means start=20 on Google and page=3 in the API.
JustSERP API
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=kaffeemaschine" \ --data-urlencode "gl=de" \ --data-urlencode "hl=de" \ --data-urlencode "page=3"
A custom range uses cdr in the URL and time_period_min and time_period_max in the API.
Google URL
https://www.google.com/search?q=ai%20regulation&gl=us&hl=en&tbs=cdr:1,cd_min:01/01/2024,cd_max:06/30/2024
JustSERP API
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=ai regulation" \ --data-urlencode "gl=us" \ --data-urlencode "hl=en" \ --data-urlencode "time_period_min=01/01/2024" \ --data-urlencode "time_period_max=06/30/2024"
gl is the country you search from, hl is the language of the Google interface, cr only keeps pages from a country, and lr only keeps pages written in a language. gl and hl change how results are ranked and shown. cr and lr filter what can appear at all.
Add tbs=cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY to the URL. In the JustSERP API, send time_period_min and time_period_max in the same MM/DD/YYYY form. Ranges work for web and news search.
Google stopped honouring num=100 in September 2025, so a page holds about 10 results. This builder does not add num. To get more results, ask for the next page with start in a Google URL or page in the JustSERP API.
udm=14 opens the Web filter, which lists plain web results without an AI Overview. The JustSERP API returns web results either way, so it has no matching parameter.
Add start=10 to the Google URL. Page 3 is start=20, and so on, at ten results per page. With the JustSERP API, send page=2.
The domain mostly sets the default country and language. For results you can repeat, set gl and hl yourself. The JustSERP API takes gl and hl and ignores the domain.
Need to target a place? Use the UULE generator and decoder. Full request details are in the API docs.
JustSERP was born out of our own need to scrape google search results to parse data for analytical and processing needs. We have gone through the excruciating process of running automated web search queries by bypassing bot filters, solving captchas and parsing convoluted HTML. It is our pleasure to share our expertise with others through this affordable, fast and reliable SERP API. Don't hesitate to contact us with any questions at [email protected].