Written and maintained by CASRAI Editorial Board
Published
On this page
Malpedia is a free, curated malware resource run by Fraunhofer FKIE (the Fraunhofer Institute for Communication, Information Processing and Ergonomics) that gives analysts a rapid way to identify a malware family and find actionable context about it. Access is invite-only: you need a vetted account to use most of its data, and a handful of read-only API endpoints work without one.
What Malpedia is used for in research
Malpedia describes its goal as providing “a resource for rapid identification and actionable context when investigating malware”. In practice that means researchers use it as a reference layer for malware families and threat actors: you look up a family, see how it is named, read the references collected for it, and retrieve detection material such as YARA rules. It is administered by Daniel Plohmann and Steffen Enders of Fraunhofer FKIE and is offered as a free service.
It is a reference collection rather than a live indicator feed. Services such as MalwareBazaar, ThreatFox and URLhaus (compared in the table below) publish recent samples and indicators; Malpedia organises malware by family and actor and attaches references to them. Family names carry a platform prefix where one applies, for example win., elf. or osx., so the same family name on different operating systems stays distinguishable.
For research use, the part that matters most is reproducibility. The API can return bibliographic references (including BibTeX), a MISP galaxy export and YARA rules, so a study can record which family definitions and detection material it used, and cite the project in a consistent way. The project asks to be cited as described in the citation section below.
Access: who can use Malpedia and how
Malpedia is an invite-only trust group. Its terms of service state that every registration is vetted and that the person who vouches for a new member shares responsibility for them. An account is needed for all data on the website, and samples and non-public YARA rules require an account in particular. There is nothing to install: you work through the website at https://malpedia.caad.fkie.fraunhofer.de and through its HTTP API.
What you can do without an account
Per the API documentation, a defined set of read endpoints needs no authentication. These cover the list of families and actors, individual family and actor records, a search by family name, bibliographic exports, the reference list, the MISP galaxy export, the API version, and the YARA rules that are published under the TLP:WHITE and TLP:GREEN labels. The full endpoint-by-endpoint comparison is in the data table below this guide.
What needs a registered account
Sample retrieval (information, raw file or zip for a given MD5 or SHA-256), the sample lists, the ApiScout vector lists, and the two scan endpoints all require registration. The documentation also notes that the YARA listing endpoint may return different results for registered users.
Terms you accept when you use it
The terms of service set several conditions that matter for a research group. Non-public material is treated as TLP:AMBER unless otherwise agreed, which restricts onward sharing. Users must not make a profit off of the Malpedia community effort. Website content is licensed under CC BY-NC-SA 3.0, so reuse needs attribution, must be non-commercial and must be shared under the same licence. Read the terms at https://malpedia.caad.fkie.fraunhofer.de/usage/tos before you build a pipeline that republishes anything.
Step-by-step: query the Malpedia API
The steps below use only endpoints and headers described on the official API page. The examples use curl; the documentation does not state a response format, so inspect what comes back rather than assuming one.
- Get an account. Registration is by invitation and vetting (see above). Without an account, skip to step 3 and use only the unauthenticated endpoints.
- Generate an API token. The API supports two authentication methods: HTTP Basic authentication, or an API token sent in the
Authorizationheader asapitoken ‹TOKEN›. Tokens are generated on the/settingspage. You can have up to 10 tokens, and a token cannot be retrieved again after it is created, so store it in a password manager or secrets store when it is shown. - Check that the key works. Call
/api/check/apikeywith your header, for examplecurl -H "Authorization: apitoken ‹TOKEN›" https://malpedia.caad.fkie.fraunhofer.de/api/check/apikey. This is the documented endpoint for confirming a key;/api/get/versionreports the API version and needs no authentication. - List families and actors.
/api/list/familiesand/api/list/actorsreturn the lists;/api/get/familiesand/api/get/actorsreturn the full records. Use/api/find/family/‹needle›to search by name, then/api/get/family/‹id›for one family or/api/get/actor/‹id›for one actor. Remember the platform prefix: the identifier of a Windows family begins withwin.. - Retrieve detection rules.
/api/get/yara/‹family_id›returns the YARA rules for one family. For bulk collections,/api/get/yara/tlp_white/raw(ortlp_green,tlp_amber) returns a TLP tier as raw text, and the same path ending in/zipreturns an archive./api/get/yara/after/‹yyyy-mm-dd›returns rules added after a date, which is useful for incremental updates, and/api/get/yara/auto/rawreturns the automatically generated rules. Note that the TLP:AMBER tier is non-public material and falls under the terms described above. - Export references for your bibliography.
/api/get/bibreturns the collected references as BibTeX (a.bibfile), and/api/get/bib/family/‹id›and/api/get/bib/actor/‹id›narrow it to one family or actor./api/get/referencesreturns the reference list itself. - Export to MISP.
/api/get/mispreturns Malpedia content in the MISP galaxy cluster format, which lets you load family and actor knowledge into a MISP instance. - Scan with your own rule (registered accounts).
POST /api/scan/yara/‹family_id›takes the text of a YARA rule in the request body and runs it against the samples of that family.POST /api/scan/apiscoutaccepts a compressed ApiVector produced by ApiScout.
The documentation does not publish rate limits. Even so, request what you need once, cache it locally and use the date-based YARA endpoint for updates instead of re-downloading everything.
Output and how to read it
Think of each result as one of four kinds of object. A family record describes a malware family and its platform-prefixed identifier. An actor record describes a threat actor. References point to the publications collected for a family or actor and are what the BibTeX exports are built from. YARA rules are detection signatures grouped by family or by TLP label. If you are new to writing and reading those, the guide to YARA rules covers strings, conditions and command-line output.
When you use the MISP export, the guide to the MISP threat intelligence platform explains how events and galaxies fit together, and the MITRE ATT&CK framework guide shows how behaviours described for a family are usually mapped to techniques in other tools.
Citing Malpedia in a paper
The project’s references page asks users to cite this paper: Plohmann, D., Clauss, M., Enders, S., Padilla, E. “Malpedia: A Collaborative Effort to Inventorize the Malware Landscape.” The Journal on Cybercrime & Digital Investigations, vol. 3, no. 1, April 2018, https://journal.cecyf.fr/ojs/index.php/cybin/article/view/17. The abstract describes Malpedia as a collaboration platform for curating a malware corpus, reports a baseline corpus of 607 families and 1,792 samples, finds that looking beyond packers reduces the corpus size needed, and includes a structural study of Windows malware. Those figures describe the corpus at the time of that paper, not today’s holdings.
Because the website content is CC BY-NC-SA 3.0, also keep the credits when you reproduce text, and state the date you retrieved a record, since family and actor entries change as the community edits them.
Troubleshooting
I cannot retrieve my token
Tokens are shown when generated and cannot be retrieved later. Create a new one on the /settings page; the limit is 10 tokens per account, so remove ones you no longer use.
A sample or scan endpoint is refused
Sample endpoints, sample lists, ApiScout lists and both scan endpoints require registration. The no-authentication endpoints will not substitute for them. Use /api/check/apikey to separate a bad key from an endpoint that needs an account.
A family lookup finds nothing
Family identifiers include a platform prefix such as win., elf. or osx.. Search with /api/find/family/‹needle› using the base name, then use the exact identifier it returns in /api/get/family/‹id›.
YARA results differ between runs or users
The documentation warns that the YARA listing may return different results for registered users, and TLP tiers separate what is public from what is restricted. Record which endpoint and TLP tier you used and the date, so another team can reproduce the set.
Something looks wrong in the data
The project directs feedback to its public issue tracker on GitHub.
Free alternatives and companions
These are other free resources with their own CASRAI guides. They answer different questions: Malpedia organises knowledge by family and actor, while these services publish samples and indicators. The descriptions come from each guide.
| Resource | What it provides | Guide |
|---|---|---|
| MalwareBazaar | abuse.ch’s free malware sample database, with hash lookups through an API and fair-use limits | MalwareBazaar guide |
| ThreatFox | An indicator-of-compromise (IOC) database with API query types, export formats and a 6-month expiry rule since 2025-05-01 | ThreatFox guide |
| URLhaus | An open feed of malware distribution URLs with CSV and JSON dumps and a REST API | URLhaus guide |
Frequently asked questions
Is Malpedia free?
Yes. The project describes it as a free service offered by Fraunhofer FKIE. Access is controlled by invitation and vetting rather than payment, and its terms forbid making a profit off of the Malpedia community effort.
Can anyone get an account?
No. It is an invite-only trust group. Every registration is vetted and the member who vouches for a newcomer shares responsibility for them.
Which API endpoints work without logging in?
The family, actor, search, bibliography, reference, MISP galaxy and version endpoints, plus the TLP:WHITE and TLP:GREEN YARA collections, need no authentication. Sample, ApiScout and scan endpoints need an account.
How do I authenticate to the API?
Use HTTP Basic authentication or an API token in the Authorization header as apitoken ‹TOKEN›. Generate the token on the settings page; up to 10 are allowed and a token cannot be retrieved afterwards.
Can I reuse Malpedia content in a publication?
Website content is CC BY-NC-SA 3.0, so attribute it, keep it non-commercial and share alike. Non-public material is treated as TLP:AMBER unless agreed otherwise. Cite the project using the paper listed on its references page.
Sources
- Malpedia home page, Fraunhofer FKIE: https://malpedia.caad.fkie.fraunhofer.de/ (read 2026-11-14)
- Malpedia API usage documentation: https://malpedia.caad.fkie.fraunhofer.de/usage/api (read 2026-11-14)
- Malpedia terms of service: https://malpedia.caad.fkie.fraunhofer.de/usage/tos (read 2026-11-14)
- Malpedia references and citation page: https://malpedia.caad.fkie.fraunhofer.de/usage/references (read 2026-11-14)
- Plohmann et al., Malpedia: A Collaborative Effort to Inventorize the Malware Landscape, The Journal on Cybercrime & Digital Investigations, 2018: https://journal.cecyf.fr/ojs/index.php/cybin/article/view/17 (read 2026-11-14)
Data: Malpedia API endpoints by authentication requirement
Endpoints of the Malpedia HTTP API compiled from the official API usage documentation, grouped by purpose and showing whether each needs a registered account or key.
Period covered: 2026.
| Function | Endpoint path | Authentication | Typical use |
|---|---|---|---|
| List families / actors | /api/list/families, /api/list/actors, /api/get/families, /api/get/actors | No | Browse the family and actor catalogue |
| Single family or actor, name search | /api/get/family/, /api/get/actor/, /api/find/family/ | No | Look up one record or search by name |
| Bibliography and references | /api/get/bib (also /actor/, /family/), /api/get/references | No | Export references as BibTeX or a list |
| MISP galaxy export | /api/get/misp | No | Load Malpedia knowledge into MISP |
| API version | /api/get/version | No | Check the API version |
| Key check | /api/check/apikey | Key or Basic auth | Confirm a key is valid |
| YARA rules by family | /api/get/yara/ | No | Rules for one family |
| YARA rules by TLP label | /api/get/yara//raw or /zip (tlp_white, tlp_green, tlp_amber) | No | Bulk rule collections by sharing label |
| YARA rules added after a date | /api/get/yara/after/ | No | Incremental rule updates |
| Auto-generated YARA rules | /api/get/yara/auto/raw or /zip | No | Automatically generated rule set |
| Sample information, raw file or zip | /api/get/sample//info|raw|zip | Registered account | Retrieve a sample |
| Sample lists | /api/list/samples[/] | Registered account | Enumerate samples |
| ApiScout vector lists | /api/list/apiscout[/csv] | Registered account | Enumerate ApiScout vectors |
| Scan with a YARA rule (POST) | /api/scan/yara/ | Registered account | Run your rule against a family's samples |
| Scan with ApiScout vector (POST) | /api/scan/apiscout | Registered account | Match a compressed ApiVector |
Sources
- Malpedia API usage documentation (accessed 2026-11-14)
Compiled by CASRAI from the sources above. Free to reuse under CC BY 4.0 with attribution.







