OmegaScans APIomegascans.org ↗
Access OmegaScans series listings, chapter content, search, and announcements via 9 structured endpoints. Filter by status, sort order, and pagination.
What is the OmegaScans 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.
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'
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 omegascans-org-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.
from parse_apis.omegascans_api import OmegaScans, Status, SortField, SortDirection
client = OmegaScans()
# Search for comics by keyword
results = client.serieses.search(query="money")
for series in results:
print(series.title, series.series_slug, series.status)
# List ongoing comics sorted by update date
comics = client.serieses.list_comics(
order_by=SortField.UPDATED_AT,
order=SortDirection.DESC,
status=Status.ONGOING,
limit=5,
)
for comic in comics:
full = comic.details()
print(full.title, full.author, full.studio, full.rating)
# Get chapters for a specific series
series = client.serieses.get(series_slug="money-games")
for chapter in series.chapters(limit=3):
print(chapter.chapter_name, chapter.chapter_slug, chapter.price)
# Read a specific chapter's content via sub-resource
detail = series.chapter.get(chapter_slug="chapter-1")
print(detail.chapter_name, detail.views, len(detail.images))
# List announcements
for ann in client.announcements.list():
print(ann.title, ann.slug, ann.created_at)
Returns homepage content including trending series (weekly), sitewide announcements, and the latest comic updates sorted by update date. Trending items include bookmark counts and chapter counts. Announcements include title, slug, and creation date. Latest updates include full series objects with their recent free and paid chapters.
No input parameters required.
{
"type": "object",
"fields": {
"trending": "array of trending series objects with id, title, series_slug, thumbnail, status, and meta (chapters_count, who_bookmarked_count)",
"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": 689,
"meta": {
"chapters_count": "98",
"who_bookmarked_count": "4309"
},
"title": "Wireless Onahole",
"status": "Ongoing",
"thumbnail": "https://media.omegascans.org/file/zFSsXt/c2pkxyutdjkr2uzvdekasv4f.webp",
"series_slug": "wireless-onahole"
}
],
"announcements": [
{
"id": 26,
"slug": "new-discord-server",
"title": "New Discord Server",
"created_at": "2025-08-05T15:43:07.159+00:00"
}
],
"latest_updates": [
{
"id": 779,
"meta": {
"chapters_count": "7"
},
"title": "Love Cheer!",
"status": "Ongoing",
"thumbnail": "https://media.omegascans.org/file/zFSsXt/urybkwv7g0ih7t8fak7b4vm5.webp",
"series_slug": "love-cheer",
"series_type": "Comic",
"free_chapters": [
{
"id": 13593,
"series_id": 779,
"created_at": "2026-06-09T15:18:32.924+00:00",
"chapter_name": "Chapter 7",
"chapter_slug": "chapter-7"
}
],
"paid_chapters": []
}
]
},
"status": "success"
}
}About the OmegaScans API
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.
The OmegaScans API is a managed, monitored endpoint for omegascans.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when omegascans.org 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 omegascans.org 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 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 | 100 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.