KariKari APIkarikari.app ↗
Search and retrieve metadata for webcomics, manga, and HQs on KariKari. Access titles, authors, ratings, synopsis, categories, and ranking data via 2 endpoints.
What is the KariKari API?
The KariKari API gives developers access to Brazil's comics platform through 2 endpoints covering search and detailed obra metadata. The search_items endpoint returns paginated results with title, author, thumbnail, rating, and view count for any keyword query. The get_item_details endpoint returns per-obra fields including synopsis, categories, publication status, age rating, chapter count, and ranking position.
curl -X GET 'https://api.parse.bot/scraper/bcdf64b1-0b1d-4b7c-b503-b3c1b2718e60/search_items?page=1&query=rei' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for obras (works) on KariKari by keyword. Returns matching items with URL, thumbnail, rating, view count, title, and author. The site returns all matching results in a single upstream call; the scraper paginates them locally at 20 items per page. Page 1 is the default. When the query matches nothing the items array is empty.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for client-side pagination (20 items per page). |
| queryrequired | string | Search keyword to match against obra titles and related metadata. |
{
"type": "object",
"fields": {
"page": "current page number",
"items": "array of obra objects, each with url, thumbnail, rating, views, title, and author",
"total": "total number of matching results from the site",
"has_more": "whether more pages are available after the current one",
"total_pages": "total number of pages at 20 items per page"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://karikari.app/obra/rei-morel",
"title": "Rei Morel",
"views": 31,
"author": "Helotoons",
"rating": 4.17,
"thumbnail": "https://cdn.karikari.app/obras/263be5d6-f052-4e87-b5c0-96a46771bbfb/capas/capa_vertical-6412837e-c19c-4cc9-9448-85baa609558a.png"
},
{
"url": "https://karikari.app/obra/reincarnation-as-a-kingdom",
"title": "Reincarnation as a kingdom",
"views": 7,
"author": "Boom_onomato",
"rating": 0,
"thumbnail": "https://cdn.karikari.app/obras/65c7111b-ef98-4318-bffe-c9a8ec8b05c2/capas/capa_vertical-41d72a52-18f0-4af4-9100-1036e1186a52.webp"
}
],
"total": 23,
"has_more": true,
"total_pages": 2
},
"status": "success"
}
}About the KariKari API
Search KariKari Works
The search_items endpoint accepts a required query string and an optional page integer. Results are paginated at 20 items per page. Each item in the items array includes url, thumbnail, title, author, rating (float), and views. The response also returns total, total_pages, and has_more so clients can implement pagination without guessing result counts.
Obra Detail Data
The get_item_details endpoint takes a full obra URL or slug — for example, desculpa-eu-gosto-de-voce — and returns a structured object with 12 distinct fields. These include synopsis, categories (an array of genre strings such as Romance or Drama), status (e.g. Em produção or Finalizada), age_rating (L, 12, 14, 16, or 18), and a ranking object that exposes category_rank, global_rank, category_total, and category when the obra is trending. The rating field is a float on a 1–5 scale and is null for unrated works.
Coverage Notes
All content reflects KariKari's Brazilian Portuguese catalog. Works are identified by slug or full URL, making it straightforward to combine the two endpoints: search for titles matching a keyword, then fetch full details for any slug returned. The last_update date and chapter_count fields from get_item_details are useful for tracking publication activity over time.
The KariKari API is a managed, monitored endpoint for karikari.app — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when karikari.app 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 karikari.app 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 comics discovery app filtered by genre using the
categoriesarray fromget_item_details - Track trending obras by monitoring
global_rankandcategory_rankfrom the ranking object - Generate a reading list sorted by
ratingandviewsusingsearch_itemsresults - Alert users when a followed obra changes
statusfrom Em produção to Finalizada - Filter catalog by
age_ratingto build age-appropriate reading recommendations - Index KariKari obra metadata for a cross-platform Brazilian comics search engine
- Monitor new chapter releases by polling
chapter_countandlast_updatefor tracked slugs
| 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 KariKari have an official developer API?+
What does the `ranking` field in `get_item_details` actually contain?+
ranking field is an object with four keys: category (the genre or list the obra is ranked in), category_rank (its position within that category), global_rank (its position site-wide), and category_total (total works in that category). It is null when the obra is not currently trending or ranked.How does pagination work in `search_items`?+
page parameter to navigate, and check has_more and total_pages to know whether additional pages exist. Page 1 is the default when no page value is supplied.Does the API return individual chapter content or chapter-level metadata?+
chapter_count and last_update, but does not expose individual chapter listings, chapter URLs, or page-level content. You can fork it on Parse and revise to add an endpoint targeting chapter index pages.Can I retrieve a list of all obras by category without a search query?+
search_items endpoint requires a query string; there is no browse-by-category or full-catalog listing endpoint. You can fork this API on Parse and revise it to add a category browsing endpoint.