Voxjobs (Portugal)

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Slug of the reference listing, as returned by search_jobs or get_job_detail.'}, 'limit': {'type': 'number', 'description': 'Maximum number of comparables (default 6, max 20).'}}}

{'type': 'object', 'required': ['market', 'reference', 'total', 'jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'url', 'title', 'salary'], 'properties': {'url': {'type': 'string', 'description': "Canonical listing page on this market's domain."}, 'city': {'type': ['string', 'null']}, 'slug': {'type': 'string', 'description': 'Stable identifier; pass to get_job_detail or find_similar_jobs.'}, 'title': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'salary': {'type': 'object', 'required': ['currency', 'isEstimated'], 'properties': {'max': {'type': ['number', 'null']}, 'min': {'type': ['number', 'null']}, 'period': {'type': ['string', 'null'], 'description': 'YEAR, MONTH, WEEK, DAY or HOUR.'}, 'currency': {'type': 'string'}, 'isEstimated': {'type': 'boolean'}}, 'description': "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."}, 'company': {'type': ['string', 'null']}, 'postedAt': {'type': ['string', 'null'], 'description': 'ISO 8601 date the listing was first published at the source.'}, 'seniority': {'enum': ['INTERNSHIP', 'JUNIOR', 'MID', 'SENIOR', 'LEAD', 'EXECUTIVE', None], 'type': ['string', 'null']}, 'lastSeenAt': {'type': ['string', 'null'], 'description': "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."}, 'remoteMode': {'enum': ['REMOTE', 'HYBRID', 'ONSITE', None], 'type': ['string', 'null']}, 'contractType': {'type': ['string', 'null']}, 'qualityScore': {'type': ['number', 'null'], 'description': 'Internal freshness/quality signal (0..1). Higher = better.'}}}}, 'total': {'type': 'number', 'description': 'Comparables returned.'}, 'market': {'type': 'string'}, 'currency': {'type': 'string'}, 'reference': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': "Canonical listing page on this market's domain."}, 'city': {'type': ['string', 'null']}, 'slug': {'type': 'string', 'description': 'Stable identifier; pass to get_job_detail or find_similar_jobs.'}, 'title': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'salary': {'type': 'object', 'required': ['currency', 'isEstimated'], 'properties': {'max': {'type': ['number', 'null']}, 'min': {'type': ['number', 'null']}, 'period': {'type': ['string', 'null'], 'description': 'YEAR, MONTH, WEEK, DAY or HOUR.'}, 'currency': {'type': 'string'}, 'isEstimated': {'type': 'boolean'}}, 'description': "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."}, 'company': {'type': ['string', 'null']}, 'postedAt': {'type': ['string', 'null'], 'description': 'ISO 8601 date the listing was first published at the source.'}, 'seniority': {'enum': ['INTERNSHIP', 'JUNIOR', 'MID', 'SENIOR', 'LEAD', 'EXECUTIVE', None], 'type': ['string', 'null']}, 'lastSeenAt': {'type': ['string', 'null'], 'description': "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."}, 'remoteMode': {'enum': ['REMOTE', 'HYBRID', 'ONSITE', None], 'type': ['string', 'null']}, 'contractType': {'type': ['string', 'null']}, 'qualityScore': {'type': ['number', 'null'], 'description': 'Internal freshness/quality signal (0..1). Higher = better.'}}, 'description': 'The listing the comparables are measured against, echoed back for the comparison.'}}}

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Unique listing slug, as returned by search_jobs.'}}}

{'type': 'object', 'required': ['slug', 'url', 'title', 'status', 'closed', 'country', 'salary'], 'properties': {'url': {'type': 'string'}, 'city': {'type': ['string', 'null']}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'closed': {'type': 'boolean', 'description': 'true when the listing is EXPIRED or REMOVED at the source — recommend it and the user applies for a dead post.'}, 'region': {'type': ['string', 'null']}, 'salary': {'type': 'object', 'properties': {'max': {'type': ['number', 'null']}, 'min': {'type': ['number', 'null']}, 'period': {'type': ['string', 'null']}, 'isGross': {'type': ['boolean', 'null']}, 'currency': {'type': 'string'}, 'isEstimated': {'type': 'boolean'}}}, 'status': {'type': 'string'}, 'company': {'type': ['object', 'null'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'sector': {'type': ['string', 'null']}, 'websiteDomain': {'type': ['string', 'null']}}}, 'country': {'type': 'string'}, 'applyUrl': {'type': ['string', 'null'], 'description': 'Outbound URL. Fallback to sourceUrl when the ATS did not publish a separate apply link.'}, 'postedAt': {'type': ['string', 'null']}, 'schedule': {'type': ['string', 'null']}, 'seniority': {'type': ['string', 'null']}, 'sourceUrl': {'type': ['string', 'null']}, 'experience': {'type': ['string', 'null']}, 'remoteMode': {'type': ['string', 'null']}, 'description': {'type': 'string'}, 'contractType': {'type': ['string', 'null']}, 'employerName': {'type': ['string', 'null']}, 'publicSector': {'type': 'boolean'}, 'qualityScore': {'type': ['number', 'null']}, 'validThrough': {'type': ['string', 'null']}, 'educationLevel': {'type': ['string', 'null']}, 'lastVerifiedAt': {'type': ['string', 'null']}, 'sourcePlatform': {'type': ['string', 'null']}, 'languagesRequired': {'type': 'array', 'items': {'type': 'string'}}, 'positionsAvailable': {'type': ['number', 'null']}}}

{'type': 'object', 'properties': {'escoCode': {'type': 'string', 'description': 'ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text.'}, 'location': {'type': 'string', 'description': 'City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host.'}, 'schedule': {'enum': ['FULL_TIME', 'PART_TIME', 'SHIFTS', 'FLEXIBLE'], 'type': 'string', 'description': 'Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE.'}, 'seniority': {'enum': ['INTERNSHIP', 'JUNIOR', 'MID', 'SENIOR', 'LEAD', 'EXECUTIVE'], 'type': 'string', 'description': 'Level of the role.'}, 'remoteMode': {'enum': ['REMOTE', 'HYBRID', 'ONSITE'], 'type': 'string', 'description': 'Work arrangement. REMOTE, HYBRID or ONSITE.'}, 'contractType': {'type': 'string', 'description': 'Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę).'}}}

{'type': 'object', 'required': ['market', 'currency', 'count', 'priced', 'bySeniority'], 'properties': {'count': {'type': 'number', 'description': 'Listings matching the filters, with or without a published salary.'}, 'market': {'type': 'string'}, 'priced': {'type': 'number', 'description': 'Subset that publishes a salary — the base of every figure below. A large gap to `count` means many listings in this slice hide compensation.'}, 'salary': {'type': ['object', 'null'], 'properties': {'p10': {'type': 'number'}, 'p25': {'type': 'number'}, 'p75': {'type': 'number'}, 'p90': {'type': 'number'}, 'median': {'type': 'number', 'description': "The typical salary — use this to answer 'how much'."}}, 'description': 'Yearly salary distribution, in percentiles. null when no matching listing publishes a salary. There is deliberately no min or max: extremes on a third-party aggregator are set by data errors, not the market.'}, 'currency': {'type': 'string'}, 'bySeniority': {'type': 'array', 'items': {'type': 'object', 'required': ['seniority', 'count', 'priced'], 'properties': {'count': {'type': 'number', 'description': 'Listings at this seniority.'}, 'priced': {'type': 'number', 'description': 'How many of those disclose a salary — this, not `count`, is the sample behind `medianSalary`. Most listings do not disclose one, so quote it as the sample size.'}, 'seniority': {'type': 'string'}, 'medianSalary': {'type': ['number', 'null']}}}, 'description': 'Up to 6 most represented seniority levels, each with its own median.'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Maximum number of results (default 5, max 10).'}, 'query': {'type': 'string', 'description': 'Free-text topic (optional). Empty → the most recent articles.'}}}

{'type': 'object', 'required': ['market', 'articles'], 'properties': {'market': {'type': 'string'}, 'articles': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'title', 'url'], 'properties': {'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'excerpt': {'type': 'string'}, 'category': {'type': 'string'}}}}}}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Full or partial employer name.'}, 'limit': {'type': 'number', 'description': 'Maximum number of results (default 8, max 20).'}, 'sector': {'type': 'string', 'description': 'Sector (e.g. technology, healthcare, retail).'}}}

{'type': 'object', 'required': ['market', 'total', 'companies'], 'properties': {'total': {'type': 'number'}, 'market': {'type': 'string'}, 'companies': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'url', 'activeJobs'], 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'sector': {'type': ['string', 'null']}, 'activeJobs': {'type': 'number'}, 'sizeBucket': {'type': ['string', 'null']}, 'headquarters': {'type': ['string', 'null']}}}}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Maximum number of results (default 10, max 20).'}, 'query': {'type': 'string', 'description': "Free-text semantic hint: job title, skills or field (e.g. 'data engineer', 'react developer', 'marketing manager'). Ranks results by meaning; combine with structural filters."}, 'company': {'type': 'string', 'description': 'Restrict to jobs from this employer (free-text name).'}, 'escoCode': {'type': 'string', 'description': 'ESCO occupation code (see europa.eu/esco). Optional and precise: when the caller has one, it filters much more sharply than free text.'}, 'location': {'type': 'string', 'description': 'City or region within the market (e.g. Lisbon, Porto, Berlin). Do not include the country — it is set by the host.'}, 'schedule': {'enum': ['FULL_TIME', 'PART_TIME', 'SHIFTS', 'FLEXIBLE'], 'type': 'string', 'description': 'Hours: FULL_TIME, PART_TIME, SHIFTS or FLEXIBLE.'}, 'seniority': {'enum': ['INTERNSHIP', 'JUNIOR', 'MID', 'SENIOR', 'LEAD', 'EXECUTIVE'], 'type': 'string', 'description': 'Level of the role.'}, 'remoteMode': {'enum': ['REMOTE', 'HYBRID', 'ONSITE'], 'type': 'string', 'description': 'Work arrangement. REMOTE, HYBRID or ONSITE.'}, 'contractType': {'type': 'string', 'description': 'Contract type in market-local vocabulary (e.g. permanent, CDI, B2B, umowa o pracę).'}, 'salaryMinYearly': {'type': 'number', 'description': 'Minimum gross yearly salary, in the market currency (EUR, GBP or PLN). Non-yearly periods are normalised.'}}}

{'type': 'object', 'required': ['market', 'currency', 'total', 'shown', 'jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'url', 'title', 'salary'], 'properties': {'url': {'type': 'string', 'description': "Canonical listing page on this market's domain."}, 'city': {'type': ['string', 'null']}, 'slug': {'type': 'string', 'description': 'Stable identifier; pass to get_job_detail or find_similar_jobs.'}, 'title': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'salary': {'type': 'object', 'required': ['currency', 'isEstimated'], 'properties': {'max': {'type': ['number', 'null']}, 'min': {'type': ['number', 'null']}, 'period': {'type': ['string', 'null'], 'description': 'YEAR, MONTH, WEEK, DAY or HOUR.'}, 'currency': {'type': 'string'}, 'isEstimated': {'type': 'boolean'}}, 'description': "Salary as published by the source. `isEstimated` flags model-inferred figures; the network's rule is to never hide gross/net."}, 'company': {'type': ['string', 'null']}, 'postedAt': {'type': ['string', 'null'], 'description': 'ISO 8601 date the listing was first published at the source.'}, 'seniority': {'enum': ['INTERNSHIP', 'JUNIOR', 'MID', 'SENIOR', 'LEAD', 'EXECUTIVE', None], 'type': ['string', 'null']}, 'lastSeenAt': {'type': ['string', 'null'], 'description': "ISO 8601 timestamp when this listing was last confirmed still live at the source. Sources expire listings without notice, so this — not postedAt — is the answer to 'is this still open?'."}, 'remoteMode': {'enum': ['REMOTE', 'HYBRID', 'ONSITE', None], 'type': ['string', 'null']}, 'contractType': {'type': ['string', 'null']}, 'qualityScore': {'type': ['number', 'null'], 'description': 'Internal freshness/quality signal (0..1). Higher = better.'}}}}, 'shown': {'type': 'number'}, 'total': {'type': 'number', 'description': 'Exact number of listings matching the filters.'}, 'market': {'type': 'string'}, 'currency': {'type': 'string'}}}