hypeless

Hypeless API

API for developers

Add Hypeless market news, story pages and Tip Checker checks to your own app. Each account gets 50 free calls a day.

Use Hypeless in your AI app

Free for everyone to use in their own AI app. No key, no sign-in. Add it once in ChatGPT, Claude or Gemini, then ask for Indian market headlines, Tip Checker checks or SEBI lookups.

Open the connect guide

Everything for building with Hypeless in one place.

Sign in to create API keys

Keys and credit belong to your Google account.

To buy a credit pack, sign in with Google first. Pack prices are below.

Sign in

Buy credit

Prepaid. ₹1 paid is ₹1 of credit. Nothing renews automatically.

Choose a pack

Checking whether you can buy…

Prices

  • First 50 calls a day, for each account: free
  • After that, each news, story or tip-check call: ₹0.50
  • Each Ask Hypeless (AI) question: ₹2
  • With no credit left, the API returns 402 "out_of_credits". Free calls reset at midnight, India time.

API reference

A simple REST API with JSON answers. Every story names its outlet and links to the original. We show headlines, short descriptions and our own summaries, never full articles, and never buy, sell or hold advice.

Quick start

  1. Sign in with Google and make a key in the Keys box above (it is shown once: copy it).
  2. Send it as a Bearer token in the Authorization header.
  3. Call any endpoint below. The first calls each day are free.

Base address

Base address
https://hypeless.in/api/v1

Authentication: Authorization: Bearer hl_live_... on every call. Keep the key secret and never put it in a website or app that other people can open.

Download the documentation (.md)Download the OpenAPI spec (openapi.json)

Example: the latest stories about one company

curl
curl "https://hypeless.in/api/v1/news?q=Infosys&limit=5" \
  -H "Authorization: Bearer hl_live_YOUR_KEY"
JavaScript
const res = await fetch("https://hypeless.in/api/v1/news?q=Infosys&limit=5", {
  headers: { Authorization: "Bearer " + process.env.HYPELESS_KEY },
});
const data = await res.json();
console.log(data.stories[0].outlet, data.stories[0].headline);
Python
import os, requests

r = requests.get(
    "https://hypeless.in/api/v1/news",
    params={"q": "Infosys", "limit": 5},
    headers={"Authorization": "Bearer " + os.environ["HYPELESS_KEY"]},
    timeout=30,
)
r.raise_for_status()
print(r.json()["stories"][0]["headline"])

Endpoints

GET /news

Latest Indian market stories from named outlets, with links and the Quick read.

q
Company name to search for (optional)
category
markets, companies, ipos, economy, banking, commodities, funds, global, tech, auto, pharma or energy (optional)
limit
How many stories, 1 to 50 (default 20)
summary
1 adds today's short market summary (optional)
GET /story/{code}

One story: every outlet's headline, with links.

code
A story code from the news answer (the end of its storyPage link)
POST /tip-check

A rule-based check of a stock tip post (its wording), never the stock. No AI.

text
The post to check, up to a few thousand characters (JSON body)
POST /tip-check
curl -X POST "https://hypeless.in/api/v1/tip-check" \
  -H "Authorization: Bearer hl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Guaranteed 300% returns in 2 weeks. Join my group now."}'
POST /ask

Ask Hypeless: answers only from named outlets' recent headlines. Uses AI. (₹2)

question
Your question about Indian market news (JSON body)
POST /ask
curl -X POST "https://hypeless.in/api/v1/ask" \
  -H "Authorization: Bearer hl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "What did outlets report about TCS results?"}'

Errors

StatusErrorWhat it means
401missing_or_bad_key / invalid_keyNo key, a wrong key, or a key that was revoked.
402out_of_creditsNo credit left for this call. Buy a pack on this page. The call is not counted.
403plan_has_no_aiYour plan does not include the AI endpoint.
429daily_limit / daily_ai_limitThe key used all its calls for today (India time). They return at midnight.
503unavailable / not_configuredA problem on our side. Try again in a minute.

Every answer is JSON with an error name you can test for. Each response also reports your calls today and free calls left in headers. Educational data, not investment advice.

The API follows the same rules as Hypeless: no buy, sell or hold views, no stock ratings, and only headlines and links from named outlets, never full articles. Show the outlet's name and link with every story you use.