Developers

Vidwana offers a free, read-only REST API and a standard OAI-PMH endpoint. No API key needed — just be reasonable (120 requests per minute per IP). All responses are JSON with open CORS, so you can call them straight from a browser app.

REST API v1

GET/api/v1/publications

List / search publications (relevance-ranked).

Query params: q, discipline, page, per_page (max 50)

GET/api/v1/publications/{slug}

Full record for one publication — metadata, authors, citation metrics, PDF link.

GET/api/v1/researchers/{username}

Public researcher profile with publications and aggregate metrics.

GET/api/v1/journals

All journals with ISSNs and publication counts.

GET/api/v1/conferences

Approved conferences with dates, venue, and paper counts.

Example

curl "https://vidwana.com/api/v1/publications?q=machine+learning&per_page=5"

{
  "meta": { "page": 1, "per_page": 5, "total": 12 },
  "data": [
    {
      "slug": "a-systematic-literature-review-...",
      "title": "A Systematic Literature Review on ...",
      "doi": "10.18535/ijsrm/...",
      "authors": ["..."],
      "citations": 134,
      "reads": 480,
      "url": "https://vidwana.com/publications/..."
    }
  ]
}

Responses are cached for 60 seconds. Please cite Vidwana when you use the data.

OAI-PMH (for harvesters)

The full repository is harvestable over the standard OAI-PMH 2.0 protocol (Dublin Core), used by aggregators like BASE, CORE, and OpenAIRE. Both GET and POST are supported.

Base URL:  https://vidwana.com/api/oai

https://vidwana.com/api/oai?verb=Identify
https://vidwana.com/api/oai?verb=ListRecords&metadataPrefix=oai_dc
https://vidwana.com/api/oai?verb=ListSets

Publisher submission API

If you run your own publishing system for a journal already on Vidwana (your own OJS-style software, a custom pipeline, or in future our official OJS plugin), you can push published articles — metadata and PDF together — directly into your journal. Generate a key from your journal's manage page (Publisher → Journals → your journal → API access). The journal must be approved on Vidwana first.

POST https://vidwana.com/api/v1/intake/publications
Authorization: Bearer vdk_live_...
Content-Type: multipart/form-data

title            (required)
abstract         (required)
authors          (required) JSON array:
                  [{"name":"Jane Smith","affiliation":"MIT","orcid":"0000-0000-0000-0000"}]
publicationDate  (required) ISO date, e.g. 2026-01-15
doi              (optional)
volume, issue, pages   (optional)
keywords         (optional) comma-separated
discipline       (optional)
type             (optional) JOURNAL_ARTICLE | CONFERENCE_PAPER | PREPRINT | THESIS | BOOK_CHAPTER | DATASET | OTHER
externalId       (optional) your own article id — re-submitting the same
                  externalId updates the publication instead of duplicating it
pdfVisibility    (optional) PUBLIC (default) | PRIVATE
pdf              (optional, recommended) the article PDF file

curl -X POST "https://vidwana.com/api/v1/intake/publications" \
  -H "Authorization: Bearer vdk_live_..." \
  -F title="A Systematic Review of ..." \
  -F abstract="This review examines ..." \
  -F 'authors=[{"name":"Jane Smith","affiliation":"MIT"}]' \
  -F publicationDate=2026-01-15 \
  -F doi=10.1234/example.2026.001 \
  -F pdf=@article.pdf

# Response: 201 Created (or 200 if updating an existing externalId)
{ "data": { "id": "...", "slug": "...", "url": "https://vidwana.com/publications/...", "doi": "..." } }

Rate limit: 60 submissions/minute per journal key. Authors without a Vidwana account get a claimable placeholder profile automatically. Keep your key secret — anyone with it can publish into your journal; revoke and regenerate any time from the journal's manage page.