Docs / API reference

POST/v1/data/google/jobs

Google Jobs

Search Google Careers and return normalized job listings.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Google Jobs Endpoint

Search Google Careers and return normalized job listings.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run Google Jobs

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "software engineer",
  "num_results": 10,
  "has_remote": true,
  "target_level": [
    "MID"
  ],
  "sort_by": "date"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}

Options

Query and Target

Set the search term, identifier, or source URL that defines the request.

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "web scraping tools",
  "num_results": 10,
  "has_remote": true,
  "target_level": [
    "MID"
  ],
  "sort_by": "date"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}

Results and Pagination

Control how many records or pages are returned.

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "software engineer",
  "num_results": 100,
  "has_remote": true,
  "target_level": [
    "MID"
  ],
  "sort_by": "date"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}

Location and Language

Localize results with country, language, coordinates, or delivery-location fields.

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "software engineer",
  "num_results": 10,
  "has_remote": true,
  "target_level": [
    "MID"
  ],
  "sort_by": "date",
  "location": "New York, NY"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}

Filters and Sorting

Narrow or order the returned records.

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "software engineer",
  "num_results": 10,
  "has_remote": true,
  "target_level": [
    "example"
  ],
  "sort_by": "relevance",
  "employment_type": [
    "example"
  ],
  "company": [
    "example"
  ],
  "degree": "example",
  "skills": "example"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}

Response

Read success first, then consume the endpoint-specific records and pagination fields shown below.

Error Handling

Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.

Parameters

NameTypeRequirementDescription
querystringRequiredJob search query, e.g. software engineer.
num_resultsnumberOptionalNumber of jobs to fetch. Auto-paginates provider pages (1-2000).
has_remotebooleanOptionalFilter to remote-eligible jobs when true.
target_levelstring[]OptionalExperience levels: INTERN_AND_APPRENTICE, EARLY, MID, ADVANCED, DIRECTOR.
employment_typestring[]OptionalJob types: FULL_TIME, PART_TIME, TEMPORARY, INTERN.
companystring[]OptionalOrganizations such as Google, DeepMind, GFiber, Waymo, Wing, YouTube, Verily Life Sciences.
locationstring[]OptionalLocation filters, e.g. New York, NY, USA.
degreestringOptionalDegree filter: PURSUING_DEGREE, ASSOCIATE, BACHELORS, MASTERS, PHD.
skillsstringOptionalSkills filter, e.g. coding.
sort_bystringOptionalSort order: relevance or date.

Response fields

FieldTypeDescription
successbooleanWhether the request completed successfully.
querystringNormalized job query.
total_resultsnumberTotal matching jobs when the source exposes it.
jobsarrayJob rows with job_id, title, company, locations, apply_url, detail_url, HTML detail blocks, experience_level, created_at, and updated_at.
companiesarrayAvailable source company filters when exposed.
time_takennumberAPI response time in seconds.
errorstringError or source-empty classification.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/google/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "software engineer",
  "num_results": 10,
  "has_remote": true,
  "target_level": [
    "MID"
  ],
  "sort_by": "date"
}'
Example response
{
  "success": true,
  "query": "software engineer",
  "total_results": 10,
  "time_taken": 2.34,
  "jobs": [
    {
      "position": 1,
      "job_id": "123456789",
      "title": "Software Engineer, Search",
      "company": "Google",
      "locations": [
        {
          "display_name": "Bengaluru, Karnataka, India",
          "city": "Bengaluru",
          "country": "IN"
        }
      ],
      "apply_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "detail_url": "https://www.google.com/about/careers/applications/jobs/results/123456789",
      "experience_level": "MID",
      "created_at": "2026-07-01",
      "updated_at": "2026-07-08"
    }
  ]
}