How JustNeeda works under the hood.

What this is

JustNeeda is a freemium AI toolkit for indie founders — 17 small, focused tools that turn a one-line brief into a usable artifact (brand names, landing copy, ad sets, audits, pitch decks, and more). The currently public surface is a single HTTP endpoint: POST /api/free-generate. It runs the same tool catalog the UI uses, gated by a per-IP daily quota for anonymous callers and a per-email monthly quota once you identify yourself.

API — the gated endpoint

Send a JSON body. Get either a generation or a quota error. No auth header required for the free tier.

curl -X POST https://justneeda.com/api/free-generate \
  -H "content-type: application/json" \
  -d '{"toolId":"instant-brand-name","input":"<your brief>"}'

Request body

• toolId — required. One of the 17 IDs in the catalog below.
• input — required. Free-text brief describing what you need.
• email — optional. Unlocks the email-gated tier (3 full runs per tool per month).
• website_url — honeypot. Leave empty. Submissions with this field set are dropped as bot traffic.

Response — 200 OK

{
  "tier": "anon" | "email" | "paid",
  "output": "<generated markdown>",
  "remaining": <number>,
  "windowResetAt": "<ISO timestamp>",
  "ctaToUpgrade": "<copy to show in your UI>"
}

Response — 429 Too Many Requests

{
  "error": "quota_exceeded",
  "tier": "anon" | "email" | "paid",
  "remaining": 0,
  "windowResetAt": "<ISO timestamp>",
  "requiresEmail": <boolean>,
  "requiresPayment": <boolean>
}

Tool catalog (17 IDs)

Every toolId the endpoint accepts. Price shown is the one-time unlock for unlimited paid runs.

Auth (planned)

Q4 roadmap: per-account API keys you can generate from /account, each with its own monthly quota that decrements against your paid plan, plus optional webhooks that POST the generated artifact to a URL of your choosing as soon as it’s ready. Bearer token auth, scoped per key, rotatable. No SDK planned — the endpoint is small enough that a raw fetch is the entire integration.

Open questions

• Should we expose a CLI?
• Webhook on generation complete?
• Bulk endpoint?

Reply to [email protected] with your use case.