API Documentation

Complete REST API reference for XeraRetractionTracker. Access retracted papers, citation data, analytics, and democracy analysis programmatically.

v1
API Version
7
Categories
30+
Endpoints

API Overview

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.

Key Features

  • 65,000+ retracted papers from Retraction Watch database
  • Post-retraction citation tracking and analysis
  • Bayesian democracy analysis with statistical results
  • Real-time analytics and trend data
  • Advanced filtering with 15+ parameters
  • JSON and CSV export formats
  • Predatory journal risk assessment
Rate Limits
  • General Endpoints: 100 requests/minute per IP
  • Export Endpoints: 10 requests/minute per IP
  • Analytics Endpoints: 50 requests/minute per IP

Base URL: /api/v1

Authentication: Currently public (no API key required)

Response Format: JSON

API Endpoints

Papers

Access retracted paper data with advanced filtering and search capabilities

GET

List Papers

Get paginated list of retracted papers with optional filters

/api/v1/papers
Parameters
ParameterTypeRequiredDescription
pageintegerOptionalPage number (default: 1)
per_pageintegerOptionalItems per page (default: 20, max: 100)
searchstringOptionalFull-text search query
retraction_naturestringOptionalFilter by type: Retraction, Expression of Concern, Correction, Reinstatement
journalstringOptionalFilter by journal name
subjectstringOptionalFilter by subject area
countrystringOptionalFilter by country
year_fromintegerOptionalMinimum retraction year
year_tointegerOptionalMaximum retraction year
sort_bystringOptionalSort field: retraction_date, title, citation_count
sort_orderstringOptionalSort order: asc, desc
GET

Get Paper Details

Get detailed information for a specific paper including citation summary

/api/v1/papers/{recordId}
Parameters
ParameterTypeRequiredDescription
recordIdstringRequiredUnique record ID of the paper
GET

Get Paper Citations

Get citations for a specific paper with timing analysis

/api/v1/papers/{recordId}/citations
Parameters
ParameterTypeRequiredDescription
recordIdstringRequiredUnique record ID of the paper
pageintegerOptionalPage number (default: 1)
per_pageintegerOptionalItems per page (default: 20)
citation_typestringOptionalFilter: pre, post, same_day, all
GET

Get Filter Options

Get available filter values for journals, subjects, countries, etc.

/api/v1/papers/filter-options

Citations

Citation tracking and post-retraction analysis

GET

List Citations

Get all citations with filtering options

/api/v1/citations
Parameters
ParameterTypeRequiredDescription
pageintegerOptionalPage number
per_pageintegerOptionalItems per page
citation_typestringOptionalFilter: pre, post, same_day
sort_bystringOptionalSort by: days_after_retraction, citation_date, created_at
sort_orderstringOptionalSort order: asc, desc
GET

Citation Summary

Get aggregated citation statistics

/api/v1/citations/summary
GET

Post-Retraction Citations

Get only post-retraction citations

/api/v1/citations/post-retraction
Parameters
ParameterTypeRequiredDescription
min_daysintegerOptionalMinimum days after retraction
pageintegerOptionalPage number
GET

Recent Citations

Get recently added citations

/api/v1/citations/recent
Parameters
ParameterTypeRequiredDescription
pageintegerOptionalPage number
per_pageintegerOptionalItems per page

Analytics

Statistical analysis and visualization data

GET

Analytics Summary

Get overall statistics dashboard data

/api/v1/analytics/summary
GET

Retraction Trends

Get retraction trends over time

/api/v1/analytics/trends
Parameters
ParameterTypeRequiredDescription
granularitystringOptionalTime granularity: year, quarter, month
year_fromintegerOptionalStart year
year_tointegerOptionalEnd year
GET

Subject Distribution

Get retractions by subject area

/api/v1/analytics/subjects
GET

Country Distribution

Get retractions by country

/api/v1/analytics/countries
GET

Top Journals

Get journals with most retractions

/api/v1/analytics/journals
Parameters
ParameterTypeRequiredDescription
limitintegerOptionalNumber of results (default: 10, max: 100)
GET

Retraction Reasons

Get distribution of retraction reasons

/api/v1/analytics/reasons
GET

World Map Data

Get geographic data with ISO3 country codes for map visualization

/api/v1/analytics/world-map

Democracy Analysis

Bayesian analysis of democracy and research integrity

GET

Overview

Get high-level democracy analysis summary

/api/v1/democracy/overview
GET

Democracy Effects

Get democracy effect on retraction rates

/api/v1/democracy/effects
GET

Scatter Plot Data

Get data for democracy vs retraction rate scatter plot

/api/v1/democracy/scatter
GET

Regional Analysis

Get regional breakdown of democracy data

/api/v1/democracy/regional
GET

Temporal Trends

Get temporal trends in democracy analysis

/api/v1/democracy/temporal
GET

Raw Data

Get raw country-year panel data

/api/v1/democracy/raw-data
GET

Methodology

Get methodology documentation

/api/v1/democracy/methodology

Search

Search and autocomplete functionality

GET

Autocomplete

Get search suggestions as user types

/api/v1/search/autocomplete
Parameters
ParameterTypeRequiredDescription
qstringRequiredSearch query (min 2 characters)
limitintegerOptionalNumber of suggestions (default: 10, max: 20)
typesstringOptionalComma-separated types: title, journal, author, subject
GET

Advanced Search

Advanced search with field-specific queries

/api/v1/search/advanced
Parameters
ParameterTypeRequiredDescription
qstringOptionalGeneral search query
titlestringOptionalSearch in title
authorstringOptionalSearch by author
journalstringOptionalSearch by journal
doistringOptionalSearch by DOI
GET

Filter Options

Get available filter options with counts

/api/v1/search/filters

Export

Data export in various formats

GET

Export Papers

Export retracted papers data

/api/v1/export/papers
Parameters
ParameterTypeRequiredDescription
formatstringOptionalExport format: json, csv (default: json)
limitintegerOptionalMaximum records (default: 1000)
retraction_naturestringOptionalFilter by retraction type
journalstringOptionalFilter by journal
GET

Export Citations

Export citation data

/api/v1/export/citations
Parameters
ParameterTypeRequiredDescription
formatstringOptionalExport format: json, csv
GET

Export Analytics

Export analytics data

/api/v1/export/analytics
Parameters
ParameterTypeRequiredDescription
formatstringOptionalExport format: json, csv

Predatory Journals

Journal integrity and risk assessment

GET

Check Journal

Assess journal for predatory indicators

/api/v1/predatory/check
Parameters
ParameterTypeRequiredDescription
journalstringRequiredJournal name to check
publisherstringOptionalPublisher name
GET

High-Risk Journals

List journals with high retraction rates

/api/v1/predatory/high-risk
GET

Checklist

Get Think.Check.Submit checklist criteria

/api/v1/predatory/checklist

Code Examples

// 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();
}

Support & Contact

Need help with the API? Have questions or feedback? We're here to help.

Documentation

Complete API reference available on this page

Email Support

a.sofimahmudi@gmail.com

API Version: v1 | Updated: January 2025