canonical: https://jentic.com/apis/biztoc.com/biztoc # BizToc BizToc exposes a single endpoint that returns the latest business news articles aggregated from sources around the web. The /ai/news endpoint accepts a free-text query that matches against article titles and bodies, so a caller can pull, for example, the latest stories mentioning a specific company, ticker, or sector. The shape is deliberately simple and is designed for use as a context-supply tool for AI agents and assistants that need fresh business news in their prompt context. ## For AI agents Pull the latest business news articles by free-text query. One endpoint, no auth - designed for agents that need fresh business news context. ## Scope Does not handle market data, sentiment scoring, or full-text article archives - use for searching the latest business news headlines only. ## Capabilities - Pull the latest business news stories matching a free-text query - Surface fresh headlines and article bodies for a named company or ticker - Supply business news context to an AI assistant on demand - Filter aggregated news by topic keywords without managing a feed crawler - Drive a news-based research agent with no API key setup ## Use cases ### Real-Time Business News Lookup for an Assistant An AI assistant needs to answer 'what's the latest news on Apple?' with fresh content rather than its training cutoff. The /ai/news endpoint accepts a query string and returns matching aggregated business news articles, which the assistant can summarise or cite. This is a drop-in source for any agent that needs current business context with zero credential setup. Example prompt: Call GET /ai/news?query=apple, take the top three results, and summarise them into a short briefing. ### Ticker-Driven News Aggregation Trading tools and research dashboards use the BizToc query parameter to pull stories for a list of watched tickers on a schedule. Because the endpoint searches both title and body text, it surfaces stories that mention a company even when the headline does not. The result is a low-effort news feed for portfolio monitoring without standing up a full news crawler. Example prompt: Iterate over a watchlist of tickers, call GET /ai/news?query={ticker} for each, and emit a digest grouping the top story per ticker. ### Topic Briefing Generator Generate a topical briefing for a sector or trend by querying BizToc for the keyword and combining the returned articles into a short report. Because the API is keyword-search rather than category-driven, it works equally well for niche topics like 'lithium battery supply chain' or broad ones like 'AI'. The briefing pipeline can run unattended, no auth, no token rotation. Example prompt: Call GET /ai/news?query=AI%20chips, deduplicate by source, and produce a 200-word briefing with three citations. ### Agent Discovery via Jentic An AI agent investigating a research question searches Jentic for a 'latest business news' tool and gets the BizToc /ai/news operation back. Jentic returns the input schema (query string) and the agent calls the endpoint directly. No credential plumbing is required because the API is open, which makes BizToc a useful default news source in agent toolkits. Example prompt: Use Jentic search for 'get the latest business news about a company', load the schema, then execute GET /ai/news?query={company_name}. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /ai/news | Retrieve the latest business news matching a query | ## Key resources - **News** — Search the BizToc aggregated business news index by free-text query ## Why Jentic - **Setup:** BizToc needs no credentials, so wiring it by hand still means targeting the ai.biztoc.com host and handling query-shape and error cases around the news call yourself. Through Jentic you install once, import BizToc from the API Directory, and your agent calls it with no key to configure. - **Permission scoping:** BizToc exposes a single read GET /ai/news operation with its target in the query, so limit the agent to the operation it needs, searching the latest business news headlines. You choose the operations it may call, so nothing beyond that read runs unless you add it. - **Credential handling:** BizToc requires no credentials, so there is nothing to store, and your own Jentic One instance proxies the call without any secret entering the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get the latest business news about a company', and Jentic returns the BizToc /ai/news operation with its query schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Bitstamp API** — Bitstamp supplies live crypto prices to overlay on BizToc news headlines. - **Bittrex API v3** — Bittrex (historical) market data combined with BizToc news supports retrospective event studies. - **Blackfire.io** — Blackfire profiles services that ingest BizToc to keep news pipelines responsive. ## FAQ ### What authentication does the BizToc API use? The OpenAPI spec declares no security schemes - the /ai/news endpoint is open and does not require an API key for the documented usage. When called through Jentic the request is proxied without injecting any credentials. ### Can I filter BizToc news by topic with this API? Yes, indirectly. /ai/news accepts a query string that matches both article titles and bodies. There is no formal topic taxonomy, so use a keyword like 'lithium' or 'AI chips' to bias the results toward a topic, and post-filter on the article metadata if needed. ### What are the rate limits for the BizToc API? The OpenAPI spec does not declare a published rate limit. BizToc is an aggregator with finite capacity, so design for retry-with-backoff on 429 or 5xx responses and avoid hammering the endpoint in tight loops. ### How do I search BizToc news with this API through Jentic? Install with pip install jentic, then use Jentic search with 'get the latest business news about a company'. Jentic loads the GET /ai/news operation and executes it with your query parameter. No credentials are stored because the endpoint is open. ### Is the BizToc API free? The /ai/news endpoint as exposed in this OpenAPI spec is callable without an API key. BizToc may rate-limit or restrict heavy use over time, so check the BizToc website if you plan to run high-volume polling. ### Can I limit what my agent is allowed to do with the BizToc API? Yes. BizToc exposes a single read operation, GET /ai/news, which searches the latest business news headlines by free-text query, and Jentic One runs self-hosted so your own rules decide which operations and credentials the agent may use. You can scope the agent to just that one news-search call, and nothing beyond it runs unless you add it. Because the endpoint is open, there are no credentials to grant, so the only access you are controlling is which operation the agent may invoke.