Jobs Search

The '/google/jobs' API endpoint allows you to scrape job listings from Google Jobs via our Scrappa.co service. Head to the playground for a live and interactive demo. You can query 'https://app.scrappa.co/api/google/jobs' using a 'GET' request.

Google Jobs aggregates job postings from across the web, including company career pages, job boards, and staffing agencies.

Endpoint

GET /api/google_jobs

Parameters

q string Optional

The job search query.

Example: software engineer

Note: Not required when using next_page_token

next_page_token string Optional

Pagination token to fetch the next page of results.

This token is returned in the next_page_token field of API responses when more results are available.

Example: eyJmYyI6IkVyY0RDdmNDUVV4cmRG...

Note: When provided, the q parameter is not required.

hl string Optional

2-letter language code for search interface.

Examples: en, es, fr, de

For full list: Google Languages

gl string Optional

2-letter country code for search results.

Examples: us, de, fr, uk

For full list: ISO 3166-1 alpha-2

google_domain string Optional

Specify which Google domain to use for the search.

Examples: google.com, google.de, google.co.uk

uule string Optional

Encoded location parameter for precise geolocation.

lrad string Optional

Search radius around the specified location (in miles).

Values: 5, 10, 25, 50, 100

Note: Requires uule to be specified

uds string Optional

Filter string provided by Google to refine search results.

This parameter is returned in the filters section of API responses and can be used to apply specific filters to subsequent searches.

Note: UDS values are dynamic and generated by Google based on available filters for each search.

Request Examples

<?php

$curl = curl_init();

curl_setopt_array($curl, [
	CURLOPT_URL => "https://app.scrappa.co/api/google/jobs?q=software+engineer&hl=en",
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_ENCODING => "",
	CURLOPT_MAXREDIRS => 10,
	CURLOPT_TIMEOUT => 30,
	CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
	CURLOPT_CUSTOMREQUEST => "GET",
	CURLOPT_HTTPHEADER => [
		"x-api-key: YOUR_API_KEY_HERE"
	],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
	echo "cURL Error #:" . $err;
} else {
	echo $response;
}
const url = 'https://app.scrappa.co/api/google/jobs?q=software+engineer&hl=en';
const options = {
	method: 'GET',
	headers: {
		'x-api-key': 'YOUR_API_KEY_HERE',
	}
};

try {
	const response = await fetch(url, options);
	const result = await response.text();
	console.log(result);
} catch (error) {
	console.error(error);
}
require 'uri'
require 'net/http'

url = URI("https://app.scrappa.co/api/google/jobs?q=software+engineer&hl=en")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = 'YOUR_API_KEY_HERE'

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("app.scrappa.co")

headers = {
    'x-api-key': "YOUR_API_KEY_HERE",
}

conn.request("GET", "/api/google/jobs?q=software+engineer&hl=en", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
	.url("https://app.scrappa.co/api/google/jobs?q=software+engineer&hl=en")
	.get()
	.addHeader("x-api-key", "YOUR_API_KEY_HERE")
	.build();

Response response = client.newCall(request).execute();

Response Schema

[
    {
        "title": null,
        "description": null,
        "json_sample": {
            "data": {
                "jobs": [
                    {
                        "via": "LinkedIn",
                        "title": "Software Engineer",
                        "job_id": "example_job_id_123",
                        "company": "Tech Company Inc.",
                        "location": "San Francisco, CA",
                        "posted_at": "2 days ago",
                        "extensions": [
                            "Full-time",
                            "Health insurance",
                            "Dental insurance"
                        ],
                        "description": "We are seeking a talented software engineer...",
                        "detected_extensions": {
                            "posted_at": "2 days ago",
                            "schedule_type": "Full-time"
                        }
                    }
                ],
                "filters": {
                    "date_posted": [
                        {
                            "label": "Any time",
                            "value": null
                        },
                        {
                            "label": "Last 24 hours",
                            "value": "today"
                        },
                        {
                            "label": "Last 3 days",
                            "value": "3days"
                        },
                        {
                            "label": "Last week",
                            "value": "week"
                        }
                    ],
                    "employment_type": [
                        {
                            "label": "Full-time",
                            "value": "1"
                        },
                        {
                            "label": "Part-time",
                            "value": "2"
                        },
                        {
                            "label": "Contractor",
                            "value": "3"
                        },
                        {
                            "label": "Internship",
                            "value": "4"
                        }
                    ]
                },
                "highlights": [
                    {
                        "items": [
                            "Python",
                            "JavaScript",
                            "React"
                        ],
                        "title": "Top Skills"
                    },
                    {
                        "items": [
                            "Health insurance",
                            "401(k)",
                            "Remote work"
                        ],
                        "title": "Benefits"
                    }
                ],
                "search_information": {
                    "query": "software engineer",
                    "location": "San Francisco, CA",
                    "time_taken": 1.23,
                    "total_results": "1000+"
                }
            }
        }
    }
]

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home