ICD-10-CM Lookup Scraper

🔎 ICD-10-CM code lookup for diagnosis data

Medical coders, health data analysts, and software teams can use the ICD-10-CM Lookup Scraper to search the public NLM Clinical Tables service. It returns official ICD-10-CM code names in flat dataset rows, with the search term and rank when a text search finds a match. Use it for symptom and condition searches or exact code lookups, then export the rows through Apify for billing tools, research, EHR autocomplete, and QA workflows.

• Search broad diagnosis terms and export code names with ICD-10 codes.
• Find a common condition code with Urinary tract infection ICD-10 code.
• Build a source-backed diagnosis list with ICD-10 diagnosis codes list.
• Collect condition matches with ICD-10 diabetes type 2.
• Check a known code with ICD-10 code for hypertension.

📦 ICD-10-CM code rows

Each saved item is one successful ICD-10-CM code match. The Actor does not save error or placeholder rows, so the dataset stays focused on usable code matches. Each row includes the code, its official name, and the search term and rank when a text search produced the match. Exact-code rows use null for the search term and rank.

🚀 Run an ICD-10-CM lookup

1. Open the Actor input.
2. Add one or more values to Search terms, Exact ICD-10-CM codes, or both.
3. Set Maximum results per search term to control how many matches each text search can save, or leave it empty to return all available results until the source is exhausted.
4. Start the Actor.
5. Open the dataset or export the results as JSON, CSV, Excel, XML, RSS, or HTML.

For a quick first run, keep the prefilled fever, diabetes, hypertension, and fracture search terms and leave the result limit at 32.

⚙️ Input

Use search terms when you want the source to find matching ICD-10-CM rows by symptom, condition, diagnosis wording, or a partial code fragment. Use exact codes when you already know the code and want to confirm the official source name.

Default input example

This is the public input from a successful hosted default-input run:

{
  "searchTerms": [
    "fever",
    "diabetes",
    "hypertension",
    "fracture"
  ],
  "maxItemsPerSearch": 32
}

Input fields

Field	Type	What it does
searchTerms	array of strings	Searches symptoms, conditions, diagnosis words, or partial code fragments.
icdCodes	array of strings	Looks up exact ICD-10-CM diagnosis codes such as A78, E11.9, or Z00.00.
maxItemsPerSearch	integer	Limits matches saved for each text search. Leave it empty to return all available results until the source is exhausted.

If both target lists are empty, the Actor stops cleanly and asks for at least one search term or exact code. Invalid exact codes are skipped instead of saved.

🧾 Output

The Actor returns a link to the saved rows in the default dataset.

Output link

Field	Type	What it does
results	string (URL)	Opens the saved ICD-10-CM code matches in the default dataset.

Dataset row

Field	Type	What it does
code	string	Official ICD-10-CM code returned by NLM Clinical Tables.
name	string	Official ICD-10-CM diagnosis name returned by the source.
matchedTerm	string or null	Search term that produced the row, or null for an exact-code lookup.
rank	integer or null	1-based result order for a search row, or null for an exact-code lookup.

Example search row

This complete row comes from a successful current-beta run that searched Q fever:

{
  "code": "A78",
  "name": "Q fever",
  "matchedTerm": "Q fever",
  "rank": 1
}

Exact-code lookups use the same output shape with matchedTerm and rank set to null. The selected beta run also returned E11.9 with both fields set to null.

💳 Pricing

This Actor uses pay-per-event pricing. You are charged once for each saved ICD-10-CM code.

🔌 Integrations

• Run the Actor from Apify Console when you need a one-off ICD-10-CM export.
• Call the Actor from the Apify API to add code lookup to billing, claims, EHR, research, or QA workflows.
• Schedule repeat runs for terms you monitor often.
• Use webhooks to send completed datasets to your app or data pipeline.
• Export rows to JSON, CSV, Excel, XML, RSS, or HTML for spreadsheets and downstream tools.

❓ FAQ

Can I look up an exact ICD-10-CM code?

Yes. Add codes such as A78, E11.9, or Z00.00 to Exact ICD-10-CM codes. Exact-code rows return matchedTerm: null and rank: null.

Can I search for a condition or partial code?

Yes. Add a symptom, condition, diagnosis word, or partial code fragment to Search terms. The Actor saves matching rows returned by NLM Clinical Tables, up to your per-term limit.

What happens when no code matches?

The Actor completes the lookup with an empty result set. It does not add placeholder or error rows.

What if the same code matches more than one search term?

The dataset keeps the first saved row for that code. It does not add later search terms to that row.

Does this return ICD-10-CM hierarchy data?

No. Each row contains code, name, matchedTerm, and rank. It does not add chapter, block, or parent fields.

Does this Actor give medical or billing advice?

No. It exports source-backed ICD-10-CM lookup data. It does not choose diagnoses, interpret symptoms, recommend billing codes, or decide clinical suitability.

Do I need an NLM API key or login?

No. The Actor uses the public NLM lookup and does not require a source API key, account, or credential.

Why use this Actor instead of calling NLM directly?

Use NLM directly when you want to own request code, retries, exports, scheduling, and dataset handling. Use this Actor for Apify runs, API access, exports, schedules, webhooks, and per-saved-code output without building that wrapper yourself.

What are alternatives to this lookup?

Alternatives include direct NLM Clinical Tables calls, CMS downloads, licensed coding tools, EHR terminology services, or other Apify healthcare data actors. This Actor focuses on public NLM ICD-10-CM lookup and does not replace clinical coding software.

📝 Changelog

0.2: Expanded ICD-10-CM lookups

• Search all available matches or set a per-search limit, including partial code fragments.
• Keep lookup exports focused on unique, source-backed ICD-10-CM results when individual requests have no match or are temporarily unavailable.

v0.1

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• ClinicalTrials.gov can find studies by condition and export trial details for research.
• FDA FAERS Adverse Events can collect public reports by drug or reaction for safety research.
• Hospital Price Transparency Scraper can export hospital billing codes and public price data.
• ICD-10-CM Lookup Scraper can provide another NLM ICD-10-CM code lookup path for comparison.
• ICD-10 Codes Scraper can cover broader ICD-10 and ICD-9 code searches when you need those code sets.

Made with ❤️ by Maxime Dupré