Pricing for the Astrology and Numerology APIs, with a free plan

Reading credits are what written readings use. Calculations, such as birth charts, dasha, panchang and kundli matching, use calls. A written reading uses credits instead: 1 for a chapter, 25 for a full report. Each plan has a monthly allowance of credits: Free 150, Starter 1,000, Growth 5,000 and Scale 22,000.

The written readings: one chapter; life summary; karma reading; spiritual path reading; love, career or wealth forecast; weekly reading; varshaphal (annual chart); couple forecast; full report; annual forecast; question chart (prashna); and kp question chart (kp horary). Everything else uses calls, including the daily horoscopes, the list of chapters and the rule list. Credits are the same in every language, and for standard or longer text.

Calculations get a 429 answer, with a Retry-After header, until the 1st of the next month (UTC) or a move to a bigger plan. Calls already in progress at that moment still finish, and any calls over your allowance come off next month's. Reading credits are separate, so readings keep working while credits are left. We never charge extra for calls.

A reading that does not fit in the credits left gets a 429 answer with the code reading_credits_exceeded. That lasts until the 1st of the month (UTC), or until you move to a bigger plan. Calculations keep working. Without pay as you go, credits never go past your allowance, so there is nothing extra to pay.

Pay as you go is for paid plans. Turn it on in Billing and set a monthly cap ($50 unless you change it). When your reading credits run out, readings keep working, and you pay for the extra credits each month. The price is $0.75 a full report on Starter, $0.55 a full report on Growth and $0.45 a full report on Scale. On a monthly plan, the extras are a line on your plan's monthly invoice, in the same payment. On a yearly plan, they come on a separate monthly invoice with no monthly fee. At the cap, readings answer 429 until the 1st (UTC). Extra credits are not refunded.

Yes. Test keys return every reading in full, free, on every plan. They work for the sample charts in the docs: John Doe (New York) and Jane Doe (Chicago). And the Free plan gives 150 reading credits a month for any chart: about 6 full reports, or 150 chapters.

Yes. On every plan, you may show API output to your own users, in a free or a paid product. Paid plans need no link to us. One exception: on Starter, a public page with the 12 daily sign horoscopes must link to us. The Free plan needs a visible "Powered by API for Astrology" link. You may not resell the output as your own data feed or API.

Yes, once real users see it. On the Free plan, each page or screen with API output needs a visible link. It reads "Powered by API for Astrology" and goes to https://apiforastrology.com. It can go in the footer of that page, for example. Test keys need no link, and paid plans need none, except the daily sign horoscopes on Starter.

No. Calls and reading credits start again on the 1st of each month (UTC), and unused ones do not carry over.

Yes. One plan, one account and one set of keys cover the Astrology API and the Numerology API, with one invoice. Both use the same calls and reading credits.

Every numerology answer is a written reading. So it uses reading credits, never calls. A name or phone number check uses 1 credit, and a full report uses 25. The price is the same in every language. Failed requests are free.

Choose a plan and pay by card on a secure checkout page. Our reseller, Dodo Payments, handles the payment and the tax, and emails you an invoice. The plan applies within a minute of paying.

Yes, from Billing in your account. A bigger plan applies at once, and you pay only the difference for the rest of the period. A smaller plan starts on your next billing date. If you cancel, the plan runs to the end of the period you paid for, then your account moves to Free.

Your plan keeps working while the payment is retried, for up to 7 days after the paid period ends. Update your card in Billing to keep it. After that, your account moves to Free and your keys keep working within the Free limits.

Payments are final, but we refund double or mistaken charges. The refund policy has the details.

Yes, if it breaks the Terms. Examples are copying the reading text in bulk, getting around a limit, or opening more than one Free account. Fair use applies to every plan. A Free account can be disabled without notice if we find the API being misused there. The Terms list the rules and what happens when an account is suspended.