indeed-salary

Focused salary skill. Use only when the user explicitly asks what a job posting pays.

When to use this skill

DO use when the user asks:

• "What does this job pay?" (with an Indeed link)
• "Look up the salary for job key a1b2c3d4e5f60718"
• "Is that nurse posting's salary from the employer or an estimate?"
• "Compare pay on these three postings"

Do NOT use when:

• The user asks about market-wide or average salaries rather than a specific posting
• A posting appears incidentally in context
• You also need the description, company, or benefits. Use indeed-full instead, it bundles everything in one install.

Setup

Set ROLESAPI_KEY to your RolesAPI key (format rk_live_...). Create one at https://rolesapi.com/app/keys. The free plan includes 100 credits at signup, no card required.

export ROLESAPI_KEY="rk_live_..."

Scripts

get_salary.py (1 credit)

Accepts either a 16-character job key or a pasted Indeed viewjob URL.

python3 scripts/get_salary.py 7dcf172c8d7fc756
python3 scripts/get_salary.py "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
python3 scripts/get_salary.py 7dcf172c8d7fc756 --country gb

Real output (job key path):

{
  "data": {
    "title": "Nursing",
    "company": {
      "name": "Golden Healthcare Services Inc"
    },
    "location": "Olympia Fields, IL 60461",
    "salary": {
      "min": 30,
      "max": 45,
      "period": "hour",
      "source": "employer",
      "currency": "USD"
    }
  },
  "request_id": "a18e4fa32b51ce3e"
}

source is employer when the figure comes from the posting itself and estimated when it is an Indeed estimate. Postings with no salary information omit the salary key.

Pricing

One credit per lookup. Failed calls are not charged. Full pricing: https://rolesapi.com/pricing/.

Trademark

RolesAPI is an independent service and is not affiliated with, endorsed by, or sponsored by Indeed. "Indeed" is a trademark of its owner.