Developer API Documentation
Programmatically query indexed open-access research articles, metadata, citation details, and indexing statistics.
Base Endpoint URL
https://www.discovery.rsyn.org/api/v1
All API requests return standardized JSON data structures.
🔒 Credential Required
• Auth: Bearer Token / X-API-KEY
• Rate Limit: 60 req/min
• Unauthorized: HTTP 401 Error
• Max Pagination: 100 items
All API endpoints strictly require authentication credentials. Unauthenticated requests will receive HTTP 401 Unauthorized.
Option 1: Bearer Token Header (Recommended)
Authorization: Bearer YOUR_API_TOKEN
Option 2: Custom X-API-KEY Header
X-API-KEY: YOUR_API_KEY
Response Rate Limit Headers
Every response includes standard rate limit headers to monitor your quota:
X-RateLimit-Limit: 60 (Maximum requests allowed per minute window)
X-RateLimit-Remaining: 59 (Remaining requests available in current window)
/api/v1/articles
Fetch paginated list of indexed open-access research articles with filtering options.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| q | string | Search term for title, abstract, DOI, or keyword |
| type | string | Filter by type (`article`, `review`, `conference_paper`) |
| per_page | integer | Results per page (default: 20, max: 100) |
Sample cURL Request with Credentials
curl -X GET "https://www.discovery.rsyn.org/api/v1/articles?q=quantum&per_page=10" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"
/api/v1/articles/{slug}
Fetch complete metadata, authors, DOI, and citations for a specific article.
Sample Python Request with Headers
import requests
headers = {
"Authorization": "Bearer YOUR_API_TOKEN",
"Accept": "application/json"
}
response = requests.get("https://www.discovery.rsyn.org/api/v1/articles/physics-at-a-fermilab-proton-driver", headers=headers)
data = response.json()
print(data['title'], data['doi'])
/api/v1/stats
Retrieve aggregate statistics on total indexed research articles, sources, and open-access counts.