Kurogames APIwutheringwaves.kurogames.com ↗
Fetch news, notices, and event articles from the official Wuthering Waves website. Paginated feeds and full article bodies across all supported languages.
What is the Kurogames API?
The Wuthering Waves News API gives developers access to the official Kuro Games news feed through 2 endpoints, returning article summaries and full article bodies. The list_news endpoint returns paginated summaries with titles, category labels, publish timestamps, and a per-language category list. The get_article endpoint returns the complete article including HTML body, plain-text rendering, embedded image URLs, and display end times.
curl -X GET 'https://api.parse.bot/scraper/5d6f36c5-a5fc-40f5-8c15-9aa24c61a681/list_news?language=en' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the site's news feed for one language, newest first by publish time, as pages of article summaries. Two fixed round trips per call regardless of page. The response also carries the `categories` list for that language (each with `category_id` and its localized label); pass one of those ids as `category_id` to restrict the feed to one category — category ids differ per language, so use the ids returned for the same language. Paging is caller-controlled with `page` (1-based, default 1) and `page_size` (default 20, clamped to 100); `total` and `has_more` describe the filtered feed. A page past the end returns an empty `items` array with success. An unknown `category_id` for the language returns a not-found input error.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page number over the filtered feed. |
| language | string | Site language of the feed. Article ids and category ids are specific to a language. |
| page_size | integer | Articles per page; values above 100 are clamped to 100. |
| category_id | string | Numeric category id from `categories[*].category_id` of this endpoint for the same language (e.g. one shape: the English 'Notice' category). Omitted = all categories. |
{
"type": "object",
"fields": {
"page": "integer page returned",
"items": "array of article summaries: article_id (integer, input for get_article), title, category (localized label), category_id, published_at and created_at (site-local 'YYYY-MM-DD HH:MM:SS'), pinned (boolean), cover_image and description (null when the site provides none), url (public article page)",
"total": "integer count of articles in the filtered feed",
"has_more": "boolean, whether a later page exists",
"language": "language code the feed was fetched in",
"page_size": "integer effective page size after clamping",
"categories": "array of {category_id, category} available for this language"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://wutheringwaves.kurogames.com/en/main/news/detail/5429",
"title": "Resonator Review | Futures' Tithe — Hiyuki",
"pinned": false,
"category": "Notice",
"article_id": 5429,
"created_at": "2026-09-08 14:57:55",
"category_id": 58,
"cover_image": null,
"description": null,
"published_at": "2026-09-08 18:00:00"
},
{
"url": "https://wutheringwaves.kurogames.com/en/main/news/detail/5428",
"title": "Upcoming Events in Wuthering Waves Version 3.6",
"pinned": false,
"category": "Notice",
"article_id": 5428,
"created_at": "2026-09-08 14:25:20",
"category_id": 58,
"cover_image": null,
"description": null,
"published_at": "2026-09-08 16:00:00"
}
],
"total": 681,
"has_more": true,
"language": "en",
"page_size": 2,
"categories": [
{
"category": "Notice",
"category_id": 58
},
{
"category": "News",
"category_id": 57
},
{
"category": "Event",
"category_id": 59
}
]
},
"status": "success"
}
}About the Kurogames API
Endpoints and Data Shape
The API exposes two endpoints. list_news returns a paginated feed of article summaries for a given language, defaulting to the newest articles first. Each item in the items array includes article_id, title, category, category_id, and published timestamp. The response also carries a categories array — each entry has a category_id and its localized label — which you can use to filter subsequent calls via the category_id parameter. Page size is controlled by page_size and clamped to a maximum of 100; has_more and total let you implement pagination cleanly.
Article Retrieval and Language Handling
get_article takes an article_id (as returned in list_news) and a language code to return the full article. The response includes content_html (the raw HTML body), content_text (a plain-text rendering), images (an array of embedded image URLs), end_time (display end time as set by the publisher), category, category_id, and a canonical url for the public article page. Note that content_text is an empty string when the article body consists entirely of images — this is common for Japanese-language notices.
Language and Category Scoping
Article IDs and category IDs are language-specific. An article_id returned for one language is not guaranteed to be valid for another. Similarly, category_id values from list_news for one language should not be passed to a feed request for a different language. Always retrieve the categories array from a list_news call in your target language before filtering by category.
The Kurogames API is a managed, monitored endpoint for wutheringwaves.kurogames.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wutheringwaves.kurogames.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official wutheringwaves.kurogames.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a localized in-game news ticker using
list_newswith a specificlanguageandcategory_id - Archive all Wuthering Waves event announcements by paginating
list_newsand storingarticle_idandpublishedfields - Build a multilingual game news aggregator by calling
list_newsfor each supported language in parallel - Parse
end_timefromget_articleto automatically expire or flag event articles that have ended - Extract
imagesfromget_articleto assemble a media gallery of official game artwork and promotional banners - Monitor new notices by polling
list_newspage 1 and comparing the latestpublishedtimestamp against a stored checkpoint
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wuthering Waves have an official public developer API?+
How does category filtering work in list_news, and where do valid category IDs come from?+
list_news response includes a categories array for the requested language, where each entry has a category_id and its localized label. Pass one of those category_id values back as the category_id parameter on a subsequent list_news call for the same language to filter the feed. Category IDs are language-scoped, so retrieve them fresh when switching languages.Why is content_text empty for some articles?+
content_text returns an empty string. This is particularly common for Japanese-language notice articles. The content_html field and the images array will still be populated in those cases.Does the API cover player account data, gacha history, or character statistics?+
list_news and get_article. You can fork this API on Parse and revise it to add an endpoint targeting a different part of the site.Are articles from all regional versions of the site available, or only one?+
language parameter on both list_news and get_article selects among the language editions the site itself supports. Article IDs are specific to each language, so the same news item may have a different article_id depending on the language requested. Cross-language deduplication is not provided by the API.