Validate Job Posting Schema
seo.validate_job_posting_schema
Overview
Validate JobPosting nodes including dated posting freshness. We never fetch a URL, run a script, or choose a winner. A successful call costs 1 execution credit.
JobPosting checks are on the graph you send.
Reliability
seo.validate_job_posting_schema is stable for identical input. Identical input always produces identical JSON. SEO_INPUT_REQUIRED means a required field is missing or has the wrong shape, so send the published object rather than a guessed map; retrying unchanged will not help. SEO_INPUT_TOO_LARGE means a value exceeds its ceiling, so trim it. SEO_HTML_MALFORMED means the HTML could not be parsed under the offline HTML contract, so fix the markup. SEO_XML_MALFORMED means the XML is not well-formed, so correct it. SEO_XML_DOCTYPE_NOT_ALLOWED means the XML includes a DOCTYPE declaration, so strip the DOCTYPE and resend; we refuse DTDs rather than expanding entities. SEO_JSONLD_MALFORMED means a JSON-LD block is not usable JSON, so correct it. SEO_PROFILE_UNKNOWN means the named profile is not bundled, so send one of the published profile ids. SEO_TOO_MANY_RECORDS means a list exceeded its ceiling, so split the batch. SEO_GRAPH_LIMIT_EXCEEDED means the graph exceeded its node or edge ceiling, so shrink it. SEO_INVALID_URL means a URL string is not a usable RFC 3986 URI, so send an absolute URI. SEO_OBSERVATION_INCOMPLETE means required observation coverage is missing, so add the missing evidence. SEO_INPUT_CONFLICT means two fields that cannot be used together were both supplied, so drop one. Retrying an unchanged request will not help.
Context footprint
Returns a compact structured record. A successful call costs 1 execution credit.
When to use it
When JobPosting JSON-LD plus a hiring reference time are already held and you need hiringOrganization, title, and datePosted — not Event dates.
When you want to post the job, or the graph still needs extracting.
Scope
Non-goals
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not fetch or publish jobs
Properties
Capabilities
Cost & billing
Flat rate per invocation
File handling
How we handle your data
What this means
This skill may receive sensitive content and may return submitted, transformed, extracted, or reformatted content.
Squillify guarantees
- Runs inside Squillify
- This skill runs inside Squillify.
- Payloads are not sent to an external service by this skill.
- Squillify does not permanently store submitted payloads.
- Telemetry records metadata only, not submitted content.
- Submitted payloads are not used for training.
- Submitted payloads are not reviewed by humans.
- This skill does not target sensitive data.
- The response may contain submitted or transformed content.
Your responsibility
Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.
Input schema
| Field | Type | Required | Description |
|---|---|---|---|
| graph | array | Yes | Required. Closed array 'graph' with named properties or bounded items used by this skill, up to 10,000 entries or 64 properties. |
| visibleFacts | object | No | Visible page facts keyed by field name such as name, price, currency, or availability. At most 64 facts. Omit this map when you have no visible facts and we skip visible-content comparison. |
| referenceTime | string | No | The referenceTime value for this offline analysis, up to 1 MiB. Omit it and we apply the published default for referenceTime. |
Output schema
| Field | Type | Required | Description |
|---|---|---|---|
| profile | string | Yes | Required. Structured 'profile' value produced by this offline analysis. |
| syntaxValid | boolean | Yes | Required. Structured 'syntaxValid' value produced by this offline analysis. |
| vocabularyValid | boolean | Yes | Required. Structured 'vocabularyValid' value produced by this offline analysis. |
| eligibleByDeclaredRules | boolean | Yes | Required. Structured 'eligibleByDeclaredRules' value produced by this offline analysis. |
| requiredFindings | array | Yes | Required. Structured 'requiredFindings' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| recommendedFindings | array | Yes | Required. Structured 'recommendedFindings' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| consistencyFindings | array | Yes | Required. Structured 'consistencyFindings' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| richResultGuarantee | boolean | Yes | Required. Structured 'richResultGuarantee' value produced by this offline analysis. |
| type | string | Yes | Required. Structured 'type' value produced by this offline analysis. |
| nodes | array | Yes | Required. Structured 'nodes' value. Objects expose named properties; arrays list bounded rows or strings produced from the supplied artifacts, up to 10,000 entries. |
| effectiveDate | string | Yes | Required. Structured 'effectiveDate' value produced by this offline analysis. |
| referenceTime | string | Yes | Required. Structured 'referenceTime' value produced by this offline analysis. |
API contract
POST /v1/executecurl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"seo.validate_job_posting_schema","input":{"graph":[{"datePosted":"2026-08-01","description":"Build skills","hiringOrganization":"Acme","title":"Engineer","type":"JobPosting"}],"referenceTime":"2026-08-19"}}'import { Squillify } from "@squillify/sdk";
const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });
const { output } = await sq.execute("seo.validate_job_posting_schema", {"graph":[{"datePosted":"2026-08-01","title":"Engineer","description":"Build skills","type":"JobPosting","hiringOrganization":"Acme"}],"referenceTime":"2026-08-19"});Errors
| Code | HTTP | Retryable | Description |
|---|---|---|---|
| VALIDATION_ERROR | 400 | No | The request payload failed schema validation. |
| UNAUTHORIZED | 401 | No | Missing or invalid API key. |
| SKILL_NOT_ACCESSIBLE | 403 | No | The API key is not granted access to this skill. |
| SKILL_NOT_AVAILABLE_FOR_PLAN | 403 | No | This skill is not included in your current plan. |
| PLAN_ELIGIBILITY_UNAVAILABLE | 503 | Yes | Plan eligibility could not be decided. Retry after backoff. |
| SKILL_NOT_FOUND | 404 | No | The requested skill or version does not exist. |
| TENANT_RATE_LIMITED | 429 | Yes | Request rate limit exceeded. Retry after backoff. |
| QUOTA_EXCEEDED | 429 | Yes | Plan quota exhausted. Retryable once the quota period resets. |
| EXECUTION_TIMEOUT | 504 | Yes | Execution exceeded the allowed time budget. |
| SEO_INPUT_REQUIRED | 400 | No | The request payload failed this skill's input validation. |
| SEO_INPUT_TOO_LARGE | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_HTML_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_XML_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_XML_DOCTYPE_NOT_ALLOWED | 400 | No | The request payload failed this skill's input validation. |
| SEO_JSONLD_MALFORMED | 400 | No | The request payload failed this skill's input validation. |
| SEO_PROFILE_UNKNOWN | 400 | No | The request payload failed this skill's input validation. |
| SEO_TOO_MANY_RECORDS | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_GRAPH_LIMIT_EXCEEDED | 429 | No | A size, quota, rate, or time limit was exceeded. |
| SEO_INVALID_URL | 400 | No | The request payload failed this skill's input validation. |
Other limits
| Limit | Value |
|---|---|
| Recommended inline bytes | 32 KiB |
Limitations
- Does not fetch a URL, resolve DNS, or run a browser
- Does not predict ranking, choose a winner, or claim live index status
- Does not fetch or publish jobs
- Fetching the page
- Posting the job
How to call
POST /v1/execute (requires authentication)
{
"skillKey": "seo.validate_job_posting_schema",
"input": {
"graph": [
{
"datePosted": "2026-08-01",
"title": "Engineer",
"description": "Build skills",
"type": "JobPosting",
"hiringOrganization": "Acme"
}
],
"referenceTime": "2026-08-19"
}
}Examples
Primary business path
{
"graph": [
{
"datePosted": "2026-08-01",
"title": "Engineer",
"description": "Build skills",
"type": "JobPosting",
"hiringOrganization": "Acme"
}
],
"referenceTime": "2026-08-19"
}{
"richResultGuarantee": false,
"requiredFindings": [],
"consistencyFindings": [],
"type": "JobPosting",
"recommendedFindings": [
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "validThrough",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field validThrough is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
},
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "jobLocation",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field jobLocation is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
},
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "baseSalary",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field baseSalary is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
}
],
"vocabularyValid": true,
"eligibleByDeclaredRules": true,
"effectiveDate": "2026-08-01",
"referenceTime": "2026-08-19",
"profile": "seo.google.job.posting@1",
"syntaxValid": true,
"nodes": [
{
"datePosted": "2026-08-01",
"title": "Engineer",
"description": "Build skills",
"type": "JobPosting",
"hiringOrganization": "Acme"
}
]
}Boundary or option path
{
"graph": [
{
"datePosted": "2020-01-01",
"title": "Engineer",
"description": "Build skills",
"type": "JobPosting",
"hiringOrganization": "Acme"
}
],
"referenceTime": "2026-08-19"
}{
"richResultGuarantee": false,
"requiredFindings": [
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "2020-01-01",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Date field datePosted is stale versus the profile.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.stale",
"severity": "WARNING",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
}
],
"consistencyFindings": [],
"type": "JobPosting",
"recommendedFindings": [
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "validThrough",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field validThrough is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
},
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "jobLocation",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field jobLocation is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
},
{
"certainty": "POLICY_RESULT",
"evidence": [
{
"actual": "baseSalary",
"artifactId": "input",
"path": "JobPosting"
}
],
"message": "Recommended field baseSalary is missing.",
"profile": {
"checksumSha256": "0b89d8a2e58b1dec8b09f5db49c0139f409d20b71482f63140df81243f2a46b2",
"id": "seo.google.job.posting@1"
},
"ruleId": "jobposting.recommended",
"severity": "INFO",
"subject": {
"id": "JobPosting",
"type": "JobPosting"
}
}
],
"vocabularyValid": true,
"eligibleByDeclaredRules": false,
"effectiveDate": "2026-08-01",
"referenceTime": "2026-08-19",
"profile": "seo.google.job.posting@1",
"syntaxValid": true,
"nodes": [
{
"datePosted": "2020-01-01",
"title": "Engineer",
"description": "Build skills",
"type": "JobPosting",
"hiringOrganization": "Acme"
}
]
}Recommended use cases
- Flag a JobPosting without hiringOrganization
- Flag a stale datePosted against the reference time
Avoid for
- Fetching the page
- Posting the job
Related skills
Composable with
Safety & privacy
- Runs without calling any external service.
- Your payloads are never stored permanently.
- Telemetry captures metadata only — never your payload contents.
- We never train models on your payloads.
- No human reviews your payloads.