get_categories
Retrieve valid job category tags for a specific country to use as parameters in job searches, ensuring accurate filtering by profession.
Instructions
Get valid job category tags for a specific country.
PURPOSE: Use this BEFORE search_jobs to get valid 'category' parameter values. Category tags are COUNTRY-SPECIFIC - always use the same country code here as you will in search_jobs.
Args: country: ISO 3166-1 alpha-2 country code. Supported: "gb", "us", "de", "fr", "au", "nz", "ca", "in", "pl", "br", "at", "za"
Returns: dict: Contains "results" array of category objects: - tag: Use THIS value in search_jobs category parameter (e.g., "it-jobs") - label: Human-readable name for display (e.g., "IT Jobs")
Common category tags (vary by country): - "it-jobs": Technology, software, IT support - "engineering-jobs": Mechanical, electrical, civil - "finance-jobs": Accounting, banking, financial services - "sales-jobs": Sales, business development - "healthcare-nursing-jobs": Medical, nursing - "admin-jobs": Administration, office support - "marketing-jobs": Marketing, PR, communications
Example response: { "results": [ {"tag": "it-jobs", "label": "IT Jobs"}, {"tag": "engineering-jobs", "label": "Engineering Jobs"}, {"tag": "finance-jobs", "label": "Accounting & Finance Jobs"} ] }
Usage: categories = get_categories("gb") search_jobs(country="gb", category="it-jobs") # Use tag, not label
Errors: - Invalid country code: "API Error 400: Invalid country" - Rate limit exceeded: "API Error 429: Too many requests" - Authentication failure: "API Error 401: Invalid credentials"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes |