Skip to main content
ABLECITY
Menu

Saju & fortune APIs

Fortune content and Saju data,
connected to your service.

Get Saju calculation data, fortune content and interpretation results through APIs for your app or website. Check each product’s results and response mode, then plan integration with your existing membership, payment and result screens.

View pricing and terms

New paid rates are scheduled to take effect on December 1, 2026. New customers can apply for and use the approved v5.0 Sandbox now. New paid subscriptions are on hold before December 1, 2026. This page covers the new terms for standard Korean responses. The v2.7 plans are closed to new subscribers. Existing customers retain their current contracts and will receive separate transition guidance.

The current Sandbox uses the v5.0 product scope and test terms. Testing is limited to the approved key scope and cannot serve a live service or end users. Paid use requires a separate contract and Live key. Sandbox keys do not automatically become Live keys.

API products

Content, calculation data and professional analysis.

Fortune content

Content & Retention

Manse-force Lite, daily personal fortune and zodiac content for home feeds, push notifications and widgets.

AvailableApproved content modules
Compare product results

Calculation data

Manse-force Core

The new v5.0 Core product provides chart, Five Elements, Ten Gods, Twelve Stages and major luck-cycle data. Existing customers retain the fields agreed in their current contracts.

AvailableSynchronous
Compare product results

Professional analysis

Professional + SIS

The new v5.0 professional product includes all Core data, strength, chart pattern, favourable elements, branch relationships, void branches and position, status and impact data for 54 Shinsal indicators.

AvailableAccess set by key permissions
Compare product results

Response modes

Compare calculation data and interpretation responses.

ProductResultsResponse mode
Content & RetentionShort copy, scores and keywordsSynchronous
Manse-force CoreChart, Five Elements, Ten Gods, Twelve Stages, major luck cyclesSynchronous
Professional + SISCore + strength, pattern, favourable elements, relations, void branches, 54 ShinsalSynchronous
Standard interpretationsReviewed fixed-form copy · internal testingSynchronous / approved scope
Custom interpretationsLong-form interpretations grounded in calculation resultsCallback

Custom interpretations use the existing POST + Callback flow, with completed results delivered by Callback.

Core and Professional + SIS use the same GET /api/v2/saju/fortune endpoint. This comparison describes the v5.0 product scope available now in the approved Sandbox, with access set by key permissions. New paid subscriptions are on hold before December 1. It does not announce an immediate reduction in existing customers’ fields or an increase in their rates. SIS intensity is an internal relative index, not a statistical probability.

Approval-based PoC

Evaluate extended products through an approved PoC.

The table below shows current operating status, separately from the current approved Sandbox and new paid rates scheduled for December 1. Daily star-sign fortune, biorhythm, standard interpretations, Tojeong, date selection and naming remain in internal testing. Actual products, paths, access scope and limits are provided after approval.

ProductProduct availability
Manse-force LiteAvailable
Daily personal / zodiac fortuneAvailable
Manse-force Core / Professional + SISAvailable
Daily star-sign fortune / biorhythmInternal testing · approval-based PoC inquiries
Standard interpretationsInternal testing · approval-based PoC inquiries
Tojeong / date selection / namingInternal testing · approval-based PoC inquiries

Daily star-sign content and professional astrology are separate products. Professional astrology is also in internal testing. Pricing is not finalized, and it is not available as a public API for general calls.

Naming is an extension module for name candidates and interpretations based on surname, Hanja, five-element balance and phonetic conditions. Candidate generation uses surname, gender and birth data; results include candidates, scores and interpretation grounds. The product is in internal testing and requires an approved PoC.

Professional astrology modules for zodiac, planetary positions and transits are under review. Documentation remains in draft until formal release.

Current regional status: Korea and Japan, available; China and Taiwan, PoC; US, UK and Europe, discussions. The new standard rates cover Korean responses. Actual products, languages and access depend on approval and contract terms.

Integration examples

A fortune service and a pop-up experience.

SSEHADA app screen

SSEHADA / B2C fortune service

A live fortune service using our Saju engine

Explore SSEHADA’s free Saju chart, report screens, fortune products and payment flow. See how calculation data can be presented to customers before integration.

Visit SSEHADA
Offline fortune kiosk

Monkey Shoulder / Pop-up experience

An on-site fortune experience with receipt printing

The implementation included the on-site fortune experience, photo capture, result presentation and receipt-printing integration. Campaign interfaces and external device integration are scoped separately from API usage.

Pop-up exteriorPop-up interior
Submit a campaign integration brief

A separately scoped API build can combine selected APIs with admin tools, usage limits, plan logic, transaction logs, payment flows, monitoring and staged rollout planning. Confirm the deliverables in the estimate and contract.

The API documentation covers authentication, request fields, JSON responses, error codes and asynchronous analysis.

Read the API documentation

Evaluation and production

Apply, evaluate and plan production use.

  1. 01

    Apply

    Tell us which products you need, how your service will use them and what you want to evaluate.

  2. 02

    Initial review and key issuance

    We email the initial review outcome and issuance scope within one business day of submission. API keys are issued separately by email for approved products and usage only.

  3. 03

    30-day Sandbox

    The approved v5.0 Sandbox is available now with 100 content calls, 1,000 combined Core/Professional + SIS calls, 20 standard results and 5 completed Callback results over 30 days. Actual features, duration and limits follow the approved key scope.

  4. 04

    Production use

    New paid subscriptions are on hold before December 1, 2026. Paid use requires a review of the APIs, rates, screens, expected usage and launch date, plus a separate contract and Live key. Existing customers retain their contracts, payment terms and key permissions.

The Sandbox is for testing only and does not automatically convert to Live. A separate Live key is required before providing results in a live service or to end users. New customers can apply for the v5.0 Sandbox now. New paid subscriptions are on hold before December 1, 2026. Internal-test products require separate scope approval.

API product guide v5.0 · English PDF · paid rates scheduled for December 1

Pricing and usage

Compare pricing by product and usage.

Content & Retention

20P / successful result

PAYG for low usage · Scale KRW 99,000/month

Approved content modules · scheduled for December 1

Manse-force Core

90P / successful result

Starter KRW 30,000/month · 500 results

Calculation data · scheduled for December 1

Professional + SIS

150P / successful result

Starter KRW 50,000/month · 500 results
Launch KRW 89,000/month · 2,000 results

All Core data + professional analysis · scheduled for December 1

1P = KRW 1 · VAT excluded

These rates are scheduled to take effect on December 1, 2026 for standard Korean responses, in KRW excluding VAT. Existing customers retain their current contracts and will receive separate transition guidance. See the full pricing page for interpretation and specialist-result rates. Default output lengths are listed in Appendix B of the Korean customer guide v5.0. Interpretation, date-selection and naming fees include the required calculations; requesting the full data API separately adds the data fee.

Compare monthly plans by their product allowances. The applicable products, usage limits, overage fees and allowance rollover are agreed in the quote and contract before a Live key is issued.

PAYG rates do not automatically apply as subscription overage fees. The billing date, effective dates for changes or cancellation, proration and refund terms are also confirmed in the quote and contract.

Charges apply only to final 2xx responses or completed Callback results. Callback acceptance is not a completed result. 5xx responses, Ablecity processing failures and retransmissions of the same completed result are excluded from billing.

Point top-ups are part of paid use. New customers’ paid subscriptions are on hold before December 1. Existing customers continue to pay under their current contracts.

PAYG has no monthly base fee. Top up from KRW 10,000 excluding VAT, or KRW 11,000 including VAT for the minimum purchase. 1P equals KRW 1 before VAT. Purchased points are valid for 12 months and are non-refundable after 7 days. Rights under applicable law are unaffected; specific refund terms follow the quote, contract and applicable law.

Annual commitments, multilingual responses, PDF output, dedicated infrastructure and operating support are agreed separately. See the pricing page for the full rates and terms to confirm in your quote and contract.

View pricing and terms

Operations and support

Define operating terms and support.

Authentication and responses

Confirm key permissions, available fields and synchronous or Callback response contracts before integration.

Usage and billing

Review usage by key, product allowances, points and overage rules.

Integration and operating support

Initial integration support, availability, support hours and incident response are defined in the contract-specific SLA according to traffic and operating responsibilities.

Before you integrate

Integration, permissions and product availability.

Can I connect the API to an existing service?

We review your existing membership, payment and result-page structure before agreeing how to connect the API results. Frontend interfaces, your infrastructure and external integrations are quoted separately where development is required.

Can I use a test key in production?

The Sandbox is for approved testing and does not automatically convert to Live. Before providing results in a live service or to end users, you need a separate Live key following a review of the APIs, rates, screens, expected usage and launch date. New customers can apply for the v5.0 Sandbox now. New paid subscriptions are on hold before December 1, 2026.

Does Core include SIS and every professional field?

For the v5.0 products available now in the approved Sandbox, Core provides calculation data; Professional + SIS adds professional analysis and 54 Shinsal indicators to all Core data. Key permissions determine this new scope. Existing customers’ current fields and rates follow their contracts and separate transition guidance.

Does product guide v5.0 mean API v5?

The product guide is v5.0, while the API retains the existing /api/v2/ path. Document and API versions are separate.

Can I call internal-test products immediately?

Internal-test products are offered through approval-based PoC inquiries. Planned paths may change and are not available for general calls. Actual paths and limits are provided after approval.

Where can I check usage after receiving a key?

After receiving an API key, register at the API Dashboard to review usage, subscription status and API lookups. Point top-ups are part of paid use; new paid subscriptions are on hold before December 1. Existing customers retain their current contracts and key permissions.

API integration inquiries

Tell us which API you need and how you will connect it.

Tell us the products you need, estimated call volume and integration environment. We review API access, or separately scoped development deliverables and operating terms.

Before contracting, confirm features, deliverables, acceptance criteria, the cost and schedule impact of changes, source and document handover, maintenance and SLA scope.

Project scope / quote request