API Reference

Both endpoints share the exact same request format; only the returned content differs.

• Base URL: https://api.byteslink.cn/journals
• Protocol: HTTPS, both requests and responses are JSON
• Encoding: UTF-8

Common Request Body

{
  "journals": ["J Med Chem", "CLINICAL SOCIAL WORK JOURNAL"]
}

Field	Type	Required	Description
journals	string[]	Yes	List of journal names, 1–20 items, each name ≤ 200 characters; blank entries are ignored

Common response outer structure:

Field	Description
count	Number of journals queried in this request
results	Result array, in the same order as the request
usage	Billing and remaining quota information for this request

---

Query Impact Factor / Quartile

POST /dev/impact-factors/

Data is compiled from publicly available information on the internet.

Response Example

{
  "count": 2,
  "results": [
    {
      "query": "J Med Chem",
      "found": true,
      "impact_factor": {
        "JIF": "6.8",
        "JIF5": "7.2",
        "Q": "1",
        "N": "1"
      }
    },
    {
      "query": "CLINICAL SOCIAL WORK JOURNAL",
      "found": true,
      "impact_factor": {
        "JIF": "1.6",
        "JIF5": "2.7",
        "Q": "2",
        "N": "3"
      }
    }
  ],
  "usage": {
    "source": "free",
    "free_used": 1
  }
}

impact_factor Fields

Field	Description
JIF	Latest impact factor
JIF5	Five-year impact factor
Q	JCR quartile (1–4, corresponding to Q1–Q4)
N	CAS quartile (Tier 1–4)

found: false indicates the journal is not indexed in JCR or the name did not match.

---

Warning / Predatory Journal Check

POST /dev/warnings/

Checks whether a journal appears on any warning / predatory journal list. Two sources are currently covered:

code	Name	Version	Description
warning	International Journal Early Warning List	2025	Published by the CAS Literature and Information Center, 130+ journals
predatoryjournals_org	Predatory Journal	2025	Published by predatoryjournals.org, ~2800 journals

A hit on any single source sets is_warning to true. This is a boolean safety check, suitable for flagging in red before submission or when rendering literature entries.

Response Example

{
  "count": 1,
  "results": [
    {
      "query": "Aerospace",
      "is_warning": true,
      "sources": [
        {
          "code": "warning",
          "name": "预警名单",
          "name_en": "International Journal Early Warning List",
          "version": "2025",
          "desc": "由中国科学院文献情报中心发布，总计130+种期刊",
          "desc_en": "Published by the Institute of Literature and Information of the Chinese Academy of Sciences, ~130+ journals"
        },
        {
          "code": "predatoryjournals_org",
          "name": "掠夺性期刊",
          "name_en": "Predatory Journal",
          "version": "2025",
          "desc": "由 predatoryjournals.org 发布，总计约2800种掠夺性期刊",
          "desc_en": "Published by predatoryjournals.org, ~2800 predatory journals"
        }
      ]
    }
  ],
  "usage": {
    "source": "free",
    "free_used": 5
  }
}

Result Fields

Field	Description
query	The original queried name
is_warning	Whether the journal hits any list (sources is an empty array when there is no hit)
sources	Array of matched list sources; there may be more than one

sources Element Fields

Field	Description
code	Source identifier: warning / predatoryjournals_org
name / name_en	Source name (Chinese / English)
version	List version year
desc / desc_en	Source description (Chinese / English)

Clients only need to make a boolean judgment based on is_warning, and may use sources to show the specific warning source when needed.

Related Links

• See the integration examples document (Zotero plugin, OpenClaw Skill, literature management tools, etc.).
• Try it online