Leina 
Wanta 
Read an Almanac
Retrieve the full almanac for a Gregorian date.
/oo TianAPI: Get full almanac for [date] and summarize the returned lunar calendar and activities.
Connect TianAPI to Your AI Agent
Use AI with TianAPI to retrieve almanac and horoscope records for a supplied date.
21 tools API key
Try a TianAPI Task
Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.
oo Skill TianAPI
Read a Horoscope
Retrieve a constellation horoscope for a date.
/oo TianAPI: Get horoscope for sign [sign] on [date], labeling it as cultural content.
Start Working with TianAPI
-
Install OOMOL
Set up oo CLI and the oo Skill in your agent.
Install OOMOL → -
Connect TianAPI
Provide a TianAPI key and enable Account Information API before connecting; enable business APIs separately.
Connect TianAPI → -
Give Your Agent a Task
Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →
Choose Your Agent
- A TianAPI account with the requested APIs enabled and free quota or TianDou credits.
- Connection validation makes one billable account query, using free quota first. Horoscope and almanac data are cultural content, not factual predictions.
TianAPI Tools
Use AI with TianAPI to retrieve almanac and horoscope records for a supplied date.
Read an Almanac
Retrieve the full almanac for a Gregorian date.
Read a Horoscope
Retrieve a constellation horoscope for a date.
21 tools
Get Daily Horoscope
Query a constellation's horoscope for a date, defaulting to today when omitted. Includes overall, love, work, wealth, health, and lucky attributes. Enable TianAPI Star Horoscope (78). For entertainment only.
tianapi.get_daily_horoscope Get Constellation Compatibility
Query a single constellation's interpretation, a pair of constellations, or its compatibility with all constellations. Omit otherSign for the single mode or set compareWithAll for all pairings. Enable TianAPI Constellation Pairing (42). For entertainment only.
tianapi.get_constellation_compatibility Get Almanac
Query the traditional Chinese almanac, including auspicious activities, taboos, lunar dates, zodiac animals, and heavenly stems. Supports Gregorian dates or Unix timestamps, and lunar dates when calendar is lunar. Omitted dates use today. Years 1970-2038. Enable TianAPI Chinese Almanac (45).
tianapi.get_almanac Get Full Almanac
Query the full Chinese almanac for a Gregorian date, defaulting to today. Includes lunar dates, zodiac animals, auspicious and inauspicious gods, directions, and seasonal information. Years 1900-2100. This endpoint does not accept lunar-date input. Enable TianAPI Chinese Almanac (45).
tianapi.get_full_almanac Get Zodiac Compatibility
Query compatibility interpretations for two Chinese zodiac animals, preserving the different gender combinations. Enable TianAPI Chinese Zodiac Pairing (83). For entertainment only.
tianapi.get_zodiac_compatibility List Zodiac Compatibilities
Compare one Chinese zodiac animal with the other 11 animals, optionally including itself. The connector makes 11 or 12 official pairing requests, consuming that many calls, with requests spaced below the ordinary-account 3 QPS limit. Enable TianAPI Chinese Zodiac Pairing (83). For entertainment only.
tianapi.list_zodiac_compatibilities Get Blood Type Compatibility
Query a traditional ABO blood-type pairing interpretation. Enable TianAPI Blood Type Pairing (84). For entertainment only, not a medical compatibility assessment.
tianapi.get_blood_type_compatibility Get Birthday Personality
Query the personality interpretation for a birthday's month and day; no birth year is required. Enable TianAPI Birthday Personality (27). For entertainment only.
tianapi.get_birthday_personality Search Dream Interpretations
Search traditional Zhou Gong dream interpretations by keyword with pagination. Enable TianAPI Dream Interpretation (24). For entertainment only.
tianapi.search_dream_interpretations Get Number Fortune
Query a traditional numerology interpretation for a number such as a phone, room, or vehicle number. Preserve leading zeros by passing a string. Enable TianAPI Number Fortune (105). For entertainment only.
tianapi.get_number_fortune Get Solar Term
Query one of the 24 Chinese solar terms, including its meaning, customs, poetry, and foods. An optional year requests exact Gregorian and lunar date information. Enable TianAPI Solar Terms (86).
tianapi.get_solar_term Query Holidays
Query Chinese holidays, working days, make-up working days, lunar information, and optional international festivals. Supports dates, a month, a date range, or annual official holidays. Non-annual queries contain at most 31 dates. Enable TianAPI Holidays (139).
tianapi.query_holidays Get Account Usage
Query TianAPI account membership, remaining TianDou credits, and usage for an API ID. Enable the Account Information API (96) first; this request consumes its quota or TianDou credits.
tianapi.get_account_usage List Network Trending
List aggregated trending topics across Chinese platforms with titles, summaries, and popularity indexes. Enable the Network Trending API (223) in TianAPI first.
tianapi.list_network_trending List Netease Trending
List NetEase news trending topics through TianAPI. This endpoint belongs to the Network Trending API (223), which must be enabled first.
tianapi.list_netease_trending List Phoenix Trending
List Phoenix news trending topics through TianAPI. This endpoint belongs to the Network Trending API (223), which must be enabled first.
tianapi.list_phoenix_trending List Baidu Trending
List Baidu trending search keywords, summaries, popularity indexes, and trends through TianAPI. Enable the Baidu Trending API (68) first.
tianapi.list_baidu_trending List Weibo Trending
List Weibo trending search topics, tags, and popularity indexes through TianAPI. Enable the Weibo Trending API (100) first. TianAPI documents a 30-minute update interval.
tianapi.list_weibo_trending List Douyin Trending
List Douyin trending search topics, labels, and popularity indexes through TianAPI. Enable the Douyin Trending API (155) first. TianAPI documents a 3-minute update interval.
tianapi.list_douyin_trending List Toutiao Trending
List Toutiao trending news topics and popularity indexes through TianAPI. Enable the Toutiao Trending API (244) first. TianAPI documents a 20-minute update interval.
tianapi.list_toutiao_trending List Tencent Trending
List Tencent ecosystem trending topics and ordering indexes through TianAPI. Enable the Tencent Trending API (196) first. TianAPI documents a 10-to-30-minute update interval.
tianapi.list_tencent_trending No matching tools.
Frequently Asked Questions
Must business APIs be enabled separately?
Yes. Enable each desired business API in your TianAPI account.
Does connection validation use quota?
It makes one account-information query, using free quota first and then TianDou credits.
What should I specify in my request?
Connection validation makes one billable account query, using free quota first. Horoscope and almanac data are cultural content, not factual predictions.