Top Jobs Australia
Top Jobs Australia · Actions GPT
Recruitment assistant for finding matching candidates and job listings
POST /candidates/searchfind_matchUse this action to find candidates based on a keyword and location.
POST /jobs/searchfind_job_listingsUse this action to find job listings based on a keyword and location.
POST /seek/send-querysend_seek_queryUse this action to query SEEK jobs with multiple filters.
POST /content/search/stringsearch_contentUse this action to search for content based on a query string.
Schéma original API
{
"openapi": "3.1.0",
"info": {
"title": "Recruitment assistant for finding matching candidates and job listings",
"version": "1.0.0"
},
"servers": [
{
"url": "https://topcandidates.com.au/api/gpt"
}
],
"paths": {
"/candidates/search": {
"post": {
"operationId": "find_match",
"x-openai-isConsequential": false,
"description": "Use this action to find candidates based on a keyword and location.",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "The keyword to search candidates by (e.g., job title, skill).",
"example": "Node.js Developer"
},
"location": {
"type": "string",
"description": "Optional location to filter candidates by (e.g., city or state).",
"example": "Brisbane"
}
}
}
}
}
},
"responses": {
"200": {
"description": "A list of matching candidates.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to view the candidate profile.",
"example": "https://topcandidates.com.au/candidate/57"
},
"title": {
"type": "string",
"description": "The candidate's job title.",
"example": "Senior Developer"
},
"description": {
"type": "string",
"description": "A brief description of the candidate's profile.",
"example": "Highly personable full stack developer with 7+ years experience..."
},
"experience": {
"type": "string",
"description": "The candidate's years of experience.",
"example": "7+ Years"
},
"city": {
"type": "string",
"description": "The candidate's city.",
"example": "Brisbane"
},
"state": {
"type": "string",
"description": "The candidate's state.",
"example": "Queensland"
},
"skills": {
"type": "string",
"description": "A semicolon-separated list of the candidate's skills.",
"example": ".NET;Node.js;C#;PHP"
},
"salary_expectations": {
"type": "string",
"description": "The candidate's expected salary.",
"example": "130000"
},
"availability": {
"type": "string",
"description": "The candidate's availability period.",
"example": "2 Weeks"
},
"video": {
"type": "string",
"description": "A URL to the candidate's video profile.",
"example": "https://cdn.shotstack.io/au/v1/qbh93r46je/205c20b8-0dba-4747-993b-e93c53c5473b.mp4"
},
"last_updated": {
"type": "string",
"format": "date-time",
"description": "The last time the candidate's profile was updated.",
"example": "2023-01-09T03:45:43.429000Z"
},
"contact": {
"type": "string",
"format": "string",
"description": "Contact the Recruitment Manager.",
"example": "Contact Mike at mike@mikeleembruggen.com"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid Query Parameter"
},
"500": {
"description": "Internal Server Error"
}
}
}
},
"/jobs/search": {
"post": {
"operationId": "find_job_listings",
"x-openai-isConsequential": false,
"description": "Use this action to find job listings based on a keyword and location.",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "The keyword to search job listings by (e.g., job title, company name).",
"example": "Software Engineer"
},
"location": {
"type": "string",
"description": "Optional location to filter job listings by (e.g., city or state).",
"example": "Sydney"
}
}
}
}
}
},
"responses": {
"200": {
"description": "A list of matching job listings.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"job_listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to view the job listing.",
"example": "https://www.seek.com.au/job/76082312"
},
"title": {
"type": "string",
"description": "The job listing title.",
"example": "Senior Software Engineer"
},
"listing_date": {
"type": "string",
"format": "date-time",
"description": "The date the job listing was created.",
"example": "2023-09-18T09:35:31Z"
},
"location": {
"type": "string",
"description": "The location of the job listing.",
"example": "Sydney"
},
"advertiser_description": {
"type": "string",
"description": "A description of the advertiser.",
"example": "A fast-growing tech company based in Sydney"
},
"display_type": {
"type": "string",
"description": "The type of display for the job listing (e.g., promoted, standard).",
"example": "promoted"
},
"is_premium": {
"type": "boolean",
"description": "Indicates whether the job listing is premium.",
"example": true
},
"is_stand_out": {
"type": "boolean",
"description": "Indicates whether the job listing is stand-out.",
"example": true
},
"job_location_label": {
"type": "string",
"description": "A label for the job location.",
"example": "Melbourne CBD, VIC"
},
"logo": {
"type": "string",
"description": "URL to the advertiser's logo.",
"example": "https://www.seek.com.au/logos/companylogo.png"
},
"teaser": {
"type": "string",
"description": "A short teaser about the job listing.",
"example": "Exciting opportunity for a senior full-stack developer in a growing tech company."
},
"bullet_points": {
"type": "array",
"description": "Key bullet points for the job listing.",
"items": {
"type": "string"
},
"example": [
"Hybrid work environment",
"Competitive salary"
]
},
"classification_description": {
"type": "string",
"description": "The classification of the job listing.",
"example": "Information Technology"
},
"sub_classification_description": {
"type": "string",
"description": "The sub-classification of the job listing.",
"example": "Developers/Programmers"
},
"work_arrangements": {
"type": "string",
"description": "The work arrangements for the job listing.",
"example": "On-site, Hybrid"
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "The date the job listing was last retrieved.",
"example": "2023-09-18T09:35:31Z"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid Query Parameter"
},
"500": {
"description": "Internal Server Error"
}
}
}
},
"/seek/send-query": {
"post": {
"operationId": "send_seek_query",
"x-openai-isConsequential": false,
"description": "Use this action to query SEEK jobs with multiple filters.",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"keyword"
],
"properties": {
"keyword": {
"type": "string",
"description": "The keyword to search SEEK jobs by.",
"example": "Software Engineer"
},
"location": {
"type": "string",
"description": "Optional location to filter jobs by (e.g., city or state).",
"example": "Sydney"
},
"days": {
"type": "integer",
"description": "Optional number of days to filter jobs (e.g., jobs posted within X days).",
"example": 7
},
"category": {
"type": "string",
"description": "Optional job classification codes, comma-separated.",
"example": "6284,6290"
},
"salary_min": {
"type": "integer",
"description": "Optional minimum salary in AUD.",
"example": 60000
},
"salary_max": {
"type": "integer",
"description": "Optional maximum salary in AUD.",
"example": 120000
},
"salary_type": {
"type": "string",
"description": "Optional type of salary (e.g., annual, hourly).",
"example": "annual"
},
"sort": {
"type": "string",
"enum": [
"date",
"relevance"
],
"description": "Sorting method, either by 'Date' or 'Relevance'.",
"example": "Relevance"
}
}
}
}
}
},
"responses": {
"200": {
"description": "A list of matching SEEK job listings.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"job_listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to view the job listing.",
"example": "https://www.seek.com.au/job/76082312"
},
"title": {
"type": "string",
"description": "The job listing title.",
"example": "Senior Software Engineer"
},
"location": {
"type": "string",
"description": "The location of the job listing.",
"example": "Sydney"
},
"salary": {
"type": "string",
"description": "Salary information.",
"example": "AUD 80,000 - 120,000 annual"
},
"category": {
"type": "string",
"description": "Job category or classification.",
"example": "Information Technology"
},
"posted_at": {
"type": "string",
"format": "date-time",
"description": "The date the job was posted.",
"example": "2023-09-10T14:20:00Z"
}
}
}
}
}
}
}
}
},
"400": {
"description": "Invalid Query Parameter"
},
"500": {
"description": "Internal Server Error"
}
}
}
},
"/content/search/string": {
"post": {
"operationId": "search_content",
"x-openai-isConsequential": false,
"description": "Use this action to search for content based on a query string. \n",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The query string to search for content.",
"example": "Marketing automation strategies"
}
}
}
}
}
},
"responses": {
"200": {
"description": "A list of matching content and information."
},
"400": {
"description": "Invalid Query Parameter"
},
"500": {
"description": "Internal Server Error"
}
}
}
}
}
}