Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the CVS Pharmacy API page →

E-commerce & Marketplaces

CVS Pharmacy API & Scraper

CVS Pharmacy API returns live CVS Pharmacy data as clean JSON for cvs pharmacy The primary endpoint, search, returns total_results (CVS's own numFound), count, offset, limit, has_more, and products[] with product_id, title, brand, url, image_url, sponsor….

3 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a CVS Pharmacy scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product/detail, product/batch. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Oct 3, 2026, 12:45 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/cvs/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "shampoo",
    "limit": 20
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "cvs",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2177,
    "record_count": 26,
    "bytes": 169223,
    "cache_hit": false,
    "completeness_pct": 5.24,
    "stop_reason": "limit_reached",
    "upstream_requests": 1,
    "dropped_tiles": 0,
    "sponsored_rows": 9,
    "on_sale_rows": 6,
    "charged_credits": 2,
    "version": "1.0.0",
    "request_id": "de38f4713cba4e25",
    "queue_ms": 3.1
  },
  "data": {
    "query": "shampoo",
    "total_results": 496,
    "count": 26,
    "offset": 0,
    "limit": 20,
    "requested_limit": 20,
    "has_more": true,
    "products": [
      {
        "product_id": "797389",
        "title": "Pantene Pro-V Volume & Body 2-in-1 Shampoo & Conditioner, 12 OZ",
        "brand": "Pantene Pro-V",
        "url": "https://www.cvs.com/shop/pantene-pro-v-volume-body-2-in-1-shampoo-conditioner-12-oz-prodid-797389",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/8087819559.jpg",
        "sponsored": true,
        "featured": true,
        "new_product": false,
        "rating": 4.2264,
        "review_count": 212,
        "variant_count": 1,
        "sku_ids": [
          "797389"
        ],
        "price": {
          "currency": "USD",
          "price": 6.19,
          "sale_price": null,
          "on_sale": false,
          "discount_pct": null,
          "carepass_price": null,
          "unit_price": "51.6¢/oz.",
          "unit_price_amount": 0.516,
          "unit_price_unit": "oz",
          "promo": null,
          "price_min": 6.19,
          "price_max": 6.19,
          "sale_price_min": null,
          "sale_price_max": null,
          "carepass_price_min": null,
          "carepass_price_max": null,
          "unit_price_min": "51.6¢/oz.",
          "unit_price_max": "51.6¢/oz."
        }
      },
      {
        "product_id": "708463",
        "title": "Native Volumizing Shampoo, Cucumber & Mint, 16.5 OZ",
        "brand": "NATIVE",
        "url": "https://www.cvs.com/shop/native-volumizing-shampoo-cucumber-mint-16-5-oz-prodid-708463",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/81215403327.jpg",
        "sponsored": true,
        "featured": true,
        "new_product": false,
        "rating": 4.6958,
        "review_count": 3465,
        "variant_count": 1,
        "sku_ids": [
          "708463"
        ],
        "price": {
          "currency": "USD",
          "price": 11.49,
          "sale_price": null,
          "on_sale": false,
          "discount_pct": null,
          "carepass_price": null,
          "unit_price": "69.6¢/oz.",
          "unit_price_amount": 0.696,
          "unit_price_unit": "oz",
          "promo": null,
          "price_min": 11.49,
          "price_max": 11.49,
          "sale_price_min": null,
          "sale_price_max": null,
          "carepass_price_min": null,
          "carepass_price_max": null,
          "unit_price_min": "69.6¢/oz.",
          "unit_price_max": "69.6¢/oz."
        }
      },
      {
        "product_id": "268308",
        "title": "Head & Shoulders Classic Clean 2-in-1 Dandruff Shampoo & Conditioner, 12.5 OZ",
        "brand": "Head & Shoulders",
        "url": "https://www.cvs.com/shop/head-shoulders-classic-clean-2-in-1-dandruff-shampoo-conditioner-12-5-oz-prodid-268308",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/3077206280.jpg",
        "sponsored": true,
        "featured": true,
        "new_product": false,
        "rating": 4.0987,
        "review_count": 4032,
        "variant_count": 1,
        "sku_ids": [
          "268308"
        ],
        "price": {
          "currency": "USD",
          "price": 8.39,
          "sale_price": null,
          "on_sale": false,
          "discount_pct": null,
          "carepass_price": null,
          "unit_price": "67.1¢/oz.",
          "unit_price_amount": 0.671,
          "unit_price_unit": "oz",
          "promo": "Buy 1, Get 1 40% Off",
          "price_min": 8.39,
          "price_max": 8.39,
          "sale_price_min": null,
          "sale_price_max": null,
          "carepass_price_min": null,
          "carepass_price_max": null,
          "unit_price_min": "67.1¢/oz.",
          "unit_price_max": "67.1¢/oz."
        }
      }
    ]
  }
}

Actions

What the CVS Pharmacy API does

Action	Description	Concrete use case	Key params
search	Keyword search over the cvs.com catalogue. Returns CVS's own result total, the product grid with full pricing, and optionally its live facet counts. Paging with `offset` walks the whole result set and stops honestly at the end. No sort or filter parameter is offered: CVS accepts both and then returns either zero rows or the unfiltered set, so neither can be sold.	Pricing teams call search to get keyword search over the cvs.com catalogue.	query, limit, offset, include_facets
product/detail	Everything cvs.com publishes about ONE product: the full price block, the variant matrix with per-variant prices and attributes, per-channel stock STATUS AND QUANTITY, ExtraBucks + manufacturer coupons with expiry dates, and the eligibility flags (CarePass, HSA/FSA, SNAP, store pickup, same-day). One upstream request. For many ids at once use `product/batch`.	Marketplace operators call product/detail to get everything cvs.com publishes about ONE product.	product_id
product/batch	Resolve up to 200 CVS product ids to live price, sale price, rating and title in a SINGLE upstream request (~700 bytes per product). The bulk lane: use it to re-price a catalogue. Ids CVS did not resolve come back in `missing_ids` instead of disappearing.	Catalog enrichment teams call product/batch to resolve up to 200 CVS product ids to live price, sale price, rating and title in a SINGLE ups….	product_ids

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/cvs/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"shampoo","limit":20}'

import requests

r = requests.post(
    "https://api.reefapi.com/cvs/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "shampoo",
  "limit": 20
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/cvs/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "shampoo",
  "limit": 20
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.cvs.search with {"query":"shampoo","limit":20}.

Use cases

Who uses this API and why

Pricing teams use CVS Pharmacy to get keyword search over the cvs.com catalogue.
Marketplace operators use CVS Pharmacy to get everything cvs.com publishes about ONE product.
Catalog enrichment teams use CVS Pharmacy to resolve up to 200 CVS product ids to live price, sale price, rating and title in a SINGLE ups….

FAQ

Questions developers ask before integrating

What is the CVS Pharmacy API?

CVS Pharmacy API is a ReefAPI endpoint group for cvs pharmacy It returns live JSON through POST requests under /cvs/v1.

Is the CVS Pharmacy API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. CVS Pharmacy calls use the same shared credit balance as every other ReefAPI engine.

Do I need a CVS Pharmacy login or account?

No login to CVS Pharmacy is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the CVS Pharmacy data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the CVS Pharmacy API use?

CVS Pharmacy actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call CVS Pharmacy from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call cvs actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the CVS Pharmacy API a CVS Pharmacy scraper?

It is the managed alternative to a DIY CVS Pharmacy scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same cvs pharmacy back as clean JSON.

Why does my CVS Pharmacy scraper keep getting blocked?

Most CVS Pharmacy scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / cvs

CVS Pharmacy

base /cvs/v13 endpoints

post/cvs/v1/search2 credits

Keyword search over the cvs.com catalogue. Returns CVS's own result total, the product grid with full pricing, and optionally its live facet counts. Paging with `offset` walks the whole result set and stops honestly at the end. No sort or filter parameter is offered: CVS accepts both and then returns either zero rows or the unfiltered set, so neither can be sold.

Parameter		Allowed / range	Description
query	required	—	Keyword to search the cvs.com catalogue for — a product type ('shampoo'), a brand ('Nature Made') or a full product name. A CVS product id also works and returns that one product. Nonsense keywords return an honest empty answer (total_results 0), not an error.
limit = 20	optional	1–48	Products to ask for, 1-48 (default 20). CVS injects its own sponsored tiles into every page, so the answer usually holds a FEW MORE rows than asked for (measured: 20 asked → 20-26 returned). Bytes grow with it: 20 ≈ 110 KB, 48 ≈ 334 KB.
offset = 0	optional	0–100000	Rows to skip, for paging (default 0). Paging is real on this source: successive windows are different products, and an offset past the end returns zero rows with the true total still reported. Sponsored tiles are re-injected per page, so 0-1 id may repeat between windows.
include_facets = false	optional	—	Also return CVS's own facet vocabulary with live counts for this keyword (brand, on-sale promotion, form, concern, HSA/FSA eligible, OTC eligible). Costs no extra request. Read-only: CVS does not honour a filter on this surface, so there is no filter parameter to pair with it.

Try in playground →

post/cvs/v1/product/detail1 credit

Everything cvs.com publishes about ONE product: the full price block, the variant matrix with per-variant prices and attributes, per-channel stock STATUS AND QUANTITY, ExtraBucks + manufacturer coupons with expiry dates, and the eligibility flags (CarePass, HSA/FSA, SNAP, store pickup, same-day). One upstream request. For many ids at once use `product/batch`.

Parameter		Allowed / range	Description
product_id	required	—	A CVS product id — the digits after `-prodid-` in any cvs.com product url (/shop/…-prodid-797389 → 797389). Ids returned by this engine's `search` and `product/batch` are the same ids.

Try in playground →

post/cvs/v1/product/batch2 credits

Resolve up to 200 CVS product ids to live price, sale price, rating and title in a SINGLE upstream request (~700 bytes per product). The bulk lane: use it to re-price a catalogue. Ids CVS did not resolve come back in `missing_ids` instead of disappearing.

Parameter		Allowed / range	Description
product_ids	required	—	1-200 CVS product ids in ONE request (a list, or a comma-separated string). The source accepts 200 and rejects 250, so 200 is the hard ceiling. Multi-variant PARENT ids are accepted by CVS and then silently omitted from its answer, so any id that did not resolve is returned in `missing_ids` rather than dropped quietly.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/cvs/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"shampoo","limit":20}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Built for volume

5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?

We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support

2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance

Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.

Comparing scraping APIs?ReefAPI vs Bright Data ReefAPI vs SerpApi ReefAPI vs ScraperAPI