JSON POST request example
POST to https://api.litescrape.com/api/google/jobs with Content-Type: application/json and your Authorization: Bearer header.
{
"q": "software engineer jobs in New York"
}// request reference
Google Jobs parameters
Send query parameters with GET /api/google/jobs. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Search parameters
qJob search query, for example software engineer jobs in New York.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 512
pageOne-based results page. Use next_page from the response to continue.
Type integer · GET query or POST JSON · Default 1
- Minimum: 1
page_tokenCopy next_page_token with next_page and the same query to fetch the next batch directly.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 32768
- Pattern: ^[A-Za-z0-9+/=_-]+$
hlGoogle interface language, for example en, de, fr, es or pt-BR.
Type string · GET query or POST JSON · Default en
- Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$
glTwo-letter country code.
Type string · GET query or POST JSON · Default us
- Pattern: ^[a-z]{2}$
locationCanonical Google location, such as London,England,United Kingdom. Use one of location, uule or lat/lon.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 512
uuleExplicit Google UULE location value. Mutually exclusive with location and coordinates.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 2048
latLatitude of the search origin. Requires lon.
Type number · GET query or POST JSON
- Minimum: -90
- Maximum: 90
lonLongitude of the search origin. Requires lat.
Type number · GET query or POST JSON
- Minimum: -180
- Maximum: 180
radiusCoordinate accuracy radius in meters, requiring lat/lon. This locates the search origin; it is not a job-distance filter.
Type number · GET query or POST JSON
- Minimum: 1
- Maximum: 199
udsOpaque Google refinement value returned in available_filters. Copy its q and uds together; filter choices vary by query and market.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 16384
tbsGoogle search refinement string, for example qdr:w for the past week. Keep it unchanged through pagination.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 2048
include_filtersReturn available Google Jobs filters with the q and uds parameters needed to apply each one.
Type boolean · GET query or POST JSON · Default false
truefalse// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, jobs_results, search_information, pagination, litescrape_pagination, available_filters, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_metadata": {
"id": "830ef5a75e22c47212369298",
"status": "Success",
"created_at": "2026-10-11T05:16:04.163540+00:00",
"processed_at": "2026-10-11T05:16:04.529061+00:00",
"total_time_taken": 0.366,
"json_endpoint": "https://api.litescrape.com/api/google/jobs?q=software+engineer+jobs+in+New+York&page=1&hl=en&gl=us"
},
"search_parameters": {
"q": "software engineer jobs in New York",
"page": 1,
"hl": "en",
"gl": "us"
},
"jobs_results": [
{
"position": 1,
"job_id": "CS0hxrtrAnLdRsRNAAAAAA==",
"title": "Staff+ Fullstack Software Engineer, Safeguards Engineering",
"link": "https://www.google.com/search?q=software+engineer+jobs+in+New+York&ibp=htl%3Bjobs&htidocid=CS0hxrtrAnLdRsRNAAAAAA%3D%3D",
"company_name": "Anthropic",
"via": "LinkedIn",
"location": "New York, NY",
"posted": "1 day ago",
"employment_types": [
"Full-time"
]
}
],
"search_information": {
"jobs_results_state": "Results found"
},
"pagination": {
"current": 1,
"next": "https://www.google.com/async/callback:550?fc=EqIECuIDQUppVDR0S2NUdEp0Wk1mWFNhODBRZjl6ZEZCcmhteDRiY3NPOXp6bnpWeGFhYl9UaHYwTmxmNmFNVGFteXc5OU1NM0Y2T05CdFVicHVQS3hiY2ZubERKbl9lcFJ5ZFdxckNILUw2VUNlVE1UUElmOWl2U254R3VDWUVObWZIQnRIOHZHRzZ4MUpGRWxfbXY5SVcyOG5UVDl0ajFBbTh0dE40TWpheTVnOTB6WHBhdWlBMzIybm9jUk1DdXRtV0JlVnNuVGJIWnhpUFlHa0ZMc3Y4d2pRaUR2SEhYYkxFWk9pRklkMWZEQ3FIR3NhYmJqaHZQWjVMUDgtaW5seWJSR2wzNVgzVkx5WjRicUNGajNNRjVhNlhlamoyLWFLTHFzeUs0ekNiMV90RmFkaThQemowTUo4NUxSUDNwX29HU1JpNjlyYjFob2V6dV9tVjVrMjFyV3RHcFc1eVNXZEdfOF9qWWZVTE9Db0ZTZzF3czNJUm1RRVNJcnBGTWpXMHZhcG1BRHRBbTQtZWlVYm5nS2hmT1FIM3M2MUNIS3lJRTNTQXN1VFZqRzZsMDhXX28xRTllOFJicVhBQ3VUVEdIOHhFc28zckhVMVZVbTNpaXJLa1hlQXVUcWNqZDVEUjQyNncSF2xCdkxhclBxQ3QtZzVOb1AtSlRId1FFGiJBRHNyOWZUOTJNZ2N2LWs5WUJoVEZaX2N5MWJLd0llRktB&fcv=3&yv=3&udm=8&async=_fmt%3Aprog&hl=en&gl=us",
"next_page": 2,
"next_page_token": "EqIECuIDQUppVDR0S2NUdEp0Wk1mWFNhODBRZjl6ZEZCcmhteDRiY3NPOXp6bnpWeGFhYl9UaHYwTmxmNmFNVGFteXc5OU1NM0Y2T05CdFVicHVQS3hiY2ZubERKbl9lcFJ5ZFdxckNILUw2VUNlVE1UUElmOWl2U254R3VDWUVObWZIQnRIOHZHRzZ4MUpGRWxfbXY5SVcyOG5UVDl0ajFBbTh0dE40TWpheTVnOTB6WHBhdWlBMzIybm9jUk1DdXRtV0JlVnNuVGJIWnhpUFlHa0ZMc3Y4d2pRaUR2SEhYYkxFWk9pRklkMWZEQ3FIR3NhYmJqaHZQWjVMUDgtaW5seWJSR2wzNVgzVkx5WjRicUNGajNNRjVhNlhlamoyLWFLTHFzeUs0ekNiMV90RmFkaThQemowTUo4NUxSUDNwX29HU1JpNjlyYjFob2V6dV9tVjVrMjFyV3RHcFc1eVNXZEdfOF9qWWZVTE9Db0ZTZzF3czNJUm1RRVNJcnBGTWpXMHZhcG1BRHRBbTQtZWlVYm5nS2hmT1FIM3M2MUNIS3lJRTNTQXN1VFZqRzZsMDhXX28xRTllOFJicVhBQ3VUVEdIOHhFc28zckhVMVZVbTNpaXJLa1hlQXVUcWNqZDVEUjQyNncSF2xCdkxhclBxQ3QtZzVOb1AtSlRId1FFGiJBRHNyOWZUOTJNZ2N2LWs5WUJoVEZaX2N5MWJLd0llRktB"
},
"litescrape_pagination": {
"current": 1,
"next": "https://api.litescrape.com/api/google/jobs?q=software+engineer+jobs+in+New+York&page=2&hl=en&gl=us&page_token=EqIECuIDQUppVDR0S2NUdEp0Wk1mWFNhODBRZjl6ZEZCcmhteDRiY3NPOXp6bnpWeGFhYl9UaHYwTmxmNmFNVGFteXc5OU1NM0Y2T05CdFVicHVQS3hiY2ZubERKbl9lcFJ5ZFdxckNILUw2VUNlVE1UUElmOWl2U254R3VDWUVObWZIQnRIOHZHRzZ4MUpGRWxfbXY5SVcyOG5UVDl0ajFBbTh0dE40TWpheTVnOTB6WHBhdWlBMzIybm9jUk1DdXRtV0JlVnNuVGJIWnhpUFlHa0ZMc3Y4d2pRaUR2SEhYYkxFWk9pRklkMWZEQ3FIR3NhYmJqaHZQWjVMUDgtaW5seWJSR2wzNVgzVkx5WjRicUNGajNNRjVhNlhlamoyLWFLTHFzeUs0ekNiMV90RmFkaThQemowTUo4NUxSUDNwX29HU1JpNjlyYjFob2V6dV9tVjVrMjFyV3RHcFc1eVNXZEdfOF9qWWZVTE9Db0ZTZzF3czNJUm1RRVNJcnBGTWpXMHZhcG1BRHRBbTQtZWlVYm5nS2hmT1FIM3M2MUNIS3lJRTNTQXN1VFZqRzZsMDhXX28xRTllOFJicVhBQ3VUVEdIOHhFc28zckhVMVZVbTNpaXJLa1hlQXVUcWNqZDVEUjQyNncSF2xCdkxhclBxQ3QtZzVOb1AtSlRId1FFGiJBRHNyOWZUOTJNZ2N2LWs5WUJoVEZaX2N5MWJLd0llRktB",
"next_page": 2,
"next_page_token": "EqIECuIDQUppVDR0S2NUdEp0Wk1mWFNhODBRZjl6ZEZCcmhteDRiY3NPOXp6bnpWeGFhYl9UaHYwTmxmNmFNVGFteXc5OU1NM0Y2T05CdFVicHVQS3hiY2ZubERKbl9lcFJ5ZFdxckNILUw2VUNlVE1UUElmOWl2U254R3VDWUVObWZIQnRIOHZHRzZ4MUpGRWxfbXY5SVcyOG5UVDl0ajFBbTh0dE40TWpheTVnOTB6WHBhdWlBMzIybm9jUk1DdXRtV0JlVnNuVGJIWnhpUFlHa0ZMc3Y4d2pRaUR2SEhYYkxFWk9pRklkMWZEQ3FIR3NhYmJqaHZQWjVMUDgtaW5seWJSR2wzNVgzVkx5WjRicUNGajNNRjVhNlhlamoyLWFLTHFzeUs0ekNiMV90RmFkaThQemowTUo4NUxSUDNwX29HU1JpNjlyYjFob2V6dV9tVjVrMjFyV3RHcFc1eVNXZEdfOF9qWWZVTE9Db0ZTZzF3czNJUm1RRVNJcnBGTWpXMHZhcG1BRHRBbTQtZWlVYm5nS2hmT1FIM3M2MUNIS3lJRTNTQXN1VFZqRzZsMDhXX28xRTllOFJicVhBQ3VUVEdIOHhFc28zckhVMVZVbTNpaXJLa1hlQXVUcWNqZDVEUjQyNncSF2xCdkxhclBxQ3QtZzVOb1AtSlRId1FFGiJBRHNyOWZUOTJNZ2N2LWs5WUJoVEZaX2N5MWJLd0llRktB"
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}