indeed-search

Focused job-search skill. Use only when the user explicitly asks to find job postings matching keywords and a location, not when a job title merely appears in passing.

When to use this skill

DO use when the user asks:

• "Find registered nurse jobs in Chicago"
• "What backend engineer roles were posted today?"
• "Show me remote customer support jobs"
• "Search Indeed for data analyst roles in London"

Do NOT use when:

• A job title or location appears incidentally in context
• The user mentions hiring without asking to search postings
• The user has one specific posting in mind and wants its details. Use indeed-full instead.

Each results page consumes one credit. The preset scripts can fetch up to 3 pages per call, so cap --max-pages for cheap scans.

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

search_listings.py (1 credit per results page)

One page of live postings, synchronous. keyword and location are required.

python3 scripts/search_listings.py "registered nurse" "Chicago, IL"
python3 scripts/search_listings.py "backend engineer" "remote" --sort date
python3 scripts/search_listings.py "data analyst" "London" --country gb

Options: --country (two-letter Indeed edition code, default us), --sort date|relevance.

Real output, trimmed to one of the 35 results:

{
  "data": [
    {
      "job_key": "7dcf172c8d7fc756",
      "title": "Nursing",
      "company": { "name": "Golden Healthcare Services Inc" },
      "location": "Olympia Fields, IL 60461",
      "employment_type": "Full-time",
      "salary": { "min": 30, "max": 45, "period": "hour", "currency": "USD", "source": "employer" },
      "posted_at": "2026-06-26",
      "url": "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
    }
  ],
  "meta": { "count": 35 },
  "request_id": "a18e4ef88ad4b00b"
}

posted_today.py (1 credit per page, up to 3 pages)

Postings from the last 24 hours. --location is optional.

python3 scripts/posted_today.py "registered nurse" --location "Chicago, IL" --max-pages 1

posted_this_week.py (1 credit per page, up to 3 pages)

Postings from the last 7 days.

python3 scripts/posted_this_week.py "product manager" --location "Austin, TX"

remote_roles.py (1 credit per page, up to 3 pages)

Remote postings only. Location optional.

python3 scripts/remote_roles.py "python developer" --max-pages 1

Every result includes a 16-character job_key. Feed it into the indeed-full or indeed-salary scripts for details.

Pricing

One credit equals one search results page. 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.