CVS Health APIcvshealth.com ↗
Search CVS Health job postings by keyword, category, or location. Get full job details including descriptions, employment type, and direct Workday apply links.
What is the CVS Health API?
The CVS Health Jobs API provides 7 endpoints for searching and retrieving job postings from the CVS Health careers site. Use search_jobs to run full-text queries across job titles, descriptions, and locations, or pull structured job details — including HTML description, employment type, posted date, and a direct Workday application URL — with get_job_detail. Results include pagination metadata and up to the full catalog when no filters are applied.
curl -X GET 'https://api.parse.bot/scraper/531043c0-2e3b-44b6-8502-3835f754b446/search_jobs?from=0&limit=25&keywords=pharmacy' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cvshealth-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: CVS Health Careers SDK — search, filter, drill into details."""
from parse_apis.cvs_health_careers_api import CVSHealth, Job, JobSummary, JobNotFound
client = CVSHealth()
# Search for pharmacy jobs — limit caps total items fetched
for summary in client.jobsummaries.search(keywords="pharmacy", limit=3):
print(summary.title, summary.location, summary.category)
# Filter by category
for summary in client.jobsummaries.by_category(category="Corporate", limit=3):
print(summary.title, summary.city, summary.state)
# Filter by location
for summary in client.jobsummaries.by_location(location="Remote", limit=3):
print(summary.title, summary.remote, summary.posted_date)
# Drill into the first result's full details
first = client.jobsummaries.search(keywords="developer", limit=1).first()
if first:
detail = first.details()
print(detail.title, detail.time_type, detail.apply_url)
# Fetch a job directly by ID with typed error handling
try:
job = client.jobs.get(job_id="R0863103")
print(job.title, job.location, job.work_location_type)
except JobNotFound as exc:
print(f"Job not found: {exc.job_id}")
# Find similar jobs using a constructible Job instance
target = client.job(job_id="R0863103")
for similar in target.similar(limit=3):
print(similar.title, similar.city, similar.state)
print("exercised: search / by_category / by_location / details / jobs.get / similar")
Full-text search over CVS Health job listings. Keywords match against job title, description, category, and location. Results are ordered by relevance. Pagination via offset; each page returns up to `limit` jobs. Omitting keywords returns all available listings.
| Param | Type | Description |
|---|---|---|
| from | integer | Pagination offset (number of results to skip) |
| limit | integer | Maximum number of results to return per page |
| keywords | string | Search keywords to match against job title, description, category, and location (e.g. 'pharmacy technician', 'developer', 'Remote') |
{
"type": "object",
"fields": {
"from": "integer pagination offset used for this response",
"jobs": "array of job summary objects with jobId, title, location, category, subCategory, applyUrl, postedDate, remote, type, city, state, country, descriptionTeaser",
"count": "integer number of jobs returned in this response page",
"total_hits": "integer total number of matching jobs in the catalog"
},
"sample": {
"data": {
"from": 0,
"jobs": [
{
"city": "Wichita",
"type": "Full time",
"jobId": "R0863103",
"state": "Kansas",
"title": "Staff Pharmacist Full Time",
"remote": "On-Site",
"country": "United States",
"applyUrl": "https://cvshealth.wd1.myworkdayjobs.com/CVS_Health_Careers/job/KS---Wichita/Staff-Pharmacist-Full-Time_R0863103/apply",
"category": "Pharmacy",
"location": "10800 E 21ST ST N, Wichita, Kansas,United States",
"postedDate": "2026-04-27T00:00:00.000+0000",
"subCategory": "Pharmacist",
"descriptionTeaser": "Embrace the opportunity to become a Staff Pharmacist..."
}
],
"count": 25,
"total_hits": 16289
},
"status": "success"
}
}About the CVS Health API
Search and Filter Endpoints
The API exposes three overlapping search paths. search_jobs accepts keywords, from, and limit parameters and matches against job title, description, category, and location simultaneously — omitting keywords returns all available listings. get_jobs_by_category takes a category string (e.g. 'Pharmacy', 'Innovation and Technology', 'Warehouse Fulfillment Transportation') and treats it as a relevance-ordered keyword search. get_jobs_by_location behaves similarly, accepting city names, state names, or 'Remote'. All three return the same response shape: jobs array, count, total_hits, and the from offset for the next page.
Job Detail and Application URLs
get_job_detail takes a requisition ID in the format R followed by digits (e.g. R0863103) and returns the full posting: jobTitle, company (always 'CVS Health'), location (full street address with city, state, country), timeType, postedDate (ISO datetime), category, subCategory, and description as an HTML string. The applyUrl field points directly to the Workday application page. Requesting an expired or removed ID returns a stale_input error with kind 'i'. get_apply_url constructs the canonical CVS Health careers page URL from a job ID without fetching the full detail record.
Pagination and Similar Jobs
All list endpoints paginate via integer from offset and return total_hits so you can compute how many additional pages exist. get_similar_jobs accepts a requisition ID and returns listings that match the ID pattern, surfacing sibling roles within the same requisition family — useful for identifying equivalent positions posted across different locations. search_jobs_by_keyword is a simpler interface to the same full-text search as search_jobs, using a query parameter instead of keywords and omitting the limit control.
The CVS Health API is a managed, monitored endpoint for cvshealth.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cvshealth.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cvshealth.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate CVS Health remote job openings by passing
'Remote'toget_jobs_by_locationand syncingapplyUrllinks to a job board - Build a pharmacy technician job alert by polling
search_jobswithkeywords='pharmacy technician'and comparingpostedDateto detect new postings - Populate a career site category browse page using
get_jobs_by_categoryfor categories like'Corporate','Pharmacy', and'Innovation and Technology' - Fetch full job descriptions via
get_job_detailto extract structured data from the HTMLdescriptionfield for skills or requirement parsing - Track total open headcount per location by paginating
get_jobs_by_locationfor each state and summingtotal_hits - Find all sibling postings for a known requisition using
get_similar_jobsto surface the same role listed across multiple cities - Resolve a job ID to its apply page URL quickly with
get_apply_urlwithout incurring the overhead of a fullget_job_detailcall
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CVS Health have an official public API for job listings?+
What does `get_job_detail` return beyond what appears in search results?+
get_job_detail returns the full HTML description field, the complete location string (including street address where available), timeType (e.g. 'Full time' or 'Part time'), and subCategory — none of which are guaranteed to appear in the summary objects returned by list endpoints. It also returns the direct Workday applyUrl and the ISO postedDate.How does pagination work across the list endpoints?+
from (the offset used), count (jobs in the current page), and total_hits (total matching jobs). To page through results, increment from by count on each subsequent request. search_jobs also accepts a limit parameter to control page size; search_jobs_by_keyword and the filter endpoints do not expose limit.Does the API cover salary ranges or compensation data for CVS Health positions?+
timeType, category, subCategory, location, and description (HTML), but no structured salary or compensation fields are exposed in any endpoint response. You can fork this API on Parse and revise it to add a salary extraction endpoint if CVS Health surfaces that data on individual job detail pages.Can I filter jobs by employment type (full-time vs. part-time) directly?+
timeType is returned in get_job_detail responses but is not a filterable parameter in any of the search endpoints — filtering happens by keyword, category string, or location string only. You can fork this API on Parse and revise it to add a timeType filter endpoint if that field is queryable on the source.