FinancialJuice APIfeatures.financialjuice.com ↗
Access live financial news, economic calendar events, stock tickers, and in-depth articles from FinancialJuice via 6 structured JSON endpoints.
What is the FinancialJuice API?
The FinancialJuice API exposes 6 endpoints covering live news items, economic calendar events, stock ticker lookup, and full article content. The get_news_feed endpoint returns a real-time stream of news items with fields like NewsID, Title, DatePublished, Level, and Labels, while get_economic_calendar delivers upcoming data releases with Forecast, Previous, Actual, and ImpID fields for impact scoring.
curl -X GET 'https://api.parse.bot/scraper/5b75d611-7d46-4a11-8e9b-1197d46a46c8/get_articles?page=1&search=market&category=73&per_page=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace features-financialjuice-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FinancialJuice SDK — bounded, re-runnable; every call capped."""
from parse_apis.financialjuice_api import FinancialJuice, Category, ArticleNotFound
client = FinancialJuice()
# List recent articles filtered to Daily Dose category
for article in client.articles.list(category=Category._73, limit=3):
print(article.title, article.date, article.views)
# Search news for a market topic
for item in client.newsitems.search(query="inflation", limit=5):
print(item.title, item.date_published, item.source)
# Get the live news feed (latest headlines)
headline = client.newsitems.list(limit=1).first()
if headline:
print(headline.title, headline.level)
# Look up a stock ticker
for stock in client.stocks.search(query="Tesla", limit=3):
print(stock.ticker, stock.name, stock.exchange)
# Get upcoming economic calendar events
for event in client.calendarevents.list(limit=3):
print(event.title, event.date, event.country_code, event.forecast)
# Typed error: fetch an article that may not exist
try:
detail = client.articles.list(search="unlikely-xyz-query-999", limit=1).first()
if detail:
print(detail.title, detail.slug)
except ArticleNotFound as exc:
print(f"Article not found: {exc}")
print("exercised: articles.list / newsitems.search / newsitems.list / stocks.search / calendarevents.list")
Retrieves paginated articles from the WordPress REST API in reverse chronological order. Supports filtering by category ID and free-text search. Each article includes rendered title, content HTML, excerpt, publication date, slug, and category IDs. Pagination uses integer page numbers; the default page size is 10.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| search | string | Search keyword for filtering articles by title/content. |
| category | integer | Category ID to filter by. Known IDs: 73 (Daily Dose), 76 (US), 77 (EU). |
| per_page | integer | Number of results per page (1-100). |
{
"type": "object",
"fields": {
"items": "array of article objects with id, date, slug, link, title, content, excerpt, categories, views"
},
"sample": {
"data": {
"items": [
{
"id": 19370,
"date": "2026-06-10T20:09:06",
"link": "https://features.financialjuice.com/2026/06/10/stocks-hit-five-week-low-as-tech-selloff-oil-rise-weigh-us-market-wrap/",
"slug": "stocks-hit-five-week-low-as-tech-selloff-oil-rise-weigh-us-market-wrap",
"title": {
"rendered": "Stocks Hit Five-Week Low as Tech Selloff, Oil Rise Weigh - US Market Wrap"
},
"views": 43412,
"excerpt": {
"rendered": "Stocks fell, oil rose, yields climbed..."
},
"categories": [
73,
76
]
}
]
},
"status": "success"
}
}About the FinancialJuice API
News Feed and Search
The get_news_feed endpoint returns the latest financial news items in reverse chronological order. It supports cursor-based pagination via the old_id parameter — pass the lowest NewsID seen in the previous response to page backward through history, or pass 0 to start from the most recent items. Each news object includes NewsID, Title, DatePublished, Level, Labels, and FCName. The search_news endpoint accepts a required query string and returns matching news items sorted by recency, using the same response shape.
Economic Calendar
get_economic_calendar requires no input parameters and returns the full upcoming schedule of economic events. Each event object includes Date, Title, CountryCode, Forecast, Previous, Actual, and ImpID, making it suitable for building pre-event alerts or annotating charts with macro catalysts. Events cover data releases, central bank speeches, and market holidays.
Articles and Long-Form Content
The get_articles endpoint retrieves paginated WordPress-backed articles. You can filter by category ID (for example, 73 for Daily Dose or 76 for US), pass a search string, and control page size via per_page. Results include id, date, slug, link, title, content, excerpt, and categories. To fetch a single article's full content, use get_article_detail with either article_id or slug — at least one is required.
Stock Code Lookup
get_stock_codes accepts an optional query string (such as 'Apple', 'Tesla', or 'gold') and returns matching instruments. Each result includes id (the ticker symbol), label (company name), exc (exchange), ResultType, and Rid. This is useful for resolving human-readable company names to ticker symbols before filtering news by instrument.
The FinancialJuice API is a managed, monitored endpoint for features.financialjuice.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when features.financialjuice.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official features.financialjuice.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a real-time financial news ticker using
get_news_feedwith cursor pagination viaold_id - Annotate trading charts with macro events by pulling
Forecast,Actual, andImpIDfromget_economic_calendar - Search historical news coverage for a specific company or topic using
search_newswith a keyword query - Resolve company names to ticker symbols via
get_stock_codesbefore linking instruments to news items - Aggregate long-form financial commentary by category using
get_articleswith thecategoryfilter parameter - Set pre-release alerts for high-impact economic events by filtering calendar results on
ImpID - Fetch full article body content for NLP or summarization pipelines using
get_article_detailwith aslug
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FinancialJuice have an official developer API?+
How does pagination work in `get_news_feed`?+
old_id=0 to retrieve the latest news items. For subsequent pages, pass the lowest NewsID from the previous response as old_id. This approach is more stable than offset pagination for live feeds where new items are continuously added at the top.What does the `Level` field in news items indicate?+
Level field on news objects from get_news_feed and search_news represents the priority or impact classification of a news item as assigned by FinancialJuice. Higher levels typically correspond to more market-moving headlines. The Labels and FCName fields provide additional categorization and source attribution.Does the economic calendar endpoint return historical event data?+
get_economic_calendar returns upcoming events. Historical calendar data — past releases with final Actual values across extended date ranges — is not currently covered. You can fork this API on Parse and revise it to add a historical calendar endpoint if your use case requires back-data.Can I filter news items by stock ticker or country code directly in the news feed?+
get_news_feed endpoint does not accept ticker or country filter parameters directly — filtering is limited to cursor pagination via old_id. search_news accepts a free-text query which can include a ticker symbol. You can fork this API on Parse and revise it to add ticker- or country-scoped news filtering endpoints.