ICD-10 Codes Scraper

🔎 ICD-10 codes lookup for diagnosis code exports

ICD-10 Codes Scraper looks up ICD-10-CM diagnosis codes from NLM Clinical Tables and saves one clean dataset row per matching code. Use it when you need official code names for search terms such as symptoms or conditions, or when you already have exact ICD-10-CM codes and want a repeatable export through Apify.

• icd-10 codes - search broad diagnosis words and export official ICD-10-CM code names.
• urinary tract infection icd 10 code - look up common condition phrases and save the matching diagnosis codes.
• icd-10 diagnosis codes list - build a small source-backed list for billing tools, research, EHR autocomplete, or QA workflows.
• icd-10 diabetes type 2 - collect matching code rows for diabetes-related lookup terms.
• icd-10 code for hypertension - check known clinical phrases or exact codes without wiring your own NLM Clinical Tables request.

📦 Returned data

Each saved item is one successful ICD-10-CM code result. The Actor does not save error rows or placeholder rows, so your dataset stays focused on usable code matches.

Rows include:

Field	Description
code	ICD-10-CM code returned by NLM Clinical Tables.
name	Official ICD-10-CM diagnosis name returned by the source.
matchedTerm	Search term that produced the row, or null for exact-code lookups.
rank	1-based result order for search rows, or null for exact-code lookups.
chapterCode, chapterTitle	ICD-10-CM chapter data when the source provides it.
blockCode, blockTitle	ICD-10-CM block data when the source provides it.
parentCode, parentName	Parent code data when the source provides it.

The current NLM lookup path reliably returns code and name. Hierarchy fields are included as nullable columns and are filled only when source-backed data is available.

🚀 How to run it

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 term can save.
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 500.

⚙️ Input

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

{
  "searchTerms": ["fever", "diabetes", "hypertension", "fracture"],
  "icdCodes": ["A78", "E11.9"],
  "maxItemsPerSearch": 500
}

Input fields:

Field	What it does
searchTerms	Symptoms, conditions, or diagnosis words to search.
icdCodes	Exact ICD-10-CM diagnosis codes such as A78, E11.9, or Z00.00.
maxItemsPerSearch	Maximum saved matches per search term, from 1 to 1000.

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 example

{
  "code": "A78",
  "name": "Q fever",
  "matchedTerm": "fever",
  "rank": 1,
  "chapterCode": null,
  "chapterTitle": null,
  "blockCode": null,
  "blockTitle": null,
  "parentCode": null,
  "parentName": null
}

Exact-code lookups use the same output shape with matchedTerm and rank set to null.

💳 Pricing

This Actor uses pay-per-event pricing. You pay for each saved ICD-10-CM code lookup result.

The Actor does not charge for startup, empty searches, skipped invalid codes, no-result lookups, source errors, or status messages. Source-backed context returned with a saved code is included in the same event.

🔌 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 such as diabetes or hypertension?
Yes. Add condition or diagnosis words to Search terms. The Actor saves the matching rows returned by NLM Clinical Tables, up to your per-term limit.

Does this return ICD-10-CM hierarchy data?
The dataset includes nullable hierarchy fields. They are filled only when the official source path provides source-backed values. The current lookup path returns code names reliably and leaves unavailable hierarchy fields as null.

Does this Actor give medical advice 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.

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

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

📝 Changelog

• 0.1: Initial release.

🆘 Support

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

🔗 Other actors

• Hospital Price Transparency Scraper ↗ - Export CMS hospital facility data and public payer-rate records.
• URL to BibTeX Converter ↗ - Convert PubMed, DOI, arXiv, article, and web page URLs into BibTeX citations.
• World Bank Projects Scraper ↗ - Export public World Bank project and indicator data for research workflows.
• XML JSON Converter ↗ - Convert XML and JSON from pasted data or public URLs into clean dataset rows.
• RSS Feed Reader ↗ - Parse RSS, Atom, RDF, and JSON Feed URLs into structured feed item exports.

Made with ❤️ by Maxime Dupré