Search job boards now
start_radar_scanStart a job radar scan: search job boards for vacancies matching the user's active resume. Runs asynchronously — returns a task_id immediately; the scan takes up to a minute, then get_radar_matches shows the results and get_radar_status.last_scan_at says whether it brought anything in (a scan that found nothing new leaves it as it was); get_task_status(task_id) reports progress and the outcome. Calling it while a scan is already running returns the same task_id (no double scan). Consumes one radar scan from the user's plan quota — several a day on a paid plan, one a week on the free plan, where the morning's automatic scan counts too; the account's first scan ever is not counted, and neither is a scan with changed filters after one that found nothing, while the account has never had a match. Returns 'not_found' if the user has no resume yet, 'role_unknown' when nothing names the role to search for (no role in the radar filters or career memory, no title, position or skills on the resume; set_radar_filters stores a role), and 'limit_exceeded' when the quota is spent; get_radar_status.next_scan_at then says when a free user's weekly scan comes back. The same search as the last scan (same role, place and filters on the same resume) within an hour of it starts nothing and spends nothing: it returns 'recent_scan' with the minutes since that scan and when the same search can run again; a search with other filters (set_radar_filters) starts at once.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | processing | |
| task_id | Yes |