Wikirate JSON-LD & Ontology Guide

Version: 1.0
Namespace: https://wikirate.org/ontology/
Contexts Base URL: https://wikirate.org/context/

1. Introduction

Wikirate’s REST API now supports JSON-LD, allowing all API resources to be represented as Linked Data. This enables:

Semantic interoperability
Use of Wikirate data in RDF stores and triple stores
Compatibility with tools such as Apache Jena and RDFLib
Clear machine-readable definitions of entities, properties, and relationships
Cross-referencing between Wikirate objects through globally unique IRIs

This guide combines:

Developer-facing API documentation (how to request and consume JSON-LD)
Public semantic-web documentation (ontology, vocabulary, contexts, semantics)

2. Requesting JSON-LD from the Wikirate REST API

JSON-LD output is available for all major Wikirate entities.

To request JSON-LD, you can:

Append ?format=jsonld to the URL:
https://wikirate.org/Companies?format=jsonld
Add .jsonld at the end of the requested resource:
https://wikirate.org/Companies.jsonld
Include the following header on your request:
Accept: application/ld+json

Example: Fetch all companies in JSON-LD

GET https://wikirate.org/Companies.jsonld

Example: Fetch a single company

GET https://wikirate.org/Adidas_AG.jsonld

3. JSON-LD Structure

All JSON-LD responses returned by Wikirate are structured as:

{
  "@context": "https://wikirate.org/contexts/company.jsonld",
  "@id": "https://wikirate.org/companies/1234",
  "@type": "wikirate:Company",
  ...
}

Key Components

Element	Description
`@context`	Defines the meaning of all terms in the response.
`@id`	Global IRI identifying the resource.
`@type`	Class from the Wikirate ontology (e.g., `wikirate:Company`).
properties	Mapped exactly as defined in each context file.

4. JSON-LD Contexts

Each entity type has its own context file located at:
https://wikirate.org/context/{ENTITY_TYPE}.jsonld

Available contexts

Entity	Context URL
Company	https://wikirate.org/context/Company.jsonld
Metric	https://wikirate.org/context/Metric.jsonld
Relationship	https://wikirate.org/context/Relationship.jsonld
Answer	https://wikirate.org/context/Answer.jsonld
Source	https://wikirate.org/context/Source.jsonld
Topic	https://wikirate.org/context/Topic.jsonld

These contexts define:

Short terms available in API responses
Their mapping to ontology IRIs
Datatype information (e.g., strings, numbers, IRIs)
Links between entities

5. Examples by Entity

5.1 Company Example

GET https://wikirate.org/Adidas_AG.jsonld

{
  "@context": "https://wikirate.org/context/Company.jsonld",
  "@id": "https://wikirate.org/Adidas_AG",
  "@type": "Company",
  "name": "Adidas AG",
  "alias": [
    "Adidas",
    "Adidas AG",
    "adidas-group"
  ],
  "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/7218/12604207-medium.jpg",
  "country": "Germany",
  "lei": "549300JSX0Z4CW0V5023",
  "isin": [
    "DE000A1EWWW0",
    "US00687A1079",
    "US00687P1049"
  ],
  "open_corporates_id": "D3304V_HRB3868",
  "wikidata_id": "Q3895",
  "same_as": [
    "https://www.adidas.com/",
    "https://en.wikipedia.org/wiki/Adidas",
    "https://opencorporates.com/companies/de/D3304V_HRB3868",
    "https://search.gleif.org/#/record/549300JSX0Z4CW0V5023",
    "https://www.wikidata.org/wiki/Q3895"
  ]
}

5.2 Metric Examples

GET https://wikirate.org/Global_Reporting_Initiative+Direct_greenhouse_gas_GHG_emissions_Scope_1_GRI_305_1_a_formerly_G4_EN15_a.jsonld

{
  "@context": "https://wikirate.org/context/Metric.jsonld",
  "@id": "https://wikirate.org/Global_Reporting_Initiative+Direct_greenhouse_gas_GHG_emissions_Scope_1_GRI_305_1_a_formerly_G4_EN15_a",
  "@type": "Metric",
  "title": "Direct greenhouse gas (GHG) emissions (Scope 1), GRI 305-1-a (formerly G4-EN15-a)",
  "designer": "https://wikirate.org/Global Reporting Initiative",
  "metric_type": "Researched",
  "about": "This metric is based on the Global Reporting Initiative (GRI) Standard Guidelines. \r\nIn 2018, the GRI G4 Sustainability Reporting Guidelines were superseded by the GRI Sustainability Reporting Standards (GRI standards). For this metric, the code G4-EN15-a is used in company reporting prior to 2018, and the new GRI 305-1 code used in reporting from 2018 onwards. The methodology for the former G4 standard for this metric can be found here. \r\nIn the context of the GRI Standards, the environmental dimension of sustainability concerns an organization’s impacts on living and non-living natural systems, including land, air, water and ecosystems.\r\nGRI 305 addresses emissions into air, which are the discharge of substances from a source into the atmosphere. Types of emissions include: greenhouse gas (GHG), ozone-depleting substances (ODS), and nitrogen oxides (NOX) and sulfur oxides (SOX), among other significant air emissions.\r\nGHG emissions are a major contributor to climate change and are governed by the United Nations (UN) ‘Framework Convention on Climate Change’ and the subsequent UN ‘Kyoto Protocol’. This Standard covers the following GHGs:\r\n\r\nCarbon dioxide (CO2)\r\nMethane (CH4)\r\nNitrous oxide (N2O)\r\nHydrofluorocarbons (HFCs)\r\nPerfluorocarbons (PFCs)\r\nSulphur hexafluoride (SF6)\r\nNitrogen trifluoride (NF3)\r\n\r\nSome GHGs, including methane, are also air pollutants that have significant adverse impacts on ecosystems, air quality, agriculture, and human and animal health.\r\nAs a result, different national and international regulations and incentive systems, such as emissions trading, aim to control the volume and reward the reduction of GHG emissions.\r\nThe GHG Protocol has established a classification of GHG emissions called ‘Scope’: Scope 1, Scope 2 and Scope 3. The GHG emissions standard published by the International Organization for Standardization (ISO), ‘ISO 14064’, represents these classifications of Scope with the following terms:\r\n\r\nDirect GHG emissions (Scope 1): GHG emissions from sources that are owned or controlled by an organization\r\nEnergy indirect GHG emissions (Scope 2): GHG emissions that result from the generation of purchased or acquired electricity, heating, cooling, and steam consumed by an organization\r\nOther indirect GHG emissions (Scope 3): Indirect GHG emissions not included in energy indirect (Scope 2) GHG emissions that occur outside of the organization, including both upstream and downstream emissions\r\n",
  "methodology": "Instructions\r\nTo answer this metric question, identify the organization’s Direct GHG emissions (Scope 1) for a specific year.\r\nStart by looking for publicly available documents that may contain this information, such as:\r\n\r\nAnnual Report (with Non-Financial Data)\r\nESG Report\r\nImpact Report\r\nSustainability Report\r\nClimate Disclosure\r\n\r\nDo NOT use the following reports:\r\n\r\nForm 10-K\r\nAnnual Information Form (if it contains only financial data)\r\nInterim Report\r\nQuarterly Report\r\n\r\nKeywords and search terms for this metric\r\n\r\nGHG\r\nGreenhouse Gas Emissions\r\nScope 1\r\nGRI\r\n GRI Index\r\n305-1\r\n EN15\r\n\r\n If the answer is not reported or found in appropriate documents, select the Unknown answer box.\r\nAnswers & Calculations\r\nOnce you have found the answer, make sure the unit of measurement fits to the question on Wikirate. If any calculations or unit conversions are done, include these in the Comments field alongside the page number where you found the answer. Select the 'Unknown' answer box if the company has not published the data.\r\nUnits\r\nCompanies may report their GHG emissions in hundreds, thousands or millions of tonnes. Make sure you check the unit of measurement and enter the full number into the answer field.\r\nE.g. If the company says '0.5 million tonnes CO2e' the answer should be entered on Wikirate as '500000 tonnes'.\r\nFor conversions, Convertunits.com can be helpful.",
  "topics": [
    "https://wikirate.org/Wikirate_ESG_Topics+Environment",
    "https://wikirate.org/Wikirate_ESG_Topics+Climate_Change",
    "https://wikirate.org/Wikirate_ESG_Topics+Greenhouse_Gas_GHG_Emissions"
  ],
  "framework_mappings": [
    "https://wikirate.org/GRI_Standards",
    "https://wikirate.org/GRI_Standards+GRI_305_Emissions",
    "https://wikirate.org/GRI_Standards+305_1_Direct_Scope_1_GHG_emissions",
    "https://wikirate.org/GRI_Standards+305_1_a_Gross_direct_Scope_1_GHG_emissions",
    "https://wikirate.org/ESRS_Standards",
    "https://wikirate.org/ESRS_Standards+E1_Climate_Change",
    "https://wikirate.org/ESRS_Standards+E1_8_Gross_Scopes_1_2_3_GHG_emissions",
    "https://wikirate.org/UN_SDGs",
    "https://wikirate.org/UN_SDGs+SDG3_Good_Health_and_Well_Being",
    "https://wikirate.org/UN_SDGs+SDG3_9_Reduce_deaths_and_illnesses_from_hazardous_chemicals_and_pollution_of_air_water_and_soil",
    "https://wikirate.org/UN_SDGs+SDG12_Responsible_Consumption_and_Production",
    "https://wikirate.org/UN_SDGs+SDG12_2_Achieve_sustainable_management_and_efficient_use_of_natural_resources",
    "https://wikirate.org/UN_SDGs+SDG13_Climate_Action",
    "https://wikirate.org/UN_SDGs+SDG13_2_Integrate_climate_change_measures_into_national_policies_strategies_and_planning",
    "https://wikirate.org/UN_SDGs+SDG14_Life_Below_Water"
  ],
  "calculations": [
    "https://wikirate.org/Richard_Mills+Combined_Scope_1_and_2_Greenhouse_Gas_emissions.json",
    "https://wikirate.org/Wikirate_Calculated_Metric_Design_Group+Progress_Scope_1_Emissions.json",
    "https://wikirate.org/Wikirate_SDG_Metric_design+Common_Environmental_Metrics_Reported.json",
    "https://wikirate.org/Commons+Greenhouse_Gas_Emissions_Scope_1.json",
    "https://wikirate.org/Wikirate_Calculated_Metric_Design_Group+Disclosure_rate_on_selected_social_and_environmental_metrics.json",
    "https://wikirate.org/University_of_Sydney_SDG_Research_Group_2019+Emissions_and_Energy_Disclosure.json",
    "https://wikirate.org/Nottingham_Trent_SDG_Summer_School_2019_Research_Group+Nottingham_Trent_SDG_Disclosure_Rate.json",
    "https://wikirate.org/Ewha_Womans_University_Research_Group+Ewha_2020_SDG12_Disclosure_Rate.json",
    "https://wikirate.org/University_of_Wollongong_Research_Group_2020+Wollongong_2020_Climate_Disclosure_Rate.json",
    "https://wikirate.org/Higher_School_of_Economics_Research_Group_2020+From_Farm_to_Fork_2020_Disclosure_Rate.json",
    "https://wikirate.org/Apparel_Research_Group+Emissions_Disclosure_Rate.json",
    "https://wikirate.org/Laureen_van_Breen+Scope_1_GHG_over_number_of_employees.json",
    "https://wikirate.org/Gershon_M_Bialer+CO2e_Intensity.json",
    "https://wikirate.org/Richard_Mills+Greenhouse_gas_disclosure_rate_of_investees.json",
    "https://wikirate.org/GreenDex+Scope_1_Greenhouse_Gas_Emissions.json"
  ],
  "report_type": "Corporate Social Responsibility Report",
  "value_type": "Number",
  "value_options": [
    "Unknown"
  ],
  "unit": " tonnes CO2 equivalent",
  "license": "https://creativecommons.org/licenses/by/4.0"
}

GET https://wikirate.org/Fashion_Revolution+Fashion_Transparency_Index_2025.jsonld

{
  "@context": "https://wikirate.org/context/Metric.jsonld",
  "@id": "https://wikirate.org/Fashion_Revolution+Fashion_Transparency_Index_2025",
  "@type": "Metric",
  "title": "Fashion Transparency Index 2025",
  "designer": "https://wikirate.org/Fashion Revolution",
  "metric_type": "Rating",
  "about": "While we are seeing companies share their policies and commitments on human rights and the environment, there is still much crucial information about the practices of the fashion industry that remains concealed - particularly when it comes to impacts on the lives of workers in the supply chain and on the environment.\r\nThe Fashion Transparency Index 2025 is a special edition reviews and ranks 200 of the world's largest fashion brands on disclosure of their climate and energy-related policies, practices and impacts in their own operations and supply chains.\r\nSource: https://www.fashionrevolution.org/transparency/\r\nThis year for the sixth time, Fashion Revolution has partnered with Wikirate to make the Fashion Transparency Index and its underlying data more accessible and comparable through Wikirate's open data platform. Wikirate supports benchmarking initiatives in making their company data and scoring systems available for anyone to use in research and advocacy. \r\nA note on the scoring system\r\nWikirate has a standardised 10-point scoring system making it possible to compare company scores across different benchmarks. On Wikirate.org, the Fashion Transparency Index scoring system, where each company can get a maximum of 250 points, has been converted to the 10-point scoring system - with 10 being the highest a company can score and 0 being the lowest. These company scores can also be translated to percentages e.g. if a company has scored 2.5 out of 10 on Wikirate, they have achieved 25% of the 250 points in the Fashion Transparency Index.\r\nThe Fashion Transparency Index is licensed under a Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0). It is not a Free Culture Licence. Please see the link for more information: https://creativecommons.org/licenses/by-nc-nd/4.0/",
  "topics": [
    "https://wikirate.org/Wikirate_ESG_Topics+Climate_Targets_Transition_Plans",
    "https://wikirate.org/Wikirate_ESG_Topics+Executive_Pay_Bonuses",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Goals_Targets",
    "https://wikirate.org/Wikirate_ESG_Topics+Climate_Change",
    "https://wikirate.org/Wikirate_ESG_Topics+Environment",
    "https://wikirate.org/Wikirate_ESG_Topics+Financial_Governance",
    "https://wikirate.org/Wikirate_ESG_Topics+Governance",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Strategy",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainable_Materials",
    "https://wikirate.org/Wikirate_ESG_Topics+Supplier_Code_of_Conduct",
    "https://wikirate.org/Wikirate_ESG_Topics+Supplier_Audits_Monitoring",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainable_Supply_Chains",
    "https://wikirate.org/Wikirate_ESG_Topics+Climate_Change_Policy",
    "https://wikirate.org/Wikirate_ESG_Topics+Greenhouse_Gas_GHG_Emissions",
    "https://wikirate.org/Wikirate_ESG_Topics+Carbon_Footprint_of_Supply_Chain",
    "https://wikirate.org/Wikirate_ESG_Topics+Supply_Chain_Transparency",
    "https://wikirate.org/Wikirate_ESG_Topics+Corporate_Governance_Structure",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_ESG_Reporting",
    "https://wikirate.org/Wikirate_ESG_Topics+Transparency",
    "https://wikirate.org/Wikirate_ESG_Topics+Corporate_Governance",
    "https://wikirate.org/Wikirate_ESG_Topics+Stakeholder_Accountability",
    "https://wikirate.org/Wikirate_ESG_Topics+Community_Engagement_Programs",
    "https://wikirate.org/Wikirate_ESG_Topics+Community_Impact",
    "https://wikirate.org/Wikirate_ESG_Topics+Social",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Governance_Oversight",
    "https://wikirate.org/Wikirate_ESG_Topics+Social_Dialogue_Stakeholder_Engagement",
    "https://wikirate.org/Wikirate_ESG_Topics+Just_Transition",
    "https://wikirate.org/Wikirate_ESG_Topics+Local_Sourcing",
    "https://wikirate.org/Wikirate_ESG_Topics+Energy_Management_Efficiency",
    "https://wikirate.org/Wikirate_ESG_Topics+Energy",
    "https://wikirate.org/Wikirate_ESG_Topics+Clean_and_Renewable_Energy",
    "https://wikirate.org/Wikirate_ESG_Topics+Energy_Sourcing",
    "https://wikirate.org/Wikirate_ESG_Topics+Climate_Risk_Management",
    "https://wikirate.org/Wikirate_ESG_Topics+ESG_Risk_Integration",
    "https://wikirate.org/Wikirate_ESG_Topics+Risk_Management",
    "https://wikirate.org/Wikirate_ESG_Topics+Equity_in_Climate_Policies",
    "https://wikirate.org/Wikirate_ESG_Topics+Inclusion_in_Transition_Planning",
    "https://wikirate.org/Wikirate_ESG_Topics+Reskilling_Workforce_Transition",
    "https://wikirate.org/Wikirate_ESG_Topics+Supplier_Diversity",
    "https://wikirate.org/Wikirate_ESG_Topics+Employee_Training_Development",
    "https://wikirate.org/Wikirate_ESG_Topics+Diversity_Equity_Inclusion_DEI",
    "https://wikirate.org/Wikirate_ESG_Topics+Education_Training",
    "https://wikirate.org/Wikirate_ESG_Topics+Modern_Slavery",
    "https://wikirate.org/Wikirate_ESG_Topics+Human_Rights_Due_Diligence",
    "https://wikirate.org/Wikirate_ESG_Topics+Human_Rights"
  ],
  "calculations": [
    "https://wikirate.org/Fashion_Revolution+Fashion_Transparency_Index.json"
  ],
  "variables": [
    "https://wikirate.org/Fashion_Revolution+1_Accountability_Score_revised.json",
    "https://wikirate.org/Fashion_Revolution+2_Decarbonisation_Score_revised.json",
    "https://wikirate.org/Fashion_Revolution+3_Energy_Procurement_Score_revised.json",
    "https://wikirate.org/Fashion_Revolution+4_Financing_Decarbonisation_Score_revised.json",
    "https://wikirate.org/Fashion_Revolution+5_Just_Transition_Advocacy_Score_revised.json"
  ],
  "license": "https://creativecommons.org/licenses/by/4.0"
}

5.3 Relationship Example

GET https://wikirate.org/Commons+Supplied_By+Adidas_AG+2022+NK_APPAREL_CO_LTD.jsonld

{
  "@context": "https://wikirate.org/context/Relationship.jsonld",
  "@id": "https://wikirate.org/Commons+Supplied_By+Adidas_AG+2022+NK_APPAREL_CO_LTD",
  "@type": "Relationship",
  "name": "Commons+Supplied By+Adidas AG+2022+NK APPAREL CO LTD",
  "metric": "https://wikirate.org/Commons+Supplied_By",
  "subject_company": "https://wikirate.org/Adidas_AG",
  "object_company": "https://wikirate.org/NK_APPAREL_CO_LTD",
  "predicate": "Supplied By",
  "value": [
    "Tier 1 Supplier"
  ],
  "year": "2022",
  "source": [
    "https://wikirate.org/Source_000162261"
  ],
  "license": "https://creativecommons.org/licenses/by/4.0"
}

5.4 Answer Example

GET https://wikirate.org/Australian_Government_Clean_Energy_Regulator+Greenhouse_Gas_Emissions_GHG_Scope_1+Woolworths_Limited+2024.jsonld

{
  "@context": "https://wikirate.org/context/Answer.jsonld",
  "@id": "https://wikirate.org/Australian_Government_Clean_Energy_Regulator+Greenhouse_Gas_Emissions_GHG_Scope_1+Woolworths_Limited+2024",
  "@type": "Answer",
  "name": "Australian Government Clean Energy Regulator+Greenhouse Gas Emissions (GHG) Scope 1+Woolworths Limited+2024",
  "company": "https://wikirate.org/Woolworths_Limited",
  "metric": "https://wikirate.org/Australian_Government_Clean_Energy_Regulator+Greenhouse_Gas_Emissions_GHG_Scope_1",
  "value": "378135",
  "unit": "t CO2-e",
  "year": "2024",
  "source": [
    "https://wikirate.org/Source_000217580"
  ],
  "license": "https://creativecommons.org/licenses/by/4.0"
}

5.5 Source Example

GET https://wikirate.org/Source_000242817.jsonld

{
  "@context": "https://wikirate.org/context/Source.jsonld",
  "@id": "https://wikirate.org/Source_000242817",
  "@type": "Source",
  "name": "Source-000242817",
  "file": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/22877518/52684561.pdf",
  "report_type": [
    "Modern Slavery Statement",
    "German Supply Chain Act report (Bericht zum LksG)",
    "Vigilance plan (Devoir de Vigilance)",
    "Norwegian Transparency Act report"
  ],
  "company": [
    "https://wikirate.org/Rip_Curl_Group_Pty_Ltd"
  ],
  "year": [
    "2025"
  ]
}

5.6 Topic Example

GET https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Strategy.jsonld

{
  "@context": "https://wikirate.org/context/Topic.jsonld",
  "@id": "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Strategy",
  "@type": "Topic",
  "name": "Sustainability Strategy",
  "description": "Sustainability Strategy evaluates integration of ESG into the company's overarching business model and value-creation roadmap: 

Materiality-driven planning: double-materiality assessments that align strategic objectives with key ESG risks and opportunities.

Capital-allocation alignment: embedding ESG criteria into cap-ex, M&A, R&D and innovation investments.

Performance governance: executive incentives, published transition plans and KPI dashboards under ISSB S1, ESRS cross-cutting rules and the Integrated Reporting Framework.",
  "inScheme": "https://wikirate.org/Wikirate_ESG_Topics",
  "parent": "https://wikirate.org/Wikirate_ESG_Topics+Governance",
  "children": [
    "https://wikirate.org/Wikirate_ESG_Topics+ESG_Integration_into_Business_Strategy",
    "https://wikirate.org/Wikirate_ESG_Topics+Materiality_Assessment",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Governance_Oversight",
    "https://wikirate.org/Wikirate_ESG_Topics+Sustainability_Goals_Targets"
  ]
}

6. Bulk collection requests (Hydra Collection)

When requesting a list of entities (e.g. all Companies) with ?format=jsonld, Wikirate returns a Hydra collection. The top-level object represents the collection itself, and each item is provided as a JSON-LD resource inside hydra:member.

6.1 Example: bulk GET request for Companies

GET https://wikirate.org/Companies.jsonld?limit=5

{
  "@id": "https://wikirate.org/Company",
  "@context": "https://www.w3.org/ns/hydra/core#",
  "@type": "hydra:Collection",
  "hydra:member": [
    {
      "@context": "https://wikirate.org/context/Company.jsonld",
      "@id": "https://wikirate.org/BP_plc",
      "@type": "Company",
      "name": "BP plc.",
      "alias": [
        "BP",
        "Bpost SA",
        "BP International Limited"
      ],
      "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/3091/12604171-medium.jpg",
      "country": "United Kingdom",
      "lei": "213800LH1BZH3DI6G760",
      "isin": [
        "DE0008618737",
        "GB0001385250",
        "GB0001385474"
      ],
      "open_corporates_id": "00102498",
      "wikidata_id": "Q152057",
      "cik": "313807",
      "same_as": [
        "https://www.bp.com/",
        "https://en.wikipedia.org/wiki/BP",
        "https://opencorporates.com/companies/gb/00102498",
        "https://search.gleif.org/#/record/213800LH1BZH3DI6G760",
        "https://www.wikidata.org/wiki/Q152057"
      ]
    },
    {
      "@context": "https://wikirate.org/context/Company.jsonld",
      "@id": "https://wikirate.org/Chevron_Corporation",
      "@type": "Company",
      "name": "Chevron Corporation",
      "alias": [
        "Chevron",
        "Chevron Corporation",
        "Chevron Corp."
      ],
      "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/3093/12604185-medium.jpg",
      "country": "United States",
      "lei": "VA8TZDWPEZYU430RZ444",
      "isin": [
        "US1667641005"
      ],
      "open_corporates_id": "149371",
      "wikidata_id": "Q319642",
      "cik": "0000093410",
      "same_as": [
        "https://www.chevron.com",
        "https://en.wikipedia.org/wiki/Chevron Corporation",
        "https://opencorporates.com/companies/us_pa/149371",
        "https://search.gleif.org/#/record/VA8TZDWPEZYU430RZ444",
        "https://www.wikidata.org/wiki/Q319642"
      ]
    },
    {
      "@context": "https://wikirate.org/context/Company.jsonld",
      "@id": "https://wikirate.org/Shell_plc",
      "@type": "Company",
      "name": "Shell plc",
      "alias": [
        "Shell",
        "Royal Dutch Shell plc. plc",
        "royal dutch shell",
        "royal dutch / shell",
        "Royal Dutch Shell plc",
        "Royal Dutch / Shell (see Shell)"
      ],
      "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/3092/12604189-medium.jpg",
      "country": "United Kingdom",
      "lei": "21380068P1DRHMJ8KU70",
      "isin": [
        "GB00B03MLX29",
        "GB00BP6MXD84"
      ],
      "open_corporates_id": "04366849",
      "same_as": [
        "http://shell.com",
        "https://en.wikipedia.org/wiki/Royal Dutch Shell",
        "https://opencorporates.com/companies/gb/04366849",
        "https://search.gleif.org/#/record/21380068P1DRHMJ8KU70"
      ]
    },
    {
      "@context": "https://wikirate.org/context/Company.jsonld",
      "@id": "https://wikirate.org/Apple_Inc",
      "@type": "Company",
      "name": "Apple Inc.",
      "alias": [
        "Apple Inc.",
        "Apple"
      ],
      "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/3188/12603895-medium.png",
      "country": "United States",
      "lei": "HWUPKR0MPOU8FGXBT394",
      "isin": [
        "CH0271171685",
        "CH0271171693",
        "US0378331005"
      ],
      "open_corporates_id": "0806592",
      "wikidata_id": "Q312",
      "cik": "0000320193",
      "same_as": [
        "https://www.apple.com/",
        "https://en.wikipedia.org/wiki/Apple Inc.",
        "https://opencorporates.com/companies/us_ca/0806592",
        "https://search.gleif.org/#/record/HWUPKR0MPOU8FGXBT394",
        "https://www.wikidata.org/wiki/Q312"
      ]
    },
    {
      "@context": "https://wikirate.org/context/Company.jsonld",
      "@id": "https://wikirate.org/Samsung",
      "@type": "Company",
      "name": "Samsung",
      "alias": [
        "samsung electronics",
        "Samsung"
      ],
      "logo": "https://wikirate-production-storage.fra1.cdn.digitaloceanspaces.com/files/3303/12604241-medium.jpeg",
      "country": "Korea, Republic of",
      "isin": [
        "KR7005930003"
      ],
      "same_as": [
        "https://www.samsung.com/",
        "https://en.wikipedia.org/wiki/Samsung Electronics"
      ]
    }
  ],
  "hydra:view": {
    "@type": "hydra:PartialCollectionView",
    "@id": "https://wikirate.org/Company",
    "hydra:next": "https://wikirate.org/Company.jsonld?filter%5Bname%5D=&item=name&limit=5&offset=5"
  }
}

7. Wikirate Ontology

Namespace

wikirate: https://wikirate.org/ontology/

8. Ontology: Classes

Class	IRI
`wikirate:Company`	https://wikirate.org/ontology/Company
`wikirate:Metric`	https://wikirate.org/ontology/Metric
`wikirate:Answer`	https://wikirate.org/ontology/Answer
`wikirate:Source`	https://wikirate.org/ontology/Source
`wikirate:Topic`	https://wikirate.org/ontology/Topic
`wikirate:RelationshipAnswer`	https://wikirate.org/ontology/RelationshipAnswer

9. Ontology: Properties

In this section, we list all properties defined in the Wikirate ontology.

Prefixes

wikirate: = https://wikirate.org/ontology/
schema: = https://schema.org/
xsd: = http://www.w3.org/2001/XMLSchema#

9.1 Object properties

Property	Domain	Range	Description
`wikirate:aboutCompany`	`wikirate:Answer`	`wikirate:Company`	Links an Answer to the company it is about.
`wikirate:aboutEntity`	`schema:CreativeWork`	-	Generic link to any entity the work concerns.
`wikirate:aboutMetric`	`wikirate:Answer`	`wikirate:Metric`	Links an Answer to the Metric it answers.
`wikirate:aboutTopic`	`wikirate:Metric`	`wikirate:Topic`	Associates a Metric with a native Wikirate Topic.
`wikirate:companyHasAnswer`	`wikirate:Company`	`wikirate:Answer`	Connects a Company to its Answers. Sub-property of `wikirate:entityHasAnswer`.
`wikirate:entityHasAnswer`	`schema:Thing`	`wikirate:Answer`	Generic relation linking any entity to an Answer.
`wikirate:frameworkMapping`	`wikirate:Metric`	`wikirate:Topic`	Maps Metrics to framework-specific Topics or indicators.
`wikirate:hasInput`	`wikirate:Metric`	`wikirate:Metric`	Indicates that another Metric is used as input in its calculation. Inverse of `wikirate:isInput`.
`wikirate:hasInverseRelation`	`wikirate:Metric`	`wikirate:Metric`	A Metric that represents an inverse relationship.
`wikirate:hasSource`	`wikirate:Answer`	`wikirate:Source`	Connects an Answer to its supporting Sources.
`wikirate:isInput`	`wikirate:Metric`	`wikirate:Metric`	Marks that this Metric is used as input to another Metric.
`wikirate:isInverseRelationOf`	`wikirate:Metric`	`wikirate:Metric`	Indicates that a Metric is the inverse of another. (Functional property.)
`wikirate:metricHasAnswer`	`wikirate:Metric`	`wikirate:Answer`	Links a Metric to Answers submitted for it.
`wikirate:objectCompany`	`wikirate:RelationshipAnswer`	`wikirate:Company`	The object Company in a relationship-type Answer.
`wikirate:sourceHasAnswer`	`wikirate:Source`	`wikirate:Answer`	Connects a Source to Answers that cite it.
`wikirate:subjectCompany`	`wikirate:RelationshipAnswer`	`wikirate:Company`	The subject Company in a relationship-type Answer.

9.2 Datatype properties

Property	Domain	Range	Description
`wikirate:answerValue`	`wikirate:Answer`	`Literal`	The value reported in an Answer. Type depends on metric (number, text, boolean, date).
`wikirate:australianBusinessNumber`	`wikirate:Company`	`xsd:string`	Australian Business Number (ABN).
`wikirate:australianCompanyNumber`	`wikirate:Company`	`xsd:string`	Australian Company Number (ACN).
`wikirate:centralIndexKey`	`wikirate:Company`	`xsd:string`	U.S. SEC Central Index Key (CIK).
`wikirate:fileUrl`	`wikirate:Source`	`xsd:anyURI`	URL to the stored version of the document.
`wikirate:formula`	`wikirate:Metric`	`xsd:string`	Mathematical formula used for calculated Metrics.
`wikirate:internationalSecuritiesIdentificationNumber`	`wikirate:Company`	`xsd:string`	ISIN identifying securities associated with the company.
`wikirate:linkUrl`	`wikirate:Source`	`xsd:anyURI`	URL of the webpage where the Source was originally found.
`wikirate:metricQuestion`	`wikirate:Metric`	`xsd:string`	The question posed by the Metric.
`wikirate:metricType`	`wikirate:Metric`	`xsd:string`	Classification of Metric type (qualitative, quantitative, etc.).
`wikirate:openCorporatesId`	`wikirate:Company`	`xsd:string`	Identifier used by OpenCorporates.
`wikirate:openSupplyHubId`	`wikirate:Company`	`xsd:string`	Identifier used by Open Supply Hub.
`wikirate:predicate`	`wikirate:RelationshipAnswer`	`xsd:string`	Relationship verb (e.g., “supplies to”, “owns”).
`wikirate:reportType`	`wikirate:Source`	`xsd:string`	Type of report (annual report, sustainability report, etc.).
`wikirate:researchPolicy`	`wikirate:Metric`	`xsd:string`	Classification of research approach for the Metric.
`wikirate:sourceYear`	`wikirate:Source`	`xsd:gYear` (or list)	Year(s) covered by the Source.
`wikirate:ukCompanyNumber`	`wikirate:Company`	`xsd:string`	UK Companies House registration number.
`wikirate:valueOption`	`wikirate:Metric`	`xsd:string`	Option available for multiple-choice-type Metrics.
`wikirate:valueType`	`wikirate:Metric`	`xsd:string`	Expected value datatype for the Metric.
`wikirate:wikidataId`	`wikirate:Company`	`xsd:string`	Wikidata Q-ID.
`wikirate:year`	`wikirate:Answer`	`xsd:gYear`	Reporting year of the Answer.

10. JSON-LD and Linked Data Guidelines

Using Wikirate data in RDF tools

You can directly expand JSON-LD responses into RDF using tools like:

from rdflib import Graph

g = Graph().parse("https://wikirate.org/Adidas_AG?format=jsonld")

Supported RDF formats

JSON-LD
Turtle (ontology only)
RDF/XML via client-side expansion

11. Best Practices for Developers

When consuming Wikirate JSON-LD:

Always resolve @context
Use @id as the canonical identifier for entities
Treat API URLs as dereferenceable IRIs
Cache responses where possible
Use Accept: application/ld+json for strict content negotiation