Estante Nacional APIestante-nacional.com.br ↗
Access the Estante Nacional catalog of Brazilian comics, manga, web novels, and animations. Returns titles, authors, genres, formats, and thumbnails.
What is the Estante Nacional API?
The Estante Nacional API exposes the full catalog of Brazilian comics, manga, web novels, and animations from estante-nacional.com.br through a single search_items endpoint. Each response returns up to 20 items per page and includes 6 fields per item — title, author, format, categories, thumbnail, and URL — plus pagination metadata covering total item and page counts.
curl -X GET 'https://api.parse.bot/scraper/bb66cc6f-5f50-4996-a0c5-c02601ef826f/search_items?page=1' \ -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 estante-nacional-com-br-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: browse the Estante Nacional catalog of Brazilian comics and media."""
from parse_apis.estante_nacional_com_br_api import EstanteNacional, ParseError
client = EstanteNacional()
# Browse the first few catalog items, capped at 5 total.
for item in client.items.list(limit=5):
authors = ", ".join(item.author)
genres = ", ".join(item.categories)
print(f"{item.title} by {authors} [{item.format}] — {genres}")
# Grab one item to inspect its details.
try:
first_item = client.items.list(limit=1).first()
except ParseError as e:
print(f"Catalog unavailable: {e.code} — {e.message}")
first_item = None
if first_item is not None:
print(f"\nFirst item: {first_item.title}")
print(f" URL: {first_item.url}")
print(f" Thumbnail: {first_item.thumbnail}")
print("\nexercised: items.list")
List items from the Estante Nacional catalog, returning 20 items per page ordered alphabetically by document ID. Each item includes its URL, thumbnail, categories (genres), format (type of work), title, and author(s). Pagination is controlled by the page parameter; omitting it returns the first page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). Each page contains 20 items. |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of catalog items, each with url, thumbnail, categories, format, title, author",
"total": "total number of works in the catalog",
"has_more": "whether more pages are available after the current one",
"per_page": "items per page (always 20)",
"total_pages": "total number of pages available"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://estante-nacional.com.br/obra/lebre-e-coelho",
"title": "Lebre e Coelho",
"author": [
"Alec"
],
"format": "Web comic",
"thumbnail": "https://m.media-amazon.com/images/I/91DpRAq+X1L._SL1500_.jpg",
"categories": [
"Comédia",
"Drama",
"Romance"
]
}
],
"total": 775,
"has_more": true,
"per_page": 20,
"total_pages": 39
},
"status": "success"
}
}About the Estante Nacional API
What the API Returns
The search_items endpoint pages through the Estante Nacional catalog alphabetically by document ID. Each call returns a page number, a per_page value (always 20), a total count of works in the catalog, a total_pages count, a has_more boolean, and an items array. Each item in the array carries a title, one or more author values, a format (the type of work, such as manga, quadrinho, or web novel), a categories list reflecting genre tags, a thumbnail image URL, and a direct url to the item's page on Estante Nacional.
Pagination
Pagination is controlled by the page parameter, which is 1-based and optional. Omitting page returns the first page. With 20 items per response and total_pages included in every reply, you can walk the entire catalog by incrementing page until has_more is false. This makes full-catalog ingestion straightforward without guessing offset values.
Coverage
Estante Nacional focuses on Portuguese-language entertainment media with Brazilian origin or localization. The catalog spans comics (quadrinhos), manga, web novels, and animations. Format and category data reflect how each work is classified on the source site, so genre granularity depends on how items are tagged there.
The Estante Nacional API is a managed, monitored endpoint for estante-nacional.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when estante-nacional.com.br 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 estante-nacional.com.br 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 searchable index of Brazilian comics and manga titles with author attribution
- Aggregate genre and format distribution data across the full Estante Nacional catalog
- Populate a recommendation feed filtered by categories returned in the
categoriesfield - Sync thumbnail and metadata into a media library or content database
- Track total catalog size over time using the
totalfield across repeated calls - Map author output across formats by grouping items on the
authorandformatfields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Estante Nacional have an official developer API?+
What does the `format` field distinguish, and how does it differ from `categories`?+
format field identifies the type of work — for example, manga, quadrinho, or web novel — reflecting how the work is fundamentally classified. The categories field contains genre tags such as action, fantasy, or romance that can apply across formats. Both are returned for every item in the items array.Can I filter the catalog by genre, author, or title using the API?+
search_items endpoint returns catalog items paginated alphabetically by document ID. Filtering by genre, author, or title is not currently supported as a server-side parameter. The API returns full item records on each page, so client-side filtering on the categories, author, or title fields is possible after retrieval. You can fork this API on Parse and revise it to add a filter parameter endpoint.