Home/API Access
Developer

API Access

Integrate GlobalDocsHub's verified medical research index into your applications, clinical systems, and academic tools via our REST API.

Overview

The GlobalDocsHub REST API provides programmatic access to our entire verified medical research index. All responses are returned in JSON format over HTTPS.

Base URL:

https://api.globaldocshub.com/v1

All API endpoints require authentication via Bearer token. API keys can be obtained through the Developer Portal after institutional verification.

Authentication

All API requests must include your API key in the Authorization header.

Request Headers

Authorization: Bearer gdh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json
Accept: application/json
gdh_live_*
Production

Full access to all endpoints. Rate limits apply.

gdh_test_*
Sandbox

Test environment with synthetic data. No rate limits.

Rate Limits

PlanRequests / MinuteRequests / DayBulk Access
Free (Research) 60 5,000 No
Academic 300 50,000 Yes
Institutional 1,000 500,000 Yes
Enterprise Unlimited Unlimited Yes

Publications Endpoint

GET /v1/publications List verified publications

Query params: specialty, year, author_orcid, type, limit, offset

{
  "data": [
    {
      "id": "pub_a7f3c2d1",
      "title": "High-Risk Pregnancy Management: A Retrospective Cohort Study",
      "authors": ["Onur Ersun", "A. Çelik"],
      "journal": "Obstetrics & Gynecology",
      "doi": "10.1016/j.ob.2024.08.002",
      "published": "2024-09",
      "specialty": "obstetrics-gynecology",
      "type": "peer-reviewed",
      "sha256": "e3b0c44298fc1c149afbf4c8996fb924...",
      "open_access": false,
      "pdf_url": "https://api.globaldocshub.com/v1/publications/pub_a7f3c2d1/pdf"
    }
  ],
  "meta": { "total": 12418, "limit": 20, "offset": 0 }
}
GET /v1/publications/{id} Get single publication by ID

Returns full metadata, SHA-256 hash, and PDF access token

# cURL example
curl -X GET \
  "https://api.globaldocshub.com/v1/publications/{id}" \
  -H "Authorization: Bearer gdh_live_your_api_key"
GET /v1/publications/search Full-text search

Query params: q (required), filters, sort

# cURL example
curl -X GET \
  "https://api.globaldocshub.com/v1/publications/search" \
  -H "Authorization: Bearer gdh_live_your_api_key"
GET /v1/publications/doi/{doi} Look up by DOI

Accepts URL-encoded DOI strings

# cURL example
curl -X GET \
  "https://api.globaldocshub.com/v1/publications/doi/{doi}" \
  -H "Authorization: Bearer gdh_live_your_api_key"

Physicians Endpoint

GET /v1/physicians/{slug} 
{
  "data": {
    "slug": "dronurersun",
    "specialty": "Obstetrics & Gynecology",
    "institution": "Ahmet Yesevi University",
    "verified": true,
    "verified_since": "2024-01-15",
    "publications_count": 24,
    "profile_url": "https://dronurersun.globaldocshub.com",
    "verification_hash": "sha256:d4a3f9..."
  }
}

SDKs & Libraries

Python
pip install globaldocshub

Full async support, Pandas integration

JavaScript
npm install @globaldocshub/sdk

Node.js & browser compatible

R
install.packages("globaldocshub")

Designed for statistical and biomedical research

Request API Access

Complete the form below to apply for an API key. All applicants undergo institutional verification before a key is issued. Sandbox keys are available immediately upon approval.