Jobily Jobs

List Greek locations (regions and cities) with the slugs accepted by search_jobs' location filter. Pass a query to narrow by name — it is typo-tolerant and accepts Greek, English and greeklish (e.g. 'thesaloniki', 'αθηνα', 'chania'); the full tree is large.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional fuzzy filter matched against location names, Greek/English/greeklish, e.g. 'athens', 'κρήτη', 'thesaloniki'.",
      "type": "string",
      "default": null
    }
  }
}

Get the full posting of a job on Jobily.gr by its guid (from search_jobs results): plain-text description, structured sections (responsibilities, experience, must-have skills, education, benefits), how to apply, and the company logo URL. status is 'ok', 'gone' (job closed) or 'not_found'.

{
  "type": "object",
  "properties": {
    "guid": {
      "description": "The job's GUID, e.g. from a search_jobs result.",
      "type": "string"
    },
    "language": {
      "description": "Language of the structured sections: 'en' (default) or 'el' (Greek).",
      "type": "string",
      "default": "en"
    }
  },
  "required": [
    "guid"
  ]
}

List the job sectors of Jobily.gr with the slugs accepted by search_jobs' sector filter.

{
  "type": "object",
  "properties": {}
}

Typeahead over job roles and companies on Jobily.gr. Returns up to 7 role and 7 company suggestions whose slugs feed the role/company filters of search_jobs. Works with Greek, English and greeklish input (min 2 characters).

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Partial role or company name, Greek or English (min 2 characters), e.g. 'προγραμ', 'account'.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Search job listings on Jobily.gr, the Greek job board. Filter by free-text term, role/location/sector slugs, company, employment type, workplace type and work time. Use lookup_roles_and_companies, lookup_locations and list_sectors to discover valid slugs — unrecognized slug filters are reported in matchedCriteria.unrecognizedTerms and ignored by the search. Returns up to 20 jobs per page with the total count, facet counts (first page) and recovery suggestions when nothing matches. Search results do not include job descriptions — call get_job with a result's guid for the full posting. When total is large (100+) and few filters are active, recommend the user narrow their search using the facets or lookup tools rather than paginating through hundreds of results.

{
  "type": "object",
  "properties": {
    "searchTerm": {
      "description": "Free-text search term, Greek or English (e.g. 'πωλητής', 'software engineer'). Prefer the role filter when a role slug is known.",
      "type": "string",
      "default": null
    },
    "role": {
      "description": "Role slug, e.g. 'software-engineer'. Discover via lookup_roles_and_companies.",
      "type": "string",
      "default": null
    },
    "location": {
      "description": "Location slug, e.g. 'athens', 'thessaloniki'. Discover via lookup_locations. Omit for all of Greece.",
      "type": "string",
      "default": null
    },
    "sector": {
      "description": "Sector slug, e.g. 'information-technology-it'. Discover via list_sectors.",
      "type": "string",
      "default": null
    },
    "company": {
      "description": "Company slug (from lookup_roles_and_companies) or company GUID.",
      "type": "string",
      "default": null
    },
    "employmentType": {
      "description": "One of: permanent, contract, internship, seasonal, volunteer.",
      "type": "string",
      "default": null
    },
    "workplaceType": {
      "description": "One of: remote, hybrid, onsite.",
      "type": "string",
      "default": null
    },
    "workTimeType": {
      "description": "One of: full-time, part-time.",
      "type": "string",
      "default": null
    },
    "page": {
      "description": "Page number, 1-indexed (default 1). Each page returns up to 20 jobs.",
      "type": "integer",
      "default": 1
    }
  }
}