theblock.co APItheblock.co ↗
Access The Block's crypto news articles, market prices, category feeds, and educational content via 7 structured endpoints. Search by keyword or browse by category.
curl -X GET 'https://api.parse.bot/scraper/9d5ad629-5416-44ff-a5ca-dcd60f1937f9/get_article?post_id=401341' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract full article content by post ID. Returns the article title, body content, authors, category, tags, related tokens, and related posts.
| Param | Type | Description |
|---|---|---|
| post_idrequired | string | Numeric post ID (e.g. '401341'). Obtain from get_latest_news, search_articles, or get_news_by_category results. |
{
"type": "object",
"fields": {
"id": "integer post identifier",
"url": "string canonical article URL",
"tags": "array of tag objects with id, name, slug",
"intro": "string HTML intro/quick-take section",
"title": "string article headline",
"tokens": "array of related token objects",
"authors": "array of author objects with name, url, and slug",
"content": "string HTML body of the article",
"excerpt": "string short excerpt",
"category": "object with name, url, id, and description",
"subtitle": "string or null subtitle",
"updated_at": "string or null ISO 8601 update timestamp",
"description": "string or null meta description",
"published_at": "string ISO 8601 publish timestamp",
"related_posts": "array of related post objects"
},
"sample": {
"data": {
"id": 401341,
"url": "https://www.theblock.co/post/401341/senate-banking-committee-advances-landmark-crypto-market-structure-bill-garners-some-democratic-support",
"tags": [
{
"id": 143,
"name": "CFTC",
"slug": "cftc"
}
],
"intro": "<h4>Quick Take</h4><ul><li>...</li></ul>",
"title": "Senate Banking Committee advances landmark crypto market structure bill",
"tokens": [],
"authors": [
{
"id": 8673,
"name": "Sarah Wynn",
"slug": "sarah-wynn"
}
],
"content": "<p>Article HTML content...</p>",
"excerpt": "Landmark legislation to regulate the digital asset industry...",
"category": {
"id": 55001,
"name": "Policy"
},
"subtitle": null,
"updated_at": null,
"description": null,
"published_at": "2026-05-14T13:01:21-04:00",
"related_posts": []
},
"status": "success"
}
}About the theblock.co API
The Block API exposes 7 endpoints covering crypto news, token market data, and educational content from theblock.co. The get_article endpoint returns full HTML body, authors, tags, related tokens, and category metadata for any article by post ID. Other endpoints cover paginated news feeds, category browsing, keyword search, per-token price history, and structured learn content — all returning typed JSON fields ready for direct integration.
News and Article Endpoints
The get_latest_news endpoint returns the 10 most recent articles with fields including id, title, url, primaryCategory, and publishedFormatted. Use those id values to call get_article, which returns the full article: title, content (HTML body), intro (HTML quick-take), excerpt, authors (name, url, slug), tags (id, name, slug), tokens (related cryptocurrencies), and a category object with name, url, id, and description. The get_news_by_category endpoint accepts a category_slug parameter — valid values include markets, legal, funds, companies, stablecoins, policy, and web3 — and supports page and size pagination parameters. It returns the same article summary shape plus a category object with pageMeta and slug fields.
Search and Discovery
The search_articles endpoint accepts a query string (e.g., 'bitcoin' or 'ethereum ETF') and returns a count integer plus a results array. Each result includes id, title, url, authors, publishedFormatted, and primaryCategory, making it straightforward to surface relevant articles and then fetch full content with get_article.
Cryptocurrency Price Data
The get_cryptocurrency_prices endpoint returns a paginated list of tokens ranked by market cap. Each token in tableAssets carries id, title, token_symbol, a tokenData object (current price, market cap), and a tokenHistory array of price points. The tokenHomepage object includes total market cap change percentages. Pass size and start to paginate. Once you have a numeric token ID, get_token_price_detail returns granular fields: current_price, market_cap, price_change_percentage_24h, high_24h, low_24h, and a tokenHistory time series.
Educational Content
The get_learn_articles endpoint returns structured learning content from The Block's learn section. The response includes a data object with posts grouped by topic sections (such as Latest, Companies, and Consensus Mechanisms), along with navigation menu items and SEO meta fields. It takes no input parameters and returns the full current state of the learn catalog in one call.
- Aggregate crypto news by category using
get_news_by_categorywith slugs likemarketsorpolicyfor topic-specific feeds. - Build a crypto price dashboard using
get_cryptocurrency_pricesfor ranked token data andget_token_price_detailfor 24h high/low and price history. - Monitor breaking coverage of specific tokens by searching with
search_articlesand filtering results byprimaryCategory. - Extract author attribution and related tokens from articles via
get_articleto build entity-level coverage graphs. - Populate a crypto knowledge base using
get_learn_articlestopic sections like Consensus Mechanisms or Companies. - Track article publication cadence per category by combining
get_news_by_categorypagination fields (totalPosts,totalPages) withpublishedFormattedtimestamps. - Enrich internal research tools by resolving article
tagsandtokensfields fromget_articleresponses.
| 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 | 250 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 The Block have an official developer API?+
What does `get_article` return beyond the article body?+
get_article returns the full HTML content and intro, plus an authors array (each with name, url, slug), a tags array (id, name, slug), a tokens array of related cryptocurrencies, an excerpt, and a category object with name, url, id, and description. You need a numeric post_id, which you can get from get_latest_news, search_articles, or get_news_by_category.How current is the price data from `get_cryptocurrency_prices`?+
range field in the response indicates the time window (e.g., '1D'). The API does not expose tick-level trade data or order book depth — it covers summary market data at the token level.Can I retrieve comments or reader reactions on articles?+
Does `get_news_by_category` support all categories on The Block's site?+
category_slug values: markets, legal, funds, companies, stablecoins, policy, and web3. Categories outside that set may not return results. You can fork this API on Parse and revise it to test additional slugs or add support for categories not currently listed.