PyEuropePMC Documentation
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](../tests/)
**Complete documentation for PyEuropePMC** - A robust Python toolkit for scientific literature analysis from Europe PMC
[π Quick Start](/pyEuropePMC/getting-started/quickstart.html) β’ [π API Reference](api/) β’ [π― Examples](examples/) β’ [πΊοΈ Site Map](/pyEuropePMC/sitemap.html) β’ [GitHub](https://github.com/JonasHeinickeBio/pyEuropePMC)
π Documentation Overview
Welcome to the PyEuropePMC documentation! This site is organized to help you find what you need quickly, whether youβre new to the library or a power user.
ποΈ Site Structure
π PyEuropePMC Documentation
βββ π [Getting Started](getting-started/) - Installation & basics
β βββ π¦ [Installation](/pyEuropePMC/getting-started/installation.html)
β βββ β‘ [Quick Start](/pyEuropePMC/getting-started/quickstart.html)
β βββ β [FAQ](/pyEuropePMC/getting-started/faq.html)
βββ β¨ [Features](features/) - What PyEuropePMC can do
β βββ π [Search](features/search/)
β βββ π§ [Query Builder](/pyEuropePMC/features/query-builder-load-save-translate.html)
β βββ π [Full-Text](features/fulltext/)
β βββ π¬ [XML Parsing](features/parsing/)
β βββ π [Systematic Reviews](/pyEuropePMC/features/systematic-review-tracking.html)
βββ π [API Reference](api/) - Complete API docs
β βββ π [SearchClient](/pyEuropePMC/api/search-client.html)
β βββ π [FullTextClient](/pyEuropePMC/api/fulltext-client.html)
β βββ π [ArticleClient](/pyEuropePMC/api/article-client.html)
β βββ π¬ [XML Parser](/pyEuropePMC/api/xml-parser.html)
β βββ π¦ [FTP Downloader](/pyEuropePMC/api/ftp-downloader.html)
βββ π― [Examples](examples/) - Code examples & use cases
βββ βοΈ [Advanced](advanced/) - Power user features
βββ π οΈ [Development](development/) - Contributing & development
π― Quick Navigation
| I want to⦠| Go to⦠| Time |
|---|---|---|
| Install PyEuropePMC | Installation | 2 min |
| Run my first search | Quick Start | 5 min |
| Search for papers | Search Features | 10 min |
| Build complex queries | Query Builder | 15 min |
| Download PDFs/XML | Full-Text Retrieval | 10 min |
| Parse XML documents | XML Parsing | 15 min |
| Extract metadata/tables | XML Parser API | 20 min |
| See working examples | Examples | 10-30 min |
| Optimize performance | Advanced Features | 20 min |
| Contribute code | Development | 30 min |
π Getting Started (Recommended Path)
1. **π¦ [Install](/pyEuropePMC/getting-started/installation.html)** (2 min)
```bash
pip install pyeuropepmc
```
2. **β‘ [Quick Start](/pyEuropePMC/getting-started/quickstart.html)** (5 min)
```python
from pyeuropepmc.search import SearchClient
with SearchClient() as client:
results = client.search("CRISPR", pageSize=10)
```
3. **π [Explore Features](features/)** (10-30 min)
- [Search](features/search/) - Query Europe PMC
- [Full-Text](features/fulltext/) - Download content
- [Parsing](features/parsing/) - Extract structured data
4. **π [API Reference](api/)** (as needed)
- Complete method documentation
- Parameter details & examples
π Feature Overview
π Search & Query
- Advanced Search: Boolean operators, field-specific queries, date ranges
- Query Builder: Type-safe fluent API for complex queries (150+ fields)
- Systematic Reviews: PRISMA-compliant search logging and audit trails
- Multiple Formats: JSON, XML, Dublin Core output
π Content Retrieval
- Full-Text Downloads: PDFs, XML, HTML from open access articles
- Bulk FTP: Efficient large-scale downloads via FTP
- Progress Tracking: Real-time callbacks and status updates
π¬ Data Extraction
- XML Parsing: Extract metadata, tables, references from full-text XML
- Format Conversion: Convert to plaintext, Markdown, structured data
- Schema Validation: Analyze XML element coverage and completeness
- Custom Patterns: Flexible configuration for different XML schemas
π Analytics & Processing
- Citation Analysis: Publication metrics and citation statistics
- Quality Assessment: Open access status, PDF availability, completeness
- Duplicate Detection: Remove duplicate papers from result sets
- Geographic Analysis: Author affiliation and location analysis
π οΈ Developer Features
- Type Safety: Comprehensive type annotations and validation
- Caching: HTTP caching with configurable backends (memory, disk, Redis)
- Error Handling: Robust retry logic and detailed error messages
- Rate Limiting: Respectful API usage with configurable delays
π Learning Paths
π¨βπ For Beginners
graph TD
A[Installation] --> B[Quick Start]
B --> C[Basic Search]
C --> D[Download Content]
D --> E[Parse XML]
E --> F[Examples]
- Installation β Quick Start
- Search Features β Full-Text
- Examples β API Reference
π¨βπΌ For Researchers
graph TD
A[Query Builder] --> B[Systematic Reviews]
B --> C[Advanced Search]
C --> D[Bulk Downloads]
D --> E[Analytics]
π¨βπ» For Developers
graph TD
A[API Reference] --> B[Advanced Features]
B --> C[Caching]
C --> D[Error Handling]
D --> E[Contributing]
- API Reference β Advanced
- Caching β Performance
- Development β Contributing
π Search & Discovery
By Topic
| Topic | Primary Location | Related |
|---|---|---|
| Installation | Getting Started | FAQ |
| Search Queries | Search | Query Builder |
| Full-Text | Full-Text | FTP Downloads |
| XML Parsing | Parsing | XML Parser |
| Systematic Reviews | Reviews | Query Builder |
| Analytics | Analytics | Examples |
| Performance | Advanced | Caching |
| Contributing | Development | GitHub |
By Task
| I need to⦠| Solution |
|---|---|
| Find papers on a topic | Search Features |
| Download PDFs in bulk | FTP Downloader |
| Extract tables from papers | XML Parsing |
| Build reproducible searches | Systematic Reviews |
| Analyze citation patterns | Analytics |
| Optimize API performance | Caching |
| Handle API errors | Error Handling |
π¦ Whatβs New in v1.11.3
β¨ Major Features
- Advanced Analytics: Citation analysis, quality metrics, duplicate detection
- HTTP Caching: Configurable caching backends with conditional requests
- RDF Conversion: Convert papers to knowledge graphs with RML mappings
- Type-Safe Query Builder: 150+ searchable fields with validation
- Bulk Operations: Efficient large-scale content retrieval
π§ Improvements
- Modular Architecture: Better code organization and maintainability
- Enhanced Testing: 200+ tests with 90%+ coverage
- CI/CD Pipeline: Automated quality assurance and deployment
- Documentation: Comprehensive guides and examples
See CHANGELOG for complete version history.
π Getting Help
Quick Help
- β FAQ - Common questions answered
- π‘ Examples - Working code samples
- π GitHub Issues - Bug reports & support
Community Support
- π Europe PMC API Docs - Official API reference
- π¦ PyPI Package - Package details
- π» GitHub Repository - Source code
Report Issues
Found a bug or need help? Create an issue with:
- Python version and PyEuropePMC version
- Minimal code to reproduce the issue
- Error messages and stack traces
π External Links
- Europe PMC - The database PyEuropePMC accesses
- REST API - Official API documentation
- GitHub - Source code and development
- PyPI - Package distribution
**π [Browse All Documentation](#) β’ π [Quick Start](/pyEuropePMC/getting-started/quickstart.html) β’ π‘ [Examples](examples/)**
---
**[β¬ Back to Top](#pyeuropepmc-documentation)**
*Made with β€οΈ by the PyEuropePMC team β’ Licensed under [MIT](../LICENSE)*