Complete REST API reference for XeraRetractionTracker. Access retracted papers, citation data, analytics, and democracy analysis programmatically.
The XeraRetractionTracker API provides programmatic access to our comprehensive database of retracted scientific papers, citation analysis, and research integrity tools. All endpoints return JSON responses and support various query parameters for filtering and customization.
Base URL: /api/v1
Authentication: Currently public (no API key required)
Response Format: JSON
Access retracted paper data with advanced filtering and search capabilities
Get paginated list of retracted papers with optional filters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number (default: 1) |
per_page | integer | Optional | Items per page (default: 20, max: 100) |
search | string | Optional | Full-text search query |
retraction_nature | string | Optional | Filter by type: Retraction, Expression of Concern, Correction, Reinstatement |
journal | string | Optional | Filter by journal name |
subject | string | Optional | Filter by subject area |
country | string | Optional | Filter by country |
year_from | integer | Optional | Minimum retraction year |
year_to | integer | Optional | Maximum retraction year |
sort_by | string | Optional | Sort field: retraction_date, title, citation_count |
sort_order | string | Optional | Sort order: asc, desc |
Get detailed information for a specific paper including citation summary
| Parameter | Type | Required | Description |
|---|---|---|---|
recordId | string | Required | Unique record ID of the paper |
Get citations for a specific paper with timing analysis
| Parameter | Type | Required | Description |
|---|---|---|---|
recordId | string | Required | Unique record ID of the paper |
page | integer | Optional | Page number (default: 1) |
per_page | integer | Optional | Items per page (default: 20) |
citation_type | string | Optional | Filter: pre, post, same_day, all |
Get available filter values for journals, subjects, countries, etc.
Citation tracking and post-retraction analysis
Get all citations with filtering options
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number |
per_page | integer | Optional | Items per page |
citation_type | string | Optional | Filter: pre, post, same_day |
sort_by | string | Optional | Sort by: days_after_retraction, citation_date, created_at |
sort_order | string | Optional | Sort order: asc, desc |
Get aggregated citation statistics
Get only post-retraction citations
| Parameter | Type | Required | Description |
|---|---|---|---|
min_days | integer | Optional | Minimum days after retraction |
page | integer | Optional | Page number |
Get recently added citations
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | Optional | Page number |
per_page | integer | Optional | Items per page |
Statistical analysis and visualization data
Get overall statistics dashboard data
Get retraction trends over time
| Parameter | Type | Required | Description |
|---|---|---|---|
granularity | string | Optional | Time granularity: year, quarter, month |
year_from | integer | Optional | Start year |
year_to | integer | Optional | End year |
Get retractions by subject area
Get retractions by country
Get journals with most retractions
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | Optional | Number of results (default: 10, max: 100) |
Get distribution of retraction reasons
Get geographic data with ISO3 country codes for map visualization
Bayesian analysis of democracy and research integrity
Get high-level democracy analysis summary
Get democracy effect on retraction rates
Get data for democracy vs retraction rate scatter plot
Get regional breakdown of democracy data
Get temporal trends in democracy analysis
Get raw country-year panel data
Get methodology documentation
Search and autocomplete functionality
Get search suggestions as user types
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Required | Search query (min 2 characters) |
limit | integer | Optional | Number of suggestions (default: 10, max: 20) |
types | string | Optional | Comma-separated types: title, journal, author, subject |
Advanced search with field-specific queries
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Optional | General search query |
title | string | Optional | Search in title |
author | string | Optional | Search by author |
journal | string | Optional | Search by journal |
doi | string | Optional | Search by DOI |
Get available filter options with counts
Data export in various formats
Export retracted papers data
| Parameter | Type | Required | Description |
|---|---|---|---|
format | string | Optional | Export format: json, csv (default: json) |
limit | integer | Optional | Maximum records (default: 1000) |
retraction_nature | string | Optional | Filter by retraction type |
journal | string | Optional | Filter by journal |
Export citation data
| Parameter | Type | Required | Description |
|---|---|---|---|
format | string | Optional | Export format: json, csv |
Export analytics data
| Parameter | Type | Required | Description |
|---|---|---|---|
format | string | Optional | Export format: json, csv |
Journal integrity and risk assessment
Assess journal for predatory indicators
| Parameter | Type | Required | Description |
|---|---|---|---|
journal | string | Required | Journal name to check |
publisher | string | Optional | Publisher name |
List journals with high retraction rates
Get Think.Check.Submit checklist criteria
// Fetch retracted papers with JavaScript
async function getRetractedPapers() {
const response = await fetch('/api/v1/papers?page=1&per_page=20');
const data = await response.json();
console.log(`Found ${data.total} papers`);
data.items.forEach(paper => {
console.log(paper.title);
});
return data;
}
// Search for papers by journal
async function searchByJournal(journalName) {
const params = new URLSearchParams({
journal: journalName,
sort_by: 'retraction_date',
sort_order: 'desc'
});
const response = await fetch(`/api/v1/papers?${params}`);
return await response.json();
}Need help with the API? Have questions or feedback? We're here to help.
Complete API reference available on this page
a.sofimahmudi@gmail.com
API Version: v1 | Updated: January 2025