omegascans.org APIomegascans.org ↗
Access OmegaScans series listings, chapter content, search, and announcements via 9 structured endpoints. Filter by status, sort order, and pagination.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/893c251c-0fa4-4f52-ae4d-31f3b7584a25/get_homepage' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns homepage content including trending series, announcements, and latest comic updates.
No input parameters required.
{
"type": "object",
"fields": {
"trending": "array of trending series objects with id, title, series_slug, thumbnail, status, and bookmark counts",
"announcements": "array of announcement objects with id, title, slug, and created_at",
"latest_updates": "array of recently updated comic series objects with chapters and metadata"
},
"sample": {
"data": {
"trending": [
{
"id": 547,
"meta": {
"chapters_count": "81",
"who_bookmarked_count": "4653"
},
"badge": "NEW",
"title": "Regressed Warrior’s Female Dominance Diary",
"status": "Ongoing",
"thumbnail": "https://media.omegascans.org/file/zFSsXt/jhmgtzcjc39ud8a1yqpoodc2.webp",
"series_slug": "regressed-warriors-female-dominance-diary"
}
],
"announcements": [
{
"id": 26,
"slug": "new-discord-server",
"title": "New Discord Server",
"created_at": "2025-08-05T15:43:07.159+00:00"
}
],
"latest_updates": [
{
"id": 765,
"meta": {
"chapters_count": "6"
},
"title": "Magical Girl Wife",
"status": "Ongoing",
"series_slug": "magical-girl-wife",
"series_type": "Comic",
"free_chapters": [],
"paid_chapters": []
}
]
},
"status": "success"
}
}About the omegascans.org API
The OmegaScans API exposes 9 endpoints covering manga and novel series data from omegascans.org, including series metadata, paginated chapter lists, reader content, and sitewide announcements. The get_chapter endpoint returns image URLs and next/previous navigation links for a specific chapter, while search_series lets you query titles by keyword and get back slug identifiers you can pass to downstream endpoints.
Series Discovery and Filtering
The list_comics and list_novels endpoints return paginated series arrays, each with id, title, series_slug, thumbnail, status, and associated chapters. Both accept status filters (Ongoing, Hiatus, Dropped, Completed, or All), a sort field via order_by (created_at, updated_at, or title), and order (asc or desc). The meta object in every response includes total, current_page, last_page, and page URLs for cursor-style navigation.
Series Detail and Chapters
get_series takes a series slug and returns the full metadata record: author, studio, description (HTML string), tags array, rating, status, and a meta object with chapters_count and who_bookmarked_count. To enumerate chapters, pass the numeric series_id (from get_series or search_series) to get_series_chapters, which returns chapters ordered newest-first with chapter_name, chapter_slug, chapter_thumbnail, price, and created_at. Chapters marked with a non-zero price field are paywalled on the source site.
Chapter Reader Content
get_chapter takes both a series_slug and a chapter_slug and returns the chapter object containing chapter_data.images (an array of image URLs), views, and price, plus next_chapter and previous_chapter navigation objects (or null at series boundaries). This is the only endpoint that exposes actual page-image URLs.
Homepage and Announcements
get_homepage bundles trending series (with bookmark counts), announcements, and latest updates in a single call — useful for building a dashboard or monitoring what's currently active. get_announcements returns 3 announcement objects per page (server-enforced), each with id, title, slug, and created_at. get_latest_updates provides the full paginated feed of recently updated series with separate free_chapters and paid_chapters arrays.
- Build a reading tracker that monitors
get_latest_updatesfor new chapters on followed series slugs. - Index all OmegaScans manga titles and statuses using
list_comicswithstatus=Completedfor archive purposes. - Implement a title search feature using
search_seriesand resolve full metadata withget_seriesfor matched slugs. - Render a chapter reader by fetching
chapter_data.imagesfromget_chapterand wiring thenext_chapter/previous_chapternavigation fields. - Track bookmark popularity trends by comparing
who_bookmarked_countfromget_seriesacross periodic calls. - Aggregate OmegaScans announcements into a notification feed using
get_announcementswithcreated_attimestamps. - Distinguish free vs. paid chapter availability using the
pricefield inget_series_chaptersresponses.
| 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 OmegaScans have an official developer API?+
Can I retrieve the actual page images for a chapter?+
get_chapter endpoint returns a chapter_data.images array containing the image URLs for that chapter. You need both the series_slug and the chapter_slug (obtainable from get_series_chapters) to make the request. Note that chapters with a non-zero price field are paywalled on the source site, and their image content may not be accessible.How does search pagination work in `search_series`?+
search_series returns up to 12 results per page and includes a meta object with total, current_page, and last_page. The only required input is a query string; there are no additional filters for status or series type in this endpoint.Does the API expose user accounts, reading history, or personal bookmarks?+
get_series (the who_bookmarked_count field), but individual user reading history and personal lists are not included. You can fork this API on Parse and revise it to add any missing endpoint if that data becomes publicly accessible.Is there a way to filter series by genre or tag?+
list_comics and list_novels endpoints currently filter by status and sort by created_at, updated_at, or title. Tag data is returned per-series in the tags array from get_series, but tag-based filtering is not a parameter on the list endpoints. You can fork this API on Parse and revise it to add tag filtering if needed.