Omron APIfa.omron.co.jp ↗
Access Omron industrial automation vulnerability advisories and CVE data. Search by product, retrieve OMSR details, and pull the latest RSS security feed.
What is the Omron API?
This API exposes 5 endpoints covering Omron Industrial Automation's Product Security advisories from fa.omron.co.jp. Use get_advisory_detail_by_id to retrieve full CVE identifiers, CVSS scores, affected product names, and third-party advisory links for a specific OMSR ID, or use search_vulnerabilities_by_product to find all advisories matching a product name or keyword across both the advisory title and affected-products fields.
curl -X GET 'https://api.parse.bot/scraper/9c03c77d-208b-4eed-be6a-7feffdd351b9/get_vulnerability_advisory_list?language=en' \ -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 fa-omron-co-jp-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: Omron FA Security Advisory API — monitor vulnerabilities, search by product, drill into CVE details."""
from parse_apis.omron_fa_security_advisory_api import OmronSecurity, Language, AdvisoryNotFound
client = OmronSecurity()
# List all advisories (newest first); limit caps total items fetched.
for advisory in client.advisorysummaries.list(language=Language.EN, limit=5):
print(advisory.advisory_number, advisory.omron_advisory_title, advisory.affected_products)
# Search for a specific product's vulnerabilities.
match = client.advisorysummaries.search(query="CX-Programmer", limit=1).first()
if match:
print(match.advisory_number, match.omron_advisory_title)
# Drill into full detail — fetches CVE IDs from linked third-party source.
detail = match.details()
print(detail.advisory_number, detail.cve_ids, detail.cvss_score)
# RSS feed for latest announcements.
for item in client.rssitems.list(language=Language.EN, limit=3):
print(item.title, item.pub_date, item.link)
# Lightweight health-check: fetch the security portal page info.
try:
page = client.securitypages.get()
print(page.title, page.url)
except AdvisoryNotFound as exc:
print(f"Advisory gone: {exc.omsr_id}")
print("exercised: advisorysummaries.list / advisorysummaries.search / details / rssitems.list / securitypages.get")
Fetches all published vulnerability advisories from Omron's Product Security page. Each advisory includes the OMSR identifier, release/modification dates, affected products, title, link to the Omron PDF, revision remarks, and any third-party advisory reference. The list is ordered by recency (newest first). Serves as the entry point for browsing the full advisory catalog.
| Param | Type | Description |
|---|---|---|
| language | string | Language of the advisory list. Accepted values: 'en', 'jp'. |
{
"type": "object",
"fields": {
"advisories": "array of advisory summary objects with advisory_number, date_info, affected_products, omron_advisory_title, omron_advisory_link, remarks, third_party_advisory, third_party_link"
}
}About the Omron API
Advisory List and RSS Feed
The get_vulnerability_advisory_list endpoint returns every published Omron security advisory in a structured array. Each advisory object includes an advisory_number (OMSR identifier), date_info, affected_products, omron_advisory_title, a direct omron_advisory_link to the PDF, and remarks for revision notes. The language parameter accepts 'en' or 'jp', letting you retrieve advisories in English or Japanese. The get_vulnerability_advisory_rss endpoint returns the same feed in RSS form — each item carries a title, link, and pubDate — useful for monitoring new advisory publications.
Advisory Detail by OMSR ID
Passing a specific OMSR ID (format OMSR-YYYY-NNN) to get_advisory_detail_by_id enriches the base advisory data with CVE identifiers drawn from linked third-party sources such as JVN. The response includes a cve_ids array, a cvss_score string (may be empty if not yet assigned), the third_party_link URL, and the third_party_advisory name. This makes it straightforward to correlate Omron advisories with CVE databases or CVSS-based risk workflows.
Product-Scoped Vulnerability Search
The search_vulnerabilities_by_product endpoint accepts a free-text query string and performs a case-insensitive match against both the affected_products field and the advisory title in the English advisory list. Results are returned in the same structure as the full advisory list, making it easy to filter advisories relevant to a specific PLC model, sensor series, or software package without post-processing the entire list client-side.
Security Overview Page
The get_security_main_page endpoint returns the url and title of the Omron Product Security overview page. This is a lightweight utility endpoint suited for verifying the canonical page location or building navigation links in dashboards that aggregate industrial security content.
The Omron API is a managed, monitored endpoint for fa.omron.co.jp — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fa.omron.co.jp 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 fa.omron.co.jp 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?+
- Automated CVE ingestion pipeline that maps Omron OMSR advisories to internal vulnerability tracking systems using
cve_idsfromget_advisory_detail_by_id. - Product-specific security monitoring that queries
search_vulnerabilities_by_productwhenever a new Omron device is added to an OT/ICS asset inventory. - CVSS-based risk triage that collects
cvss_scorefields across all advisories to prioritize patching for industrial control environments. - RSS-driven alerting system that polls
get_vulnerability_advisory_rssto notify security teams when new Omron advisories are published. - Multilingual compliance reporting that pulls advisory lists in both
'en'and'jp'to satisfy requirements across different regional offices. - Third-party advisory cross-referencing that uses
third_party_linkto join Omron advisories with JVN or NVD entries in a unified vulnerability database.
| 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 Omron provide an official developer API for its Product Security advisories?+
What does `get_advisory_detail_by_id` return beyond what the advisory list provides?+
cve_ids (an array of CVE identifier strings from the linked third-party advisory), cvss_score, third_party_link, and third_party_advisory name. The base list endpoints do not include CVE IDs or CVSS scores; you need to call the detail endpoint with a specific omsr_id to get those fields.Does `search_vulnerabilities_by_product` search Japanese-language advisories?+
affected_products field and advisory title from the 'en' language feed. Japanese-language advisory content is available through get_vulnerability_advisory_list with language: 'jp' and get_vulnerability_advisory_rss with language: 'jp', but those results are not included in the search index. You can fork this API on Parse and revise it to extend the search endpoint to cover the Japanese advisory list as well.Is there a way to retrieve the full text or remediation guidance from an advisory PDF?+
omron_advisory_link as a URL to the Omron PDF advisory, but does not parse or return the PDF body text, remediation steps, or mitigation details. You can fork this API on Parse and revise it to add an endpoint that fetches and extracts text from the linked advisory PDF.How fresh is the advisory data, and does the API support pagination?+
search_vulnerabilities_by_product to narrow results is the recommended approach.