Endpoint Playground

Try the Browse a CVS OTC category page API

Returns one page of a CVS.com OTC (over-the-counter) retail category, subcategory, or brand page's product grid: products with title, brand, image, current/original price, and sponsored/featured/new-product flags; the total result count; and the facets (brand, color, size, price range, and other category-specific attributes, each with its selectable values and result counts) available to filter the page further. Covers the non-prescription retail catalog only. path is the segment of a page URL after "/shop/", e.g. "beauty" (top-level category), "health-medicine/allergy-sinus" (subcategory), or "brand-shop/s/safe-home" (brand page); a full https://www.cvs.com/shop/... URL or a "/shop/..." path is also accepted. Any of these can also carry an optional facet-filter suffix in the site's own URL shape, e.g. "beauty/makeup/eyes/q/CoverGirl/Black/brpc" to filter to brand CoverGirl and color Black -- see the response's facets field for which values/type codes a given category supports; filter values are case-sensitive exactly as the site renders them. page is a 1-indexed page number (default 1). sort is an optional result order matching the site's own Sort By control. CVS.com is only available from US and US-territory locations; a request served from an unsupported region returns an upstream error rather than an empty result.

What a live request returned

14 Oct 2026: 20 products; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /cvs/category?path=beauty
Fields with a value in every checked item: id, title, url, brand, image_url, currency, list_price, sale_price

Sample value profiles: list_price: 2.99 to 16.49, median 6.59; title: “DAISE Foaming Body Wash, Vanilla Whip, 8.8 OZ” and 19 other values; url: cvs.com.

Request: GET /cvs/category
Cost: 3 credits/request
Auth: apiKey

Browse a CVS OTC category page API documentation CVS platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/cvs/category?path=beauty&sort=pa' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	Yes	beauty	CVS category, subcategory, or brand-page URL path, optionally with a /q/{value}/{typeCode} facet-filter suffix, e.g. \
page	integer	No		1-indexed page number, default 1
sort	string	No	pa	Result sort order, default the site's own relevance order. One of pa (Price Low to High), pd (Price High to Low), tr (Top Rated), rc (Most Reviewed), az (Name A-Z), za (Name Z-A)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 8766,
    "page": 1,
    "products": [
      {
        "id": "478253",
        "title": "Crest Pro-Health Breath Mist, Clean Mint, 0.44 OZ, 2 PK",
        "url": "https://www.cvs.com/shop/crest-pro-health-breath-mist-clean-mint-0-44-oz-2-pk-prodid-478253",
        "brand": "Crest",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/72894700032.jpg",
        "currency": "USD",
        "list_price": 4.99,
        "sale_price": 4.99
      }
    ],
    "facets": [
      {
        "key": "brand",
        "label": "Brand",
        "values": [
          {
            "name": "Crest",
            "count": 12
          },
          {
            "name": "one+other",
            "count": 3
          }
        ]
      },
      {
        "key": "d_priceBucket",
        "label": "Price",
        "values": [
          {
            "name": "$0 - $5",
            "count": 9
          },
          {
            "name": "$5 - $10",
            "count": 6
          }
        ]
      }
    ]
  }
}

More CVS endpoints

CVS brand directory CVS category taxonomy CVS OTC product ingredients CVS OTC product detail Search CVS OTC products by keyword CVS store locator

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestcvs.categoryResponseDocCVS

GET /cvs/category

Browse a CVS OTC category page

Response behavior

- `list_price`/`sale_price`/`currency` come from the page's own pricing data; a product with no price omits these fields. - `is_sponsored`, `is_featured`, and `is_new_product` reflect the merchandising flags the category page itself carries. - `facets` lists every filter the current category/filter state exposes: `key` is the upstream facet field name (e.g. `brand`, `e_color`, `d_priceBucket`), `label` is its display name (e.g. `Brand`, `Color`, `Price`), and `values` is a list of `{name, count}` — `count` is the number of results selecting that value would produce given whatever filters, if any, the request already applied. The set of facets and their values is category-specific and upstream-controlled; read it from a live response rather than assuming a fixed set. - CVS.com is only available from US/US-territory egress; a request from an unsupported region, or a page CVS blocks, returns a `503` upstream error rather than an empty or wrong result. - An unrecognized `path` (including a malformed filter suffix) or an unrecognized `sort` value returns a `400` invalid-parameter error before any upstream request is made.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

path

requiredstring

CVS category, subcategory, or brand-page URL path, optionally with a /q/{value}/{typeCode} facet-filter suffix, e.g. \

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 8766,
    "page": 1,
    "products": [
      {
        "id": "478253",
        "title": "Crest Pro-Health Breath Mist, Clean Mint, 0.44 OZ, 2 PK",
        "url": "https://www.cvs.com/shop/crest-pro-health-breath-mist-clean-mint-0-44-oz-2-pk-prodid-478253",
        "brand": "Crest",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/72894700032.jpg",
        "currency": "USD",
        "list_price": 4.99,
        "sale_price": 4.99
      }
    ],
    "facets": [
      {
        "key": "brand",
        "label": "Brand",
        "values": [
          {
            "name": "Crest",
            "count": 12
          },
          {
            "name": "one+other",
            "count": 3
          }
        ]
      },
      {
        "key": "d_priceBucket",
        "label": "Price",
        "values": [
          {
            "name": "$0 - $5",
            "count": 9
          },
          {
            "name": "$5 - $10",
            "count": 6
          }
        ]
      }
    ]
  }
}

Try the Browse a CVS OTC category page API

What a live request returned

14 Oct 2026: 20 products; 8 fields had a value in every checked item and 1 varied between items.

Observed request: GET /cvs/category?path=beauty
Fields with a value in every checked item: id, title, url, brand, image_url, currency, list_price, sale_price

Sample value profiles: list_price: 2.99 to 16.49, median 6.59; title: “DAISE Foaming Body Wash, Vanilla Whip, 8.8 OZ” and 19 other values; url: cvs.com.

Request: GET /cvs/category
Cost: 3 credits/request
Auth: apiKey

Browse a CVS OTC category page API documentation CVS platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/cvs/category?path=beauty&sort=pa' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
path	string	Yes	beauty	CVS category, subcategory, or brand-page URL path, optionally with a /q/{value}/{typeCode} facet-filter suffix, e.g. \
page	integer	No		1-indexed page number, default 1
sort	string	No	pa	Result sort order, default the site's own relevance order. One of pa (Price Low to High), pd (Price High to Low), tr (Top Rated), rc (Most Reviewed), az (Name A-Z), za (Name Z-A)

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 8766,
    "page": 1,
    "products": [
      {
        "id": "478253",
        "title": "Crest Pro-Health Breath Mist, Clean Mint, 0.44 OZ, 2 PK",
        "url": "https://www.cvs.com/shop/crest-pro-health-breath-mist-clean-mint-0-44-oz-2-pk-prodid-478253",
        "brand": "Crest",
        "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/72894700032.jpg",
        "currency": "USD",
        "list_price": 4.99,
        "sale_price": 4.99
      }
    ],
    "facets": [
      {
        "key": "brand",
        "label": "Brand",
        "values": [
          {
            "name": "Crest",
            "count": 12
          },
          {
            "name": "one+other",
            "count": 3
          }
        ]
      },
      {
        "key": "d_priceBucket",
        "label": "Price",
        "values": [
          {
            "name": "$0 - $5",
            "count": 9
          },
          {
            "name": "$5 - $10",
            "count": 6
          }
        ]
      }
    ]
  }
}

Browse a CVS OTC category page

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "total_count": 8766, "page": 1, "products": [ { "id": "478253", "title": "Crest Pro-Health Breath Mist, Clean Mint, 0.44 OZ, 2 PK", "url": "https://www.cvs.com/shop/crest-pro-health-breath-mist-clean-mint-0-44-oz-2-pk-prodid-478253", "brand": "Crest", "image_url": "https://www.cvs.com/bizcontent/merchandising/productimages/high_res/72894700032.jpg", "currency": "USD", "list_price": 4.99, "sale_price": 4.99 } ], "facets": [ { "key": "brand", "label": "Brand", "values": [ { "name": "Crest", "count": 12 }, { "name": "one+other", "count": 3 } ] }, { "key": "d_priceBucket", "label": "Price", "values": [ { "name": "$0 - $5", "count": 9 }, { "name": "$5 - $10", "count": 6 } ] } ] } }