grandarchive.com APIgrandarchive.com ↗
Access Grand Archive TCG card database and news articles via API. Search cards by type, class, and element. Fetch Ban & Restricted updates, guides, and champion data.
curl -X GET 'https://api.parse.bot/scraper/ae026817-0799-4e47-893b-1d42bf2f037f/get_articles_list?page=1&page_size=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch a paginated list of articles from the Grand Archive TCG news feed. Returns articles sorted by publication date descending. Supports filtering by category and pagination.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to fetch. |
| category | string | Category to filter by (e.g. news, guide, hidden). Omitting returns all categories. |
| page_size | integer | Number of articles per page. |
{
"type": "object",
"fields": {
"articles": "array of article summary objects with title, intro, slug, url, published_at, categories, hero_image",
"pagination": "object containing page, pageSize, pageCount, total"
},
"sample": {
"data": {
"articles": [
{
"url": "https://www.gatcg.com/article/rules-update-copied-activations",
"slug": "rules-update-copied-activations",
"intro": "A rules update on copying card activations.",
"title": "Rules Update: Copied Activations",
"categories": [
"news"
],
"hero_image": "https://ga-mainsite-common.s3.us-west-2.amazonaws.com/media/Rules_Update_529c5b5f74.jpg",
"published_at": "2026-04-20T22:27:03.380Z"
}
],
"pagination": {
"page": 1,
"total": 227,
"pageSize": 3,
"pageCount": 76
}
},
"status": "success"
}
}About the grandarchive.com API
The Grand Archive API covers 6 endpoints that expose the full Grand Archive TCG card database and official news feed. Use search_cards to query cards by name, type, class, and element — each result includes effect text, editions, cost, level, and circulation data. Separate endpoints handle articles, ban announcements, and champion listings, giving developers a single interface for both game data and editorial content.
Card Database
The search_cards endpoint accepts up to six filter parameters: query (name search), type (CHAMPION, ALLY, ACTION, ITEM, WEAPON, REGALIA, DOMAIN), class (WARRIOR, MAGE, ASSASSIN, CLERIC, RANGER, TAMER, SPIRIT), and element (NORM, FIRE, WATER, WIND, ARCANE, LUXEM, TERA, UMBRA, CRUX, ASTRA). Each card object in the data array returns name, classes, element, types, effect, editions, level, life, cost, and slug. Pagination is handled via page and page_size (max 50); the response includes total_cards, total_pages, and a has_more boolean. The get_champions endpoint is a focused variant that returns only CHAMPION-type cards with the same field structure.
News and Articles
get_articles_list returns a paginated feed of articles sorted by publication date descending. Each summary object includes title, intro, slug, url, published_at, categories, and hero_image. You can filter by category (e.g. news, guide, hidden) and control page size. For full article content, pass the slug to get_article_detail, which returns the complete HTML body alongside all metadata fields. get_latest_articles skips pagination and returns the most recent N articles (1–50) directly.
Ban & Restricted Tracking
get_ban_and_restricted_articles returns all articles with "Ban" in the title, sorted by publication date descending. Unlike the list endpoints, this one returns the full body HTML for each matching article without requiring a separate detail call — useful for parsing rule change history or building a ban timeline.
- Build a card search tool filtered by element and class using
search_cardsresponse fields likeeffect,cost, andeditions. - Track Ban & Restricted announcement history with
get_ban_and_restricted_articles, which returns full HTML body per article. - Populate a champion roster page using
get_championswithlevel,life, andelementfields. - Display a TCG news feed with publication dates and hero images via
get_articles_list. - Render full article pages for guides and announcements using
get_article_detailHTML body content. - Monitor new card releases by polling
get_latest_articleswith alimitparameter and checkingpublished_attimestamps. - Cross-reference card
editionsandslugdata to link card database entries to official announcement articles.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Grand Archive have an official developer API?+
What does `search_cards` return for each card, and how granular are the filters?+
name, effect text, editions, element, types, classes, level, life, cost, and slug. You can combine type, class, element, and query filters in a single request. Results are paginated with total_cards and has_more to handle large result sets.Does `get_ban_and_restricted_articles` require any input parameters?+
body HTML included — unlike the standard list endpoints, which return summaries only and require a follow-up get_article_detail call for body content.Does the API expose individual card rulings, errata, or card-specific Q&A?+
get_article_detail, but there is no dedicated per-card rulings endpoint. You can fork this API on Parse and revise it to add a targeted rulings or errata endpoint.Is article category filtering available, and what categories exist?+
get_articles_list accepts a category parameter. Documented example values include news, guide, and hidden. Omitting the parameter returns articles across all categories. Category names are also returned in each article's categories array, so you can discover additional values from live responses.