{"service":"YRUZ Data Intelligence","api_version":"1","products":[{"id":"deps","name":"DependencyPulse","categories":["Software supply-chain intelligence","Package metadata","Release history","Vulnerability intelligence","Dependency graph analysis"],"summary":"Version-aware package intelligence for coding agents and CI: registry metadata, release history, OSV advisory checks, dependency trees and lockfile audits for npm, PyPI and Packagist.","catalogue":"https://yruz.one/api/deps","tasks":[{"task":"deps.package_lookup","task_version":1,"id":"deps-package","title":"DependencyPulse Package","endpoint":"https://yruz.one/api/deps/package","methods":["GET","POST"],"description":"One package from npm, PyPI or Packagist: latest version, description, declared licence, repository, homepage, deprecation or yanked status, version count, first and last publish date, declared dependencies of the latest release, and the OSV advisories that match the latest version. With source links, retrieval time and the changes YRUZ observed since its previous look.","params":{"name":"package name (required), e.g. express, @types/node, requests, monolog/monolog","ecosystem":"npm (default), pypi or composer"},"example":"https://yruz.one/api/deps/package?ecosystem=npm&name=express","price":{"model":"fixed_exact","usd":"0.003","unit":"package"},"limits":{"packages":1},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_get_package","status":"available"},{"task":"deps.version_history","task_version":1,"id":"deps-versions","title":"DependencyPulse Version History","endpoint":"https://yruz.one/api/deps/versions","methods":["GET","POST"],"description":"Release history of a package in ecosystem order (node-semver, PEP 440, Composer): every version with publish time, prerelease flag, deprecation or yank with its reason, which one is latest, release cadence, and changes YRUZ observed between its own snapshots (labelled system-observed).","params":{"name":"package name (required)","ecosystem":"npm (default), pypi or composer","limit":"versions to return, newest first, 1-200 (default 50)","prerelease":"1 to include prereleases (default 0)"},"example":"https://yruz.one/api/deps/versions?ecosystem=pypi&name=requests&limit=20","price":{"model":"fixed_exact","usd":"0.006","unit":"package"},"limits":{"versions":200},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_get_version_history","status":"available"},{"task":"deps.release_compare","task_version":1,"id":"deps-compare","title":"DependencyPulse Release Compare","endpoint":"https://yruz.one/api/deps/compare","methods":["GET","POST"],"description":"What changes between two releases of a package, from registry metadata: dependencies added, removed and re-ranged, licence change, deprecation, publish dates and the releases in between, and which OSV advisories the upgrade fixes, introduces or leaves open. Registry metadata only: a source-code diff is not claimed.","params":{"name":"package name (required)","from":"current version (required), e.g. 4.17.15","to":"target version (default: latest)","ecosystem":"npm (default), pypi or composer"},"example":"https://yruz.one/api/deps/compare?ecosystem=npm&name=lodash&from=4.17.15&to=4.17.21","price":{"model":"fixed_exact","usd":"0.008","unit":"comparison"},"limits":{"versions":2},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_compare_releases","status":"available"},{"task":"deps.advisory_check","task_version":1,"id":"deps-check","title":"DependencyPulse Advisory Check","endpoint":"https://yruz.one/api/deps/check","methods":["GET","POST"],"description":"Is this exact package version affected by a published advisory? Queries OSV (GitHub Advisory Database, PyPA, and more) for the version and returns status (affected or not_affected_by_queried_advisories), every advisory with aliases (CVE), summary, severity, the affected ranges as published, fixed versions and references. The version is checked against the registry first; no advisory is never reported as safe.","params":{"name":"package name (required)","version":"exact version (required), e.g. 4.17.15","ecosystem":"npm (default), pypi or composer"},"example":"https://yruz.one/api/deps/check?ecosystem=npm&name=lodash&version=4.17.15","price":{"model":"fixed_exact","usd":"0.005","unit":"advisory_check"},"limits":{"packages":1},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_check_advisories","status":"available"},{"task":"deps.batch_advisory_check","task_version":1,"id":"deps-batch","title":"DependencyPulse Batch Check","endpoint":"https://yruz.one/api/deps/batch","methods":["GET","POST"],"description":"OSV advisory check of 2-100 package versions in one call, mixed ecosystems: status per package version, advisory ids with summary, severity and fixed versions. Priced 0.002 USDC per unique package version (minimum 0.01, maximum 0.2), quoted exactly in the 402 before you pay.","params":{"packages":"list (required): JSON [{\"ecosystem\":\"npm\",\"name\":\"lodash\",\"version\":\"4.17.15\"}] or text \"npm:lodash@4.17.15, pypi:requests@2.19.0\"","ecosystem":"default ecosystem for items without one (default npm)"},"example":"https://yruz.one/api/deps/batch?packages=npm%3Alodash%404.17.15%2Cnpm%3Aminimist%401.2.5%2Cpypi%3Arequests%402.19.0%2Ccomposer%3Aguzzlehttp%2Fguzzle%407.4.0%2Cnpm%3Aexpress%404.21.2","price":{"model":"per_unit_exact","per_unit_usd":"0.002","min_usd":"0.01","max_usd":"0.2","unit":"advisory_check","note":"Exact price computed from the validated input and quoted in the 402 before payment"},"limits":{"packages_min":2,"packages_max":100,"advisory_details":50},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_batch_check","status":"available"},{"task":"deps.dependency_tree","task_version":1,"id":"deps-tree","title":"DependencyPulse Dependency Tree","endpoint":"https://yruz.one/api/deps/tree","methods":["GET","POST"],"description":"Bounded transitive dependency graph of an npm package version: every node with the declared range, the resolved version (highest published version satisfying the range, as a fresh install without a lockfile would pick), depth, parent, deprecation, and the OSV advisories that match it. Limits are enforced and reported: nothing is silently cut.","params":{"name":"npm package (required), e.g. express","version":"version or range (default latest)","depth":"levels below the package, 1-4 (default 3)","max_nodes":"graph size cap, 10-250 (default 150)","optional":"1 to follow optionalDependencies (default 0)"},"example":"https://yruz.one/api/deps/tree?name=express&depth=2","price":{"model":"fixed_exact","usd":"0.01","unit":"graph"},"limits":{"depth":4,"nodes":250,"registry_lookups":200,"advisory_details":40},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_get_dependency_tree","status":"available"},{"task":"deps.project_audit","task_version":1,"id":"deps-audit","title":"DependencyPulse Project Audit","endpoint":"https://yruz.one/api/deps/audit","methods":["GET","POST"],"description":"Audit a project in one call: send package-lock.json (v2/v3), package.json, composer.lock, composer.json or requirements.txt. Lockfiles give exact direct and transitive versions; manifest ranges are resolved to the highest satisfying version and labelled so; unpinned requirements are listed as unresolved. Returns every affected package with advisories, severity, fixed versions and the smallest fixing upgrade, plus coverage limits. Up to 300 packages per audit.","params":{"manifest":"file content (required): package-lock.json, package.json, composer.lock, composer.json or requirements.txt; POST JSON body recommended","kind":"optional file type: package-lock, package, composer-lock, composer, requirements (auto-detected)","dev":"1 to include dev dependencies (default 0)"},"example":"https://yruz.one/api/deps/audit?manifest=%7B%22dependencies%22%3A%7B%22express%22%3A%22%5E4.17.0%22%2C%22lodash%22%3A%224.17.15%22%2C%22minimist%22%3A%221.2.5%22%7D%7D","price":{"model":"fixed_exact","usd":"0.025","unit":"audit"},"limits":{"packages":300,"range_resolutions":60,"advisory_details":60},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_audit_project","status":"available"},{"task":"deps.advisory_lookup","task_version":1,"id":"deps-advisory","title":"DependencyPulse Advisory","endpoint":"https://yruz.one/api/deps/advisory","methods":["GET","POST"],"description":"One advisory from OSV by its id or alias (GHSA-..., CVE-..., PYSEC-..., RUSTSEC-...): summary, details, severity (CVSS vectors), aliases, published and modified dates, withdrawn flag, every affected package with its ranges and fixed versions as published, and references.","params":{"id":"advisory id (required), e.g. GHSA-29mw-wpgm-hmr9 or CVE-2021-23337"},"example":"https://yruz.one/api/deps/advisory?id=GHSA-35jh-r3h4-6jhm","price":{"model":"fixed_exact","usd":"0.002","unit":"advisory"},"limits":{"advisories":1},"sources":["npm","pypi","packagist","osv"],"freshness":"Advisories cached up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_get_advisory","status":"available"},{"task":"deps.changes_since","task_version":1,"id":"deps-changes","title":"DependencyPulse Changes Since","endpoint":"https://yruz.one/api/deps/changes","methods":["GET","POST"],"description":"Everything that changed for a package since a date: releases published, deprecations and yanks among them, the current latest, advisories published or modified for the package, and attribute changes YRUZ observed between its snapshots. For maintainers, CI and agents re-checking a dependency.","params":{"name":"package name (required)","since":"date YYYY-MM-DD (default 90 days ago)","ecosystem":"npm (default), pypi or composer"},"example":"https://yruz.one/api/deps/changes?ecosystem=npm&name=axios&since=2026-01-01","price":{"model":"fixed_exact","usd":"0.008","unit":"package"},"limits":{"versions":200,"advisories":100},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_get_changes","status":"available"},{"task":"deps.monitor_check","task_version":1,"id":"deps-monitor","title":"DependencyPulse Monitor Check","endpoint":"https://yruz.one/api/deps/monitor","methods":["GET","POST"],"description":"One bounded monitoring check of a package: the current fingerprint of its watched attributes (latest version, licence, deprecation, version count, advisories on the latest release), changed true or false against the fingerprint you kept from your previous check, the attributes that differ from YRUZ's previous observation, and when it was observed. No subscription: you call it on your own schedule, each check is one paid call.","params":{"name":"package name (required)","ecosystem":"npm (default), pypi or composer","fingerprint":"fingerprint returned by your previous check (optional)"},"example":"https://yruz.one/api/deps/monitor?ecosystem=npm&name=axios","price":{"model":"fixed_exact","usd":"0.003","unit":"monitor_check"},"limits":{"packages":1},"sources":["npm","pypi","packagist","osv"],"freshness":"Registry metadata cached up to 10 minutes, advisories up to 1 hour","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"deps_monitor_check","status":"available"}]},{"id":"tenders","name":"TenderGraph","categories":["Public procurement","Tender discovery","Deadline and amendment monitoring","Award and supplier intelligence","Procurement history"],"summary":"Public procurement intelligence from EU TED: tender search, deadlines, notice lifecycle (amendments, awards), awarded suppliers and contracting-authority profiles, with values only as published.","catalogue":"https://yruz.one/api/tenders","tasks":[{"task":"tenders.search","task_version":1,"id":"tenders-search","title":"TenderGraph Search","endpoint":"https://yruz.one/api/tenders/search","methods":["GET","POST"],"description":"Search public tenders and procurement notices published in TED (EU Official Journal S, all EU/EEA countries plus EU-funded procurement such as Serbia): keywords, buyer country, CPV code, contracting authority, awarded supplier, notice type, publication and deadline date ranges and estimated value. Each notice normalized: title, buyer, CPV, procedure, estimated value with currency, lot deadlines, lifecycle stage, winners as published, and the official TED links.","params":{"q":"keywords in the notice text, e.g. cloud software","country":"buyer country, ISO code (DE, DEU, RS, SRB ...)","cpv":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","buyer":"contracting authority name contains","supplier":"awarded supplier name contains (award notices)","type":"competition (calls), result (awards), change (amendments), planning (prior information) or all (default)","published_from":"date YYYY-MM-DD","published_to":"date YYYY-MM-DD","deadline_from":"date YYYY-MM-DD","deadline_to":"date YYYY-MM-DD","value_min":"estimated procedure value at least (in its own currency)","value_max":"estimated procedure value at most","limit":"notices per page, 1-50 (default 20)","page":"page, 1-100 (default 1)","lang":"language of titles, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/search?q=software&country=RS&limit=10","price":{"model":"fixed_exact","usd":"0.005","unit":"task"},"limits":{"notices_per_page":50,"pages":100,"sources":1},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_search","status":"available"},{"task":"tenders.notice_detail","task_version":1,"id":"tenders-notice","title":"TenderGraph Notice","endpoint":"https://yruz.one/api/tenders/notice","methods":["GET","POST"],"description":"One TED notice by its publication number, normalized: notice and form type, lifecycle stage, title and description, buyer with identifiers, CPV codes, procedure type, place of performance, estimated values (procedure and lots, with currency), lot titles and submission deadlines, duration, submission URL, and for results the winners, winner size and country, tender and award values and contract dates as published. With official HTML, PDF and XML links and the changes YRUZ observed since an earlier look.","params":{"id":"TED publication number (required), e.g. 645054-2026","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/notice?id=645054-2026","price":{"model":"fixed_exact","usd":"0.004","unit":"notice"},"limits":{"notices":1},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_notice","status":"available"},{"task":"tenders.notice_history","task_version":1,"id":"tenders-history","title":"TenderGraph Notice History","endpoint":"https://yruz.one/api/tenders/history","methods":["GET","POST"],"description":"The lifecycle of a procurement procedure from one of its notices: every TED notice of the same procedure in order (prior information, call, corrigenda, award, contract modification), the change events between them (deadline changed, estimated value changed, lots changed, change reasons as published, award published, closed without award) and the resulting state. Each event references the notice that supports it; history before eForms (2023) may hold only one notice.","params":{"id":"TED publication number of any notice of the procedure (required)","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/history?id=599727-2026","price":{"model":"fixed_exact","usd":"0.01","unit":"notice"},"limits":{"notices_in_procedure":50},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_history","status":"available"},{"task":"tenders.deadline_check","task_version":1,"id":"tenders-deadlines","title":"TenderGraph Deadlines","endpoint":"https://yruz.one/api/tenders/deadlines","methods":["GET","POST"],"description":"Open calls for tenders whose submission deadline falls in the next 1-90 days, soonest first, with the earliest qualifying lot deadline, buyer, CPV, estimated value and links. Filter by keywords, buyer country, CPV and authority. Deadlines are as published in the latest call notice found; a later corrigendum can move them (check the history).","params":{"q":"keywords in the notice text, e.g. cloud software","country":"buyer country, ISO code (DE, DEU, RS, SRB ...)","cpv":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","buyer":"contracting authority name contains","days":"window in days, 1-90 (default 14)","limit":"notices, 1-50 (default 20)","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/deadlines?cpv=72&days=14&limit=10","price":{"model":"fixed_exact","usd":"0.003","unit":"task"},"limits":{"notices":50,"window_days":90},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_deadlines","status":"available"},{"task":"tenders.award_analysis","task_version":1,"id":"tenders-awards","title":"TenderGraph Award Analysis","endpoint":"https://yruz.one/api/tenders/awards","methods":["GET","POST"],"description":"Published contract award results matching a supplier, buyer, country, CPV or date range: each award with winners, their country and size, award and tender values with currency, decision and contract dates and the buyer. Plus an aggregate per currency (count, sum, median, sample size and date range); amounts are never added across currencies and notices without a value are counted as missing.","params":{"q":"keywords in the notice text, e.g. cloud software","country":"buyer country, ISO code (DE, DEU, RS, SRB ...)","cpv":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","buyer":"contracting authority name contains","supplier":"winner name contains","from":"published from YYYY-MM-DD","to":"published to YYYY-MM-DD","limit":"awards, 1-50 (default 25)","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/awards?country=RS&limit=10","price":{"model":"fixed_exact","usd":"0.02","unit":"task"},"limits":{"awards":50},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_awards","status":"available"},{"task":"tenders.authority_profile","task_version":1,"id":"tenders-authority","title":"TenderGraph Authority Profile","endpoint":"https://yruz.one/api/tenders/authority","methods":["GET","POST"],"description":"Procurement profile of a contracting authority from its TED notices: notice counts by type (calls, awards, amendments, prior information), the most recent notices, CPV divisions and procedure types in the recent sample, name variants and identifiers seen, first and last publication in the sample. Sample size and coverage are stated with every aggregate.","params":{"name":"authority name or part of it (required), e.g. Ministry of Finance","country":"buyer country, ISO code","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/authority?name=Ministry+of+Finance&country=RS","price":{"model":"fixed_exact","usd":"0.01","unit":"task"},"limits":{"sample_notices":50,"count_queries":5},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_authority","status":"available"},{"task":"tenders.supplier_history","task_version":1,"id":"tenders-supplier","title":"TenderGraph Supplier History","endpoint":"https://yruz.one/api/tenders/supplier","methods":["GET","POST"],"description":"Award history of a supplier from TED result notices that name it as a winner: total award notices, a dated timeline of the most recent awards with buyer, country, CPV and values as published, buyers and countries served, CPV divisions, values per currency and name variants. Only explicit award results count; no reputation or risk judgement is made.","params":{"name":"supplier name or part of it (required), e.g. Siemens","country":"buyer country, ISO code","from":"published from YYYY-MM-DD","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/supplier?name=Siemens&country=PL","price":{"model":"fixed_exact","usd":"0.015","unit":"task"},"limits":{"awards":50},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_supplier_history","status":"available"},{"task":"tenders.changes_since","task_version":1,"id":"tenders-changes","title":"TenderGraph Changes Since","endpoint":"https://yruz.one/api/tenders/changes","methods":["GET","POST"],"description":"What happened since a date (up to 92 days back) for your filters: counts and the newest notices of each kind, new calls for tenders, amendments and corrigenda with their change reasons, award results and prior information notices. Poll it to monitor a market, a buyer or a CPV code; each poll is one bounded paid call.","params":{"q":"keywords in the notice text, e.g. cloud software","country":"buyer country, ISO code (DE, DEU, RS, SRB ...)","cpv":"CPV code or prefix, 2-8 digits, e.g. 72 or 72000000","buyer":"contracting authority name contains","since":"date YYYY-MM-DD (default 7 days ago, at most 92 days back)","limit":"notices per kind, 1-25 (default 10)","lang":"language, 2 letters (default en)"},"example":"https://yruz.one/api/tenders/changes?country=RS&since=2026-10-01","price":{"model":"fixed_exact","usd":"0.01","unit":"task"},"limits":{"notices_per_kind":25,"kinds":4,"window_days":92},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_get_changes","status":"available"},{"task":"tenders.monitor_check","task_version":1,"id":"tenders-monitor","title":"TenderGraph Monitor Check","endpoint":"https://yruz.one/api/tenders/monitor","methods":["GET","POST"],"description":"One bounded monitoring check of a procurement procedure from any of its TED notices: the current fingerprint of its watched state (notices in the procedure, stage, lot deadlines, estimated value, winners and award value), changed true or false against the fingerprint you kept, and what differs from YRUZ's previous observation, so a new corrigendum, a moved deadline or a published award is caught. No subscription: each check is one paid call.","params":{"id":"TED publication number of a notice of the procedure (required)","fingerprint":"fingerprint returned by your previous check (optional)"},"example":"https://yruz.one/api/tenders/monitor?id=685949-2026","price":{"model":"fixed_exact","usd":"0.003","unit":"monitor_check"},"limits":{"notices_in_procedure":50},"sources":["ted"],"freshness":"TED Search API, queried live (results cached up to 15 minutes); TED publishes the Official Journal S daily on working days","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"tenders_monitor_check","status":"available"}]},{"id":"reality","name":"RealityGraph","categories":["Entity intelligence","Historical facts","Evidence and provenance","Entity resolution","Change detection"],"summary":"Source-attributed facts about companies, organizations, places and software from Wikidata: entity resolution with explained scores, facts with ranks and references, conflicts, evidence and revision history at a past date.","catalogue":"https://yruz.one/api/reality","tasks":[{"task":"reality.search","task_version":1,"id":"reality-search","title":"RealityGraph Search","endpoint":"https://yruz.one/api/reality/search","methods":["GET","POST"],"description":"Find entities on Wikidata by name or alias, with an optional type filter (company, organization, place, software, person): id, label, description, types, the matched name, Wikipedia sitelink count as a notability signal, and links. The starting point for entity, evidence and resolve calls.","params":{"q":"name to search (required), e.g. Stripe","type":"any (default), company, organization, place, software or person","limit":"results, 1-20 (default 10)","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/search?q=Stripe&type=company","price":{"model":"fixed_exact","usd":"0.003","unit":"task"},"limits":{"results":20,"candidates_scanned":50},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_search","status":"available"},{"task":"reality.entity_profile","task_version":1,"id":"reality-entity","title":"RealityGraph Entity Profile","endpoint":"https://yruz.one/api/reality/entity","methods":["GET","POST"],"description":"Normalized profile of one entity: label, description, aliases, types, official identifiers (LEI, ticker, VIAF, OpenCorporates, national registers ...), and the core facts for its kind (inception, country, headquarters, website, founders, CEO, employees and revenue over time, industry, population, licence, version ...). Every fact keeps rank, qualifiers (start, end, point in time), reference count and a status: observed, observed_unsourced, historical, deprecated or conflicting. Extra properties on request.","params":{"id":"Wikidata id (required unless q), e.g. Q7624104","q":"name instead of id (the top search hit is used and reported)","properties":"extra property ids, comma separated, up to 15, e.g. P1056,P2403","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/entity?id=Q7624104","price":{"model":"fixed_exact","usd":"0.004","unit":"entity"},"limits":{"entities":1,"statements_per_property":20,"extra_properties":15,"identifiers":40},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_get_entity","status":"available"},{"task":"reality.fact_history","task_version":1,"id":"reality-history","title":"RealityGraph Fact History","endpoint":"https://yruz.one/api/reality/history","methods":["GET","POST"],"description":"Time-aware history of an entity: the source's revision log (when, which properties, which kind of edit), when the entity was created, and with as_of the facts the source stated at that past date compared to today (changed, added, removed per property). Plus attribute changes YRUZ observed itself. Source revision dates are when a claim was recorded, not when it became true; effective dates come from qualifiers.","params":{"id":"Wikidata id (required), e.g. Q7624104","as_of":"past date YYYY-MM-DD to compare with now","property":"only edits of this property, e.g. P1128","limit":"revisions, 1-50 (default 25)","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/history?id=Q7624104&as_of=2023-01-01","price":{"model":"fixed_exact","usd":"0.008","unit":"entity"},"limits":{"revisions":50,"snapshots":2},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_get_history","status":"available"},{"task":"reality.compare","task_version":1,"id":"reality-compare","title":"RealityGraph Compare","endpoint":"https://yruz.one/api/reality/compare","methods":["GET","POST"],"description":"Two entities side by side: for every core property the current values of each and whether they are the same, overlap, differ or exist on one side only; shared identifiers (a sign of a duplicate record); and properties neither side states (unsupported comparisons). Accepts ids or names.","params":{"a":"first entity: Wikidata id or name (required)","b":"second entity: Wikidata id or name (required)","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/compare?a=Q312&b=Q2283","price":{"model":"fixed_exact","usd":"0.015","unit":"comparison"},"limits":{"entities":2,"properties":40},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_compare","status":"available"},{"task":"reality.resolve","task_version":1,"id":"reality-resolve","title":"RealityGraph Resolve","endpoint":"https://yruz.one/api/reality/resolve","methods":["GET","POST"],"description":"Entity resolution for a company or organization: from a name plus optional website domain, country, LEI or type, the candidate Wikidata entities with a transparent score, a confidence band (deterministic, high, medium, low), the matching and conflicting attributes, why each matched, and which extra input would disambiguate. Identifier matches (LEI, official website) are deterministic; names only rank. Never merges entities.","params":{"name":"entity name (required), e.g. Stripe","domain":"official website domain, e.g. stripe.com","country":"country, ISO 2-letter code, e.g. US","lei":"Legal Entity Identifier, 20 characters","type":"company, organization, place, software or person"},"example":"https://yruz.one/api/reality/resolve?name=Stripe&domain=stripe.com&country=US","price":{"model":"fixed_exact","usd":"0.01","unit":"task"},"limits":{"candidates":10},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_resolve_entity","status":"available"},{"task":"reality.evidence_bundle","task_version":1,"id":"reality-evidence","title":"RealityGraph Evidence","endpoint":"https://yruz.one/api/reality/evidence","methods":["GET","POST"],"description":"Evidence bundle for an entity: for each requested property (default: its core facts) every statement with rank, qualifiers and all its references (stated in, reference URL, title, publication and retrieval dates, archive URL), a reference-quality grade (sourced, wiki_imported, unsourced), and the Wikipedia articles linked to the entity. Reference URLs are as recorded by the source; they are not fetched live.","params":{"id":"Wikidata id (required)","properties":"property ids, comma separated, up to 10 (default: core facts)","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/evidence?id=Q7624104&properties=P571%2CP159%2CP1128%2CP2139","price":{"model":"fixed_exact","usd":"0.02","unit":"entity"},"limits":{"properties":10,"statements":60,"references_per_statement":10},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_get_evidence","status":"available"},{"task":"reality.conflict_analysis","task_version":1,"id":"reality-conflicts","title":"RealityGraph Conflicts","endpoint":"https://yruz.one/api/reality/conflicts","methods":["GET","POST"],"description":"Source-conflict report for an entity: properties that should hold one current value but hold several (and whether a preferred rank settles it), time series with different values for the same date, deprecated claims with the stated reason, and core facts without a reference or only imported from Wikipedia. Every listed value carries its references so an agent can judge.","params":{"id":"Wikidata id (required)","lang":"language of labels, 2-3 letters (default en)"},"example":"https://yruz.one/api/reality/conflicts?id=Q312","price":{"model":"fixed_exact","usd":"0.02","unit":"entity"},"limits":{"statements_scanned":600},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_get_conflicts","status":"available"},{"task":"reality.monitor_check","task_version":1,"id":"reality-monitor","title":"RealityGraph Monitor Check","endpoint":"https://yruz.one/api/reality/monitor","methods":["GET","POST"],"description":"One bounded monitoring check of an entity: the current fingerprint of its core facts (country, headquarters, website, CEO, employees, revenue, population, version ... by kind), changed true or false against the fingerprint you kept, the facts that differ from YRUZ's previous observation, and the source's latest revision. No subscription: each check is one paid call.","params":{"id":"Wikidata id (required), e.g. Q7624104","fingerprint":"fingerprint returned by your previous check (optional)"},"example":"https://yruz.one/api/reality/monitor?id=Q7624104","price":{"model":"fixed_exact","usd":"0.003","unit":"monitor_check"},"limits":{"entities":1},"sources":["wikidata"],"freshness":"Wikidata read live (cached up to 30 minutes); revision history is the source's own","partial_results":"A source failure answers 503 and is never charged.","mcp_tool":"reality_monitor_check","status":"available"}]}],"payment":{"protocol":"x402","versions":[1,2],"schemes":["exact"],"metered_upto":"not offered: every task is exact-priced before execution (per-unit tasks quote the exact total from the input)","rails":[{"x402Version":2,"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","header":"PAYMENT-SIGNATURE"},{"x402Version":1,"scheme":"exact","network":"solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","header":"X-PAYMENT"},{"x402Version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","header":"PAYMENT-SIGNATURE"},{"x402Version":1,"scheme":"exact","network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","header":"X-PAYMENT"}],"asset":"USDC (canonical: Solana EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v, Base 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)","flow":"Call the endpoint, receive HTTP 402 (v2 PAYMENT-REQUIRED header, v1 JSON body), sign one of the accepts, repeat the identical request with PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1). The task runs before settlement: invalid input is refused with instructions and a source failure answers 503; neither is charged.","receipt":"PAYMENT-RESPONSE header (v2) / X-PAYMENT-RESPONSE (v1); payment status at https://yruz.one/x402.php?r=payment&id=<payment_id>"},"sources":"https://yruz.one/api/data/sources","docs":{"openapi":"https://yruz.one/openapi.json","llms":"https://yruz.one/llms.txt","mcp":"https://yruz.one/mcp/x402","examples":"https://yruz.one/api/examples","manifest":"https://yruz.one/.well-known/x402"},"terms":"https://yruz.one/static/terms","privacy":"https://yruz.one/static/privacy","related":{"tools":[{"tool":"audit","url":"https://yruz.one/api/audit","why":"score any website","usd":"0.01","how":"https://yruz.one/api/instructions?tool=audit"},{"tool":"safety","url":"https://yruz.one/api/safety","why":"is a link safe","usd":"0.005","how":"https://yruz.one/api/instructions?tool=safety"},{"tool":"crypto-price","url":"https://yruz.one/api/crypto/price","why":"live prices","usd":"0.002","how":"https://yruz.one/api/instructions?tool=crypto-price"}],"more_x402_apis":{"402index":"https://402index.io","x402scan":"https://www.x402scan.com","agent402":"https://agent402.tools","x402_protocol":"https://www.x402.org"},"all_yruz_tools":"https://yruz.one/api/instructions"},"cite_as":{"text":"YRUZ x402 API, YRUZ x402 API (https://yruz.one/x402-services), retrieved 2026-11-17.","url":"https://yruz.one/x402-services","retrieved":"2026-11-17","license":"Answers may be quoted with attribution; the primary source keeps its own licence (see provenance)."}}