Zinnes APIzinnes.com.br ↗
Access comic metadata from Zinnes, Brazil's webcomic platform. Retrieve titles, synopses, chapter lists, view counts, likes, and more via one API endpoint.
What is the Zinnes API?
The Zinnes API exposes comic catalog data from zinnes.com.br through a single endpoint, get_comic_details, returning 10 structured fields per comic including title, synopsis, age rating, categories, total views, total likes, and a full chapter list with per-chapter metadata. It covers individual comic pages by numeric ID, giving developers direct access to the Zinnes catalog for Brazilian webcomic content.
curl -X GET 'https://api.parse.bot/scraper/59709afd-7ae4-4c06-94d9-d2218d723423/get_comic_details?comic_id=661' \ -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 zinnes-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: Zinnes Comics API — fetch a comic and explore its chapters."""
from parse_apis.zinnes_com_br_api import Zinnes, ComicNotFound
client = Zinnes()
# Fetch a comic by its numeric ID.
try:
comic = client.comics.get(comic_id="661")
except ComicNotFound:
print("Comic not found")
raise
print(f"{comic.title} by {comic.author_name} ({comic.age_rating})")
print(f" Views: {comic.views} Likes: {comic.likes} Chapters: {comic.chapters_count}")
print(f" Categories: {', '.join(comic.categories)}")
# Walk the embedded chapter list.
for chapter in comic.chapters[:5]:
print(f" - {chapter.name}: {chapter.views} views, {chapter.likes_count} likes")
print("exercised: comics.get / Comic fields / Chapter fields")
Retrieve detailed information about a comic (obra) by its numeric ID. Returns the comic's URL, thumbnail, categories (category, genre, type), title, synopsis, author name and username, chapter list with per-chapter metadata, total views, total likes, and age rating. One upstream request per call; the chapter list is returned in full.
| Param | Type | Description |
|---|---|---|
| comic_idrequired | string | Numeric ID of the comic on Zinnes (e.g. '661' for Istella, '12' for Taico). Visible in the comic page URL path /obra/{id}/{slug}. |
{
"type": "object",
"fields": {
"id": "integer — comic's numeric ID",
"url": "string — full URL to the comic page on zinnes.com.br",
"likes": "integer — total like count",
"title": "string — comic title",
"views": "integer — total view count",
"chapters": "array of chapter objects with id, name, description, views, likes_count, comments, release_date, and thumbnail",
"synopsis": "string — comic description/synopsis",
"thumbnail": "string — URL to the comic's thumbnail image",
"age_rating": "string — age classification code (e.g. 'A14', 'L')",
"categories": "array of strings — includes category, genre, and type labels",
"author_name": "string — display name of the author",
"chapters_count": "integer — number of chapters",
"author_username": "string — author's username (without @)"
},
"sample": {
"data": {
"id": 661,
"url": "https://www.zinnes.com.br/obra/661/istella",
"likes": 62,
"title": "Istella",
"views": 2285,
"chapters": [
{
"id": 2770,
"name": "Gigante Vermelha",
"views": 213,
"comments": 2,
"thumbnail": "https://apizinnes.com.br/storage/title-thumbs/r2FIaOVEBQajkj4d6fxHPm0xAnHc7kLy.avif",
"description": "As Piratas Rubra chegam ao planeta Terra com um objetivo muito peculiar.",
"likes_count": 7,
"release_date": "19/02/2026"
}
],
"synopsis": "O universo é uma imensidão de mistérios, onde o novo e desconhecido são sinônimos de aventura! Essa é a história da pirata rubra, Istella.",
"thumbnail": "https://apizinnes.com.br/storage/project-thumbs/MGB9vTjC5xn6EszbaVfj4WlT7AOcdsvM.avif",
"age_rating": "A14",
"categories": [
"Quadrinhos",
"Ação",
"Série"
],
"author_name": "Gilton Ferreira",
"chapters_count": 33,
"author_username": "gilton"
},
"status": "success"
}
}About the Zinnes API
What the API Returns
The get_comic_details endpoint accepts a comic_id string — the numeric ID visible in the comic's URL on zinnes.com.br — and returns a structured object for that comic. Top-level fields include title, synopsis, thumbnail (image URL), url (canonical page link), likes, views, and age_rating (classification codes such as 'A14' or 'L'). The categories array carries all classification labels attached to the comic, covering category, genre, and type in a single flat list.
Chapter-Level Detail
The chapters array is the most granular part of the response. Each chapter object includes id, name, description, views, likes_count, comments, release_date, and a thumbnail URL. This allows per-chapter engagement tracking — for example, comparing view and comment counts across a series to identify which chapters drove the most traffic.
Identifying Comics
The comic_id parameter maps directly to the numeric segment in a Zinnes comic URL. For example, the comic Istella uses ID '661' and Taico uses '12'. There is no search or list endpoint in this API, so callers need the ID in advance, either from the URL or from a separately maintained catalog.
The Zinnes API is a managed, monitored endpoint for zinnes.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when zinnes.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 zinnes.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 reader app displaying Brazilian webcomics with title, synopsis, and chapter thumbnails from
get_comic_details. - Track engagement trends by comparing
viewsandlikesacross multiple comic IDs over time. - Analyze per-chapter performance using
chapters[].viewsandchapters[].commentsto surface high-traffic episodes. - Filter or categorize comics by age rating using the
age_ratingfield for audience-appropriate content curation. - Aggregate genre and type metadata from the
categoriesarray to build a genre-based discovery index. - Monitor new chapter releases by polling
chapters[].release_datefor a set of followed comic IDs. - Enrich a Brazilian comics database with structured author usernames and chapter counts from the API response.
| 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 Zinnes have an official developer API?+
What does the `chapters` array include for each chapter?+
chapters array includes id, name, description, views, likes_count, comments, release_date, and a thumbnail URL. It does not include a direct link to read the chapter pages. You can fork the API on Parse and revise it to add chapter-level page URLs if needed.Can I search or list all comics without knowing a comic ID first?+
comic_id. You can fork the API on Parse and revise it to add a search or browse endpoint that returns comic IDs from keyword or category queries.Does the API return author profile details beyond name and username?+
How current is the comic data, and does the API paginate chapters?+
chapters array returns all available chapters for a comic in a single response with no pagination. Data reflects the current state of the comic page at the time of the request, so view and like counts are point-in-time snapshots rather than historical time series.