Fengsuitang APIfengsuitang.com ↗
Access Taoist calendar data, forum articles, and cultural products from fengsuitang.com via 4 structured endpoints covering lunar dates, gan-zhi, and auspicious activities.
What is the Fengsuitang API?
The Fengsuitang.com API exposes 4 endpoints covering the discussion forum, product catalog, and Taoist calendar data from this Hong Kong-based Taoist cultural organization. The get_taoist_calendar endpoint returns daily entries with Heavenly Stems and Earthly Branches (干支), lunar date information, auspicious and inauspicious activities, Taoist festivals, and zodiac data for any date range up to roughly 40 days.
curl -X GET 'https://api.parse.bot/scraper/4e9b0be2-dadd-4747-b873-0b7b06743a22/list_articles?sort=latest&page=1&page_size=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fengsuitang-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Feng Sui Tang SDK — articles, products, and Taoist calendar."""
from parse_apis.fengsuitang_com_api import FengSuiTang, ArticleSort, ArticleNotFound
client = FengSuiTang()
# Browse hot articles, capped at 5 total items
for summary in client.article_summaries.list(sort=ArticleSort.HOT, limit=5):
print(summary.title, f"❤ {summary.like_num}")
# Drill into the first result's full content via summary→detail navigation
summary = client.article_summaries.list(search="修道", limit=1).first()
if summary is not None:
article = summary.details()
print(article.title, article.created_at, f"by {article.poster_name}")
print(article.content[:200])
# Point-lookup by a known ID (derived from the previous search hit)
if summary is not None:
try:
detail = client.articles.get(article_id=str(summary.id))
print(detail.title, detail.like_num)
except ArticleNotFound:
print("Article was removed")
# List products with pricing
for product in client.products.list(page_size=3, limit=6):
print(product.name, f"HK${product.price}", product.code)
# Taoist calendar for a week
for day in client.calendar_days.list(start_date="2026-08-01", end_date="2026-08-07", limit=7):
print(day.solar_date.year, day.solar_date.month, day.solar_date.day,
day.lunar_info.month, day.lunar_info.day,
"宜:", day.yi, "忌:", day.ji)
print("exercised: article_summaries.list / details / articles.get / products.list / calendar_days.list")
List articles from the Feng Sui Tang discussion forum with pagination, sorting, and search. Returns article summaries with metadata. One API call per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for articles. |
| search | string | Search query to filter articles by title, tags, or author name. Empty string returns all. |
| page_size | integer | Number of articles per page (1-50). |
{
"type": "object",
"fields": {
"articles": "array of article summaries with id, title, content_preview, cover, created_at, poster_name, poster_avatar, like_num, comment_num",
"pagination": "object with current_page, next_page, page_size, prev_page, total_count, total_page"
},
"sample": {
"articles": [
{
"id": 273,
"cover": "https://media.seeronnet.com/other/c2ecafe41333b56428132a9717628975-2848x1600.png",
"title": "拂塵見本心，順道度余生｜藏在道德經裏的清醒智慧",
"like_num": 300,
"created_at": "2026-07-07 11:13:18",
"comment_num": 0,
"poster_name": "楓燧堂-山雨師兄",
"poster_avatar": "https://media.seeronnet.com/other/9f53cb4bccb911b73368a22f22b0b053-800x800.jpg",
"content_preview": "行走世間，總能遇見兩種反差極強的人..."
}
],
"pagination": {
"next_page": 2,
"page_size": 4,
"prev_page": 1,
"total_page": 63,
"total_count": 249,
"current_page": 1
}
}
}About the Fengsuitang API
Articles and Forum Content
The list_articles endpoint retrieves paginated summaries from the Feng Sui Tang discussion forum. Each result includes id, title, content_preview, cover, created_at, poster_name, poster_avatar, like_num, and comment_num. You can filter by search (matching title, tags, or author name), control ordering with sort, and set page_size between 1 and 50. To retrieve the complete article body, pass the numeric article_id from those results to get_article, which returns the full HTML content field along with like counts, timestamps, and the author's display name.
Taoist Calendar
The get_taoist_calendar endpoint accepts a start_date and end_date in ISO YYYY-MM-DD format and returns one entry per day. Each day object includes solar_date, lunar_info, gan_zhi (the traditional Heavenly Stems and Earthly Branches cycle), taoist_date, week, current_year_animal, and the yi field listing auspicious activities for that day. The maximum practical range is about 40 days per call; total_days in the response confirms how many entries were returned.
Products
The list_products endpoint lists active items in the Fengsuitang catalog — bracelets, ritual items, and prayer services. Each product record carries id, code, name, price, description, img_url, category_id, product_sku, is_shipment, and created_at. Pagination works the same way across all list endpoints: the pagination object returns current_page, next_page, prev_page, total_count, and total_page so you can walk the full dataset without guessing offsets.
The Fengsuitang API is a managed, monitored endpoint for fengsuitang.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fengsuitang.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 fengsuitang.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?+
- Build a Taoist almanac app that surfaces daily auspicious activities using the
yifield fromget_taoist_calendar. - Display lunar calendar data alongside the Gregorian date by mapping
lunar_infoandgan_zhifields for a given date range. - Aggregate Taoist festival dates from the
taoist_datefield to power event reminders or scheduling tools. - Index Fengsuitang forum content for search by ingesting
list_articlesresults and full HTML fromget_article. - Build a product browser for cultural and ritual items using
list_productswith SKU-level detail and shipment flags. - Track article engagement trends by monitoring
like_numandcomment_numacross paginated forum results. - Sync zodiac and year-animal data from the calendar endpoint into a personal calendar or horoscope feature.
| 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 | 100 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 fengsuitang.com offer an official developer API?+
What does the `get_taoist_calendar` endpoint return for each day?+
solar_date, lunar_info, gan_zhi (Heavenly Stems and Earthly Branches), taoist_date, week, current_year_animal, and the yi field for auspicious activities. The recommended maximum range per request is about 40 days, and total_days in the response confirms the count.Can I retrieve individual article comments or user profiles?+
list_articles, full article content via get_article, and engagement counts (like_num, comment_num), but does not expose comment threads or user profile pages. You can fork this API on Parse and revise it to add those endpoints.Does the articles endpoint support full-text search across article bodies?+
search parameter on list_articles filters by title, tags, or author name. It does not search within full article body content. Full HTML body text is only returned by get_article for a single article at a time. You can fork this API on Parse and revise it to add body-level search if the source supports it.Is the `inauspicious` (凶) activity data available alongside the auspicious (`yi`) field?+
yi field for auspicious activities. Inauspicious activity data (ji/凶) is not listed as a returned field in the current calendar endpoint. You can fork this API on Parse and revise it to surface that field if it appears in the source calendar data.