cotera
Logo

Google Jobs

Authentication Type: API Key
Description: Search for job listings across multiple job sites using JSsearch API powered by Google Jobs.

Search for job listings with advanced filtering options including location, employment type, and posting date.

Search Jobs

Search for job listings using keywords, location, and filters. Returns comprehensive job details including employer information, job descriptions, salary data, and application links.

Operation Type: Query (Read)

Parameters:

  • query string (required): Search query for jobs
  • page number (required): Page number (1-50). Defaults to 1
  • num_pages number (required): Number of pages to return (1-50). Defaults to 1
  • country string (required): Country code (ISO 3166-1 alpha-2). Defaults to "us"
  • language string (nullable): Language code (ISO 639)
  • date_posted string (required): Filter by posting date. Options: "all", "today", "3days", "week", "month". Defaults to "all"
  • work_from_home boolean (nullable): Only return remote jobs
  • employment_types string (nullable): Employment types (FULLTIME, CONTRACTOR, PARTTIME, INTERN)
  • job_requirements string (nullable): Job requirements filter

Returns:

  • status string: Response status
  • request_id string: Unique request identifier
  • parameters object: Search parameters used
    • query string: Search query
    • page number: Page number
    • num_pages number: Number of pages
    • date_posted string (nullable): Date posted filter
    • country string: Country code
    • language string (nullable): Language code
  • data array of objects: Array of job listings
    • job_id string: Unique job identifier
    • job_title string: Job title
    • employer_name string: Company name
    • employer_logo string (nullable): Company logo URL
    • employer_website string (nullable): Company website URL
    • job_publisher string: Job board/publisher name
    • job_employment_type string: Primary employment type
    • job_employment_types array of strings: All employment types
    • job_apply_link string: Primary application link
    • job_apply_is_direct boolean: Whether application is direct to company
    • apply_options array of objects: Multiple application options
      • publisher string: Publisher name
      • apply_link string: Application link
      • is_direct boolean: Whether application is direct
    • job_description string: Full job description
    • job_is_remote boolean: Whether job is remote
    • job_posted_at string: Human-readable posting date
    • job_posted_at_timestamp number: Unix timestamp of posting
    • job_posted_at_datetime_utc string: UTC datetime of posting
    • job_location string: Job location
    • job_city string (nullable): City
    • job_state string (nullable): State/province
    • job_country string: Country
    • job_latitude number (nullable): Latitude coordinate
    • job_longitude number (nullable): Longitude coordinate
    • job_benefits array of strings (nullable): Job benefits
    • job_google_link string: Google Jobs link
    • job_salary string (nullable): Salary information
    • job_min_salary number (nullable): Minimum salary
    • job_max_salary number (nullable): Maximum salary
    • job_salary_period string (nullable): Salary period (annual, hourly, etc.)
    • job_highlights object (nullable): Job highlights
      • Qualifications array of strings (nullable): Required qualifications
      • Benefits array of strings (nullable): Job benefits
      • Responsibilities array of strings (nullable): Key responsibilities
    • job_onet_soc string (nullable): O*NET-SOC occupation code
    • job_onet_job_zone string (nullable): O*NET job zone

Example Usage:

{
  "query": "software engineer python",
  "page": 1,
  "num_pages": 2,
  "country": "us",
  "language": "en",
  "date_posted": "week",
  "work_from_home": true,
  "employment_types": "FULLTIME",
  "job_requirements": null
}

Common Use Cases

Job Market Research:

  • Analyze salary ranges and compensation trends for specific roles and locations
  • Monitor job posting frequency and demand patterns across different industries
  • Research company hiring activity and job market competitiveness in target regions

Career Development:

  • Search for remote opportunities with specific skill requirements and experience levels
  • Filter jobs by posting date to find the most recent openings in your field
  • Compare job requirements and qualifications across different employers and locations

Recruitment and Talent Acquisition:

  • Monitor competitor hiring patterns and job postings for market intelligence
  • Analyze job descriptions and requirements to understand industry standards
  • Track employment type trends (full-time, contract, part-time) across different sectors

Employment Analytics:

  • Aggregate job data across multiple pages for comprehensive market analysis
  • Study geographic distribution of jobs using location coordinates and filters
  • Analyze job benefits and company offerings to benchmark compensation packages