Docs menu

GoodRx API endpoint

GoodRx drug prices API

Use Crawlora's GoodRx drug prices API to extract supported public GoodRx data as structured JSON. This page includes request parameters, cURL examples, response schema, error behavior, credit cost, and a Playground link for testing before integration.

GETapiKey3 credits/requestGoodRxgoodrx.drugPricesResponseDoc/goodrx/drug-prices

Endpoint facts

Method: GET
API path: /goodrx/drug-prices
Auth: apiKey
Credits: 3 credits/request
Platform: GoodRx
Response schema: #/definitions/goodrx.drugPricesResponseDoc

Overview

Returns GoodRx coupon, membership, and mail-order prices by pharmacy for one drug and prescription (brand/generic label, form, dosage, quantity), plus the drug summary, the priced configuration, the location prices were computed for, and every available label/form/dosage/quantity. Omit label/form/dosage/quantity for GoodRx's default prescription; values must come from /goodrx/drug-options. Pass latitude and longitude (optionally zip_code and state) to price at a US location; otherwise prices reflect a US location chosen by GoodRx. Requests use US egress because GoodRx is US-only. Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

GoodRx Scraper API Try GoodRx drug prices API in Playground Crawlora API pricing GoodRx API documentation

Request parameters

Request parameters are generated from the active endpoint catalog. Required values must be sent before Crawlora can call the upstream public web data source.

Parameter	Type	Required	Description	Example
slug	string	Yes	Drug slug from /goodrx/drugs, /goodrx/class, or /goodrx/condition-drugs	atorvastatin
label	string	No	Brand or generic label slug from /goodrx/drug-options	atorvastatin
form	string	No	Form slug from /goodrx/drug-options	tablet
dosage	string	No	Dosage slug from /goodrx/drug-options	20mg
quantity	integer	No	Quantity (1-999999); /goodrx/drug-options lists GoodRx's standard quantities	30
latitude	number	No	Latitude of a US location to price at (requires longitude)	40.7506
longitude	number	No	Longitude of a US location to price at (requires latitude)	-73.9972
zip_code	string	No	Five-digit ZIP code of that location	10001
state	string	No	Two-letter state code of that location	NY
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goodrx/drug-prices?slug=atorvastatin" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost: 3 credits/request
Charged response: Successful 2xx responses

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

Proxy strategy: managed automatically where needed
Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
Browser cluster: supported dynamic workloads can be routed through distributed browser instances
Retry behavior: automatic retry/fallback may be used depending on endpoint type
Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
Billing: credits are charged only for successful 2xx responses
Observability: responses include request context where available

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

Status	Common failure case
400	Invalid input or missing required parameter
429	Plan or endpoint rate limit exceeded
500	Internal execution error
502	Upstream platform failed, returned unusable HTML, or served a challenge page that could not be resolved

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Example JSON response

{
  "code": 0,
  "message": "success",
  "data": {
    "drug": {
      "slug": "atorvastatin",
      "name": "Atorvastatin",
      "url": "https://www.goodrx.com/atorvastatin",
      "alternate_name": "Generic Lipitor",
      "non_proprietary_name": "atorvastatin",
      "drug_class": {
        "name": "Statins",
        "slug": "statins",
        "url": "https://www.goodrx.com/classes/statins"
      },
      "administration_route": "Oral",
      "prescription_status": "PrescriptionOnly"
    },
    "configuration": {
      "drug_id": "33396",
      "label": "atorvastatin",
      "form": "tablet",
      "dosage": "20mg",
      "quantity": 30,
      "summary": "20mg 30 tablets"
    },
    "location": {
      "city": "Los Angeles",
      "state": "CA",
      "zip_code": "90017"
    },
    "offers": [
      {
        "pharmacy_id": "31240",
        "pharmacy_name": "Kroger Pharmacy",
        "pharmacy_type": "PharmacyChain",
        "pricing_type": "COUPON",
        "price": 24.99,
        "retail_price": 53.73,
        "lowest_price": 24.99
      }
    ],
    "options": [
      {
        "name": "Atorvastatin",
        "slug": "atorvastatin",
        "type": "GENERIC",
        "forms": [
          {
            "name": "tablet",
            "slug": "tablet",
            "dosages": [
              {
                "name": "20mg",
                "slug": "20mg",
                "drug_id": "33396",
                "quantities": [
                  30,
                  60,
                  90,
                  100,
                  180
                ],
                "default_quantity": 30
              }
            ]
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goodrx.drugPricesResponseDoc

Field	Type	Required	Description
data	goodrx.DrugPricesResponse	No
data.configuration	goodrx.Configuration	No
data.configuration.dosage	string	No
data.configuration.drug_id	string	No
data.configuration.form	string	No
data.configuration.label	string	No
data.configuration.quantity	integer	No
data.configuration.summary	string	No
data.drug	goodrx.DrugInfo	No
data.drug.administration_route	string	No
data.drug.alternate_name	string	No
data.drug.description	string	No
data.drug.drug_class	goodrx.ClassRef	No
data.drug.drug_class.name	string	No
data.drug.drug_class.slug	string	No
data.drug.drug_class.url	string	No
data.drug.image_url	string	No
data.drug.legal_status	string	No
data.drug.name	string	No
data.drug.non_proprietary_name	string	No
data.drug.prescription_status	string	No
data.drug.slug	string	No
data.drug.url	string	No
data.location	goodrx.Location	No
data.location.city	string	No
data.location.latitude	number	No
data.location.longitude	number	No
data.location.state	string	No
data.location.zip_code	string	No
data.offers	array	No
data.offers[].logo_url	string	No
data.offers[].lowest_price	number	No
data.offers[].membership	string	No	Membership names the paid program behind an UPSELL price, for example "COMPANION" (observed value; returned as data).
data.offers[].order_url	string	No
data.offers[].pharmacy_id	string	No
data.offers[].pharmacy_name	string	No
data.offers[].pharmacy_type	string	No	PharmacyType is "PharmacyChain" (retail) or "PharmacyOnlineStore" (mail order) as observed; returned as data.
data.offers[].price	number	No
data.offers[].pricing_type	string	No	PricingType is GoodRx's pricing kind, for example "COUPON", "UPSELL", or "HOME_DELIVERY" (observed values; returned as data).
data.offers[].retail_price	number	No
data.options	array	No
data.options[].forms	array	No
data.options[].forms[].dosages	array	No
data.options[].forms[].dosages[].default_quantity	integer	No	DefaultQuantity is GoodRx's default quantity for this dosage.
data.options[].forms[].dosages[].drug_id	string	No
data.options[].forms[].dosages[].name	string	No
data.options[].forms[].dosages[].quantities	array	No
data.options[].forms[].dosages[].slug	string	No
data.options[].forms[].name	string	No
data.options[].forms[].slug	string	No
data.options[].name	string	No
data.options[].slug	string	No
data.options[].type	string	No

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/goodrx/drug-prices?slug=atorvastatin" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Responsible public web data workflows

Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.

Read Crawlora terms

More GoodRx endpoint docs GoodRx Scraper API Crawlora API pricing Try GoodRx drug prices API in Playground GoodRx health question and answer API documentation GoodRx health questions API documentation GoodRx brand-name medications API documentation GoodRx drug class API documentation GoodRx drug classes API documentation GoodRx drug comparison API documentation

Open in Playground Back to group