Recommend jobs for my profile
jobs_recommendationsReturns the authenticated user's personalized job recommendations built from their resume, skills,
target roles, and preferred location. Results are ranked by fit, may include related roles, and carry
the same salary, match, H-1B, and job-trust insight payload used by job search, with those FoundRole
figures attributed once per response in figureSources (source, basis per
kind of figure and methodologyUrl); a false h1bSponsor or eVerify means no record was found, not that
the employer does not sponsor. The search filters
and sort parameters apply to this personalized feed too. One call returns one answer: there is no
next page, and the response links to the same feed on the FoundRole website.
An explicit query for a different or unrecognized profession uses the same general job search as
jobs_search, preserving the query and filters instead of substituting the profile's target roles.
Without a location the feed covers the place saved on the account. It covers that place's whole
country instead when the country holds more jobs of the account's role than the place does, or when
the role has no job in the place or the country and few jobs of any kind are posted near the place;
the latter shows related roles. The response names the place the feed shows as searchedPlace. A named location is never widened. coverage carries the
counts of the role's jobs near the account's place and posted in its country. Its remoteOpenToCountry counts the role's jobs
the feed holds with no posting near the place, whether remote, country-wide or regional, so that count does not mean they are remote.
A processing status means the personalized feed is still being prepared; a later call returns the completed feed.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "jobs_recommendations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Result order (score, posted_at, match, salary): score is relevance to the query and the order of every request that sets no sort; posted_at orders by posting date and does not rank by fit to the query; salary is highest pay first; match is best personal fit first and needs a resume. Ordering by salary or match is an advanced option. | |
| query | No | The full job title or skill (e.g., "Ruby Developer", NOT just "Ruby") | |
| radius | No | Search radius in miles around a city location (default 40); not used for state, country or remote searches. | |
| remote | No | Advanced filter: only remote-eligible jobs, matched across the whole country of the requested location rather than its radius. | |
| company | No | The official company name, or the domain of one employer | |
| benefits | No | Advanced filter: benefit names such as "health insurance", "401k" or "parental leave"; a job qualifies only when it states every listed benefit. Names that match no known benefit are ignored. | |
| location | No | Geographic location (e.g., 'Boston, MA') | |
| companies | No | Filter: official company names; a job from any of them qualifies, across every job board each employer posts on. More than one company makes it an advanced filter. Next to company, a job has to match both; hiring_brand narrows company only. | |
| education | No | Filter: jobs whose posting requires one of these education levels (no_requirements, high_school, associate_degree, bachelor_degree, professional_certificate, postgraduate_degree); bachelor_degree means the posting asks for a bachelor degree, not that it suits someone holding one. | |
| min_match | No | Advanced filter: lowest personal FoundRole match grade to keep, the same letter each job shows in insights.match.grade. A and A- are rare even for a strong resume; B keeps good and strong matches; C+ also keeps fair ones. Needs a resume on the account. | |
| work_modes | No | Advanced filter: jobs in any of these work modes (on_site, remote, hybrid). remote is matched across the whole country of the location, the others within the radius. ["remote"] is the same search as remote: true. | |
| bonuses_only | No | Advanced filter: only jobs that state a bonus (sign-on, performance, referral, commission and the like). | |
| hiring_brand | No | Filter: one brand inside the company, for example company "Google" with hiring_brand "YouTube"; used only together with company. | |
| salary_floor | No | Advanced filter: minimum annualized salary in USD; a posting qualifies when the lower bound of its pay band reaches the floor. Jobs without a USD salary are dropped. | |
| posted_days_ago | No | Posting window in days (1-365): every job posted earlier than that many days ago is removed from the answer, so a narrow window can leave the answer empty. | |
| employment_types | No | Filter: jobs offered as any of these employment types (full_time, part_time, contractor, temporary, intern, volunteer, per_diem, other). | |
| exclude_companies | No | Advanced filter: official company names whose jobs are removed from the results, across every job board each employer posts on. | |
| experience_levels | No | Filter: jobs at any of these experience levels (entry_level, mid_level, senior_level, executive, level_not_stated). The level comes from the years of experience the posting asks for and the seniority in its title, the higher of the two; entry_level never includes a posting asking for more than two years. level_not_stated selects jobs whose level cannot be derived; it can be selected alone or alongside other levels. | |
| h1b_sponsors_only | No | Advanced filter: only companies known to sponsor H1B visas. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | No | ||
| guide | No | ||
| preview | No | ||
| coverage | No | ||
| feedKind | No | ||
| widening | No | ||
| savedRole | No | ||
| feedStatus | No | ||
| totalCount | No | ||
| continueUrl | No | ||
| jobSearchId | No | ||
| resultSetId | No | ||
| statusOrder | No | ||
| revalidating | No | ||
| figureSources | No | ||
| resultBatchId | No | ||
| searchedPlace | No | ||
| trackerWebUrl | No | ||
| profileSetupUrl | No | ||
| appliedConditions | No | ||
| profileSetupState | No | ||
| lowRelevanceNotice | No |