SKG-IF API for OpenCitations

Version: 1.0.0
API URL: https://api-stg.opencitations.net/skg-if/v1
Contact: contact@opencitations.net
License: ISC

Description back to top

SKG-IF compliant API exposing OpenCitations bibliographic data as JSON-LD, following the Scholarly Knowledge Graph Interoperability Framework specification.

Operations back to top

The operations that this API implements are:

/products/{local_identifier} back to operations

Returns a single research product identified by its OpenCitations Meta identifier (OMID). The response includes bibliographic metadata from OpenCitations Meta and citation data from OpenCitations Index.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape https:/{1,2}w3id\.org/oc/meta/.+

Example/products/https://w3id.org/oc/meta/br/062104388184

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/products/https://w3id.org/oc/meta/br/062104388184",
        "entity_type": "single_entity"
    },
    "@graph": [
        {
            "local_identifier": "https://w3id.org/oc/meta/br/062104388184",
            "entity_type": "product",
            "product_type": "literature",
            "titles": {
                "none": [
                    "OpenCitations Meta"
                ]
            },
            "identifiers": [
                {
                    "value": "10.1162/qss_a_00292",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Massari, Arcangelo",
                        "entity_type": "person",
                        "family_name": "Massari",
                        "given_name": "Arcangelo",
                        "identifiers": [
                            {
                                "value": "0000-0002-8420-0696",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "persons/ra/06250110138"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Mariani, Fabio",
                        "entity_type": "person",
                        "family_name": "Mariani",
                        "given_name": "Fabio",
                        "identifiers": [
                            {
                                "value": "0000-0002-7382-0187",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "persons/ra/0621012370562"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "identifiers": [
                            {
                                "value": "0000-0001-5366-5194",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "persons/ra/0621012370563"
                    },
                    "rank": 3
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "persons/ra/0621012370564"
                    },
                    "rank": 4
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Shotton, David",
                        "entity_type": "person",
                        "family_name": "Shotton",
                        "given_name": "David",
                        "identifiers": [
                            {
                                "value": "0000-0001-5506-523X",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "persons/ra/0621012370565"
                    },
                    "rank": 5
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Mit Press",
                        "entity_type": "organisation",
                        "local_identifier": "organisations/ra/0610116105"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "biblio": {
                        "volume": "5",
                        "issue": "1",
                        "pages": {
                            "first": "50",
                            "last": "75"
                        },
                        "in": {
                            "name": "Quantitative Science Studies",
                            "entity_type": "venue",
                            "local_identifier": "venues/br/062501778099",
                            "identifiers": [
                                {
                                    "value": "S4210195326",
                                    "scheme": "openalex"
                                },
                                {
                                    "value": "2641-3337",
                                    "scheme": "issn"
                                }
                            ]
                        }
                    },
                    "dates": {
                        "publication": [
                            "2024-01-01T00:00:00"
                        ]
                    }
                }
            ],
            "related_products": {
                "cites": [
                    "https://w3id.org/oc/meta/br/06103007140",
                    "https://w3id.org/oc/meta/br/0610867930",
                    "https://w3id.org/oc/meta/br/061102015064",
                    "https://w3id.org/oc/meta/br/061102015169",
                    "https://w3id.org/oc/meta/br/061201341000",
                    "https://w3id.org/oc/meta/br/061302130471",
                    "https://w3id.org/oc/meta/br/061501741757",
                    "https://w3id.org/oc/meta/br/061503029782",
                    "https://w3id.org/oc/meta/br/061503595784",
                    "https://w3id.org/oc/meta/br/06150878997",
                    "https://w3id.org/oc/meta/br/061703213020",
                    "https://w3id.org/oc/meta/br/061703367432",
                    "https://w3id.org/oc/meta/br/061801986475",
                    "https://w3id.org/oc/meta/br/061802636786",
                    "https://w3id.org/oc/meta/br/062103573093",
                    "https://w3id.org/oc/meta/br/062202390183",
                    "https://w3id.org/oc/meta/br/062203843935",
                    "https://w3id.org/oc/meta/br/062303563887",
                    "https://w3id.org/oc/meta/br/062501777134",
                    "https://w3id.org/oc/meta/br/062501777138",
                    "https://w3id.org/oc/meta/br/062502075555",
                    "https://w3id.org/oc/meta/br/062502379711",
                    "https://w3id.org/oc/meta/br/06250648347",
                    "https://w3id.org/oc/meta/br/062602030618",
                    "https://w3id.org/oc/meta/br/062604422894",
                    "https://w3id.org/oc/meta/br/062604422895",
                    "https://w3id.org/oc/meta/br/062604422896",
                    "https://w3id.org/oc/meta/br/062604422897",
                    "https://w3id.org/oc/meta/br/062604422898",
                    "https://w3id.org/oc/meta/br/062604422899",
                    "https://w3id.org/oc/meta/br/06301298733",
                    "https://w3id.org/oc/meta/br/06302611193",
                    "https://w3id.org/oc/meta/br/0630685531",
                    "https://w3id.org/oc/meta/br/06320129129",
                    "https://w3id.org/oc/meta/br/06401296979",
                    "https://w3id.org/oc/meta/br/06401334370",
                    "https://w3id.org/oc/meta/br/06401935463",
                    "https://w3id.org/oc/meta/br/06402610446",
                    "https://w3id.org/oc/meta/br/0641097549",
                    "https://w3id.org/oc/meta/br/0650312105",
                    "https://w3id.org/oc/meta/br/06603394186",
                    "https://w3id.org/oc/meta/br/06702573854",
                    "https://w3id.org/oc/meta/br/06804723331",
                    "https://w3id.org/oc/meta/br/06902362263",
                    "https://w3id.org/oc/meta/br/06903616292"
                ]
            }
        }
    ]
}

/products back to operations

Returns a list of research products matching the given filters.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. Filters marked as currently empty are accepted but return no matches in OpenCitations at the moment.

    Attribute filters:

    • product_type
    • identifiers.id
    • identifiers.scheme
    • contributions.by.local_identifier
    • contributions.by.identifiers.id
    • contributions.by.identifiers.scheme
    • contributions.by.family_name
    • contributions.by.given_name
    • contributions.by.name
    • contributions.declared_affiliations.local_identifier (currently empty)
    • contributions.declared_affiliations.identifiers.id (currently empty)
    • contributions.declared_affiliations.identifiers.scheme (currently empty)
    • contributions.declared_affiliations.name (currently empty)
    • contributions.declared_affiliations.short_name (currently empty)
    • funding.local_identifier (currently empty)
    • funding.grant_number (currently empty)
    • funding.identifiers.id (currently empty)
    • funding.identifiers.scheme (currently empty)

    Convenience filters (cf.*):

    • cf.search.title
    • cf.search.title_abstract (currently empty)
    • cf.contributions_orcid
    • cf.contributions_aff_ror (currently empty)
    • cf.contributions_aff_country (currently empty)
    • cf.cites
    • cf.cited_by
    • cf.cites_doi
    • cf.cited_by_doi

Example/products?filter=cf.search.title:OpenCitations

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/products?filter=cf.search.title:OpenCitations&page=1&page_size=10",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/products?filter=cf.search.title:OpenCitations",
            "entity_type": "search_result",
            "total_items": 7,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/products?filter=cf.search.title:OpenCitations&page=1&page_size=10",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/products?filter=cf.search.title:OpenCitations&page=1&page_size=10",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": [
        {
            "local_identifier": "https://w3id.org/oc/meta/br/06401296979",
            "product_type": "literature",
            "titles": {
                "none": [
                    "A Programming Interface For Creating Data According To The SPAR Ontologies And The OpenCitations Data Model"
                ]
            },
            "identifiers": [
                {
                    "value": "W4285173206",
                    "scheme": "openalex"
                },
                {
                    "value": "10.1007/978-3-031-06981-9_18",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Persiani, Simone",
                        "entity_type": "person",
                        "family_name": "Persiani",
                        "given_name": "Simone",
                        "local_identifier": "https://w3id.org/oc/meta/ra/06403863047"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Daquino, Marilena",
                        "entity_type": "person",
                        "family_name": "Daquino",
                        "given_name": "Marilena",
                        "identifiers": [
                            {
                                "value": "0000-0002-1113-7550",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0625011225133"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0614010840729"
                    },
                    "rank": 3
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Springer Science And Business Media Llc",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116006"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/BookChapter",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "book chapter"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2022-01-01T00:00:00"
                        ]
                    },
                    "biblio": {
                        "pages": {
                            "first": "305",
                            "last": "322"
                        },
                        "in": {
                            "name": "The Semantic Web",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/06401297735",
                            "identifiers": [
                                {
                                    "value": "9783031069802",
                                    "scheme": "isbn"
                                },
                                {
                                    "value": "9783031069819",
                                    "scheme": "isbn"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/062104388184",
            "product_type": "literature",
            "titles": {
                "none": [
                    "OpenCitations Meta"
                ]
            },
            "identifiers": [
                {
                    "value": "10.1162/qss_a_00292",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Massari, Arcangelo",
                        "entity_type": "person",
                        "family_name": "Massari",
                        "given_name": "Arcangelo",
                        "identifiers": [
                            {
                                "value": "0000-0002-8420-0696",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/06250110138"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Mariani, Fabio",
                        "entity_type": "person",
                        "family_name": "Mariani",
                        "given_name": "Fabio",
                        "identifiers": [
                            {
                                "value": "0000-0002-7382-0187",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621012370562"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "identifiers": [
                            {
                                "value": "0000-0001-5366-5194",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621012370563"
                    },
                    "rank": 3
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621012370564"
                    },
                    "rank": 4
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Shotton, David",
                        "entity_type": "person",
                        "family_name": "Shotton",
                        "given_name": "David",
                        "identifiers": [
                            {
                                "value": "0000-0001-5506-523X",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621012370565"
                    },
                    "rank": 5
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Mit Press",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116105"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2024-01-01T00:00:00"
                        ]
                    },
                    "biblio": {
                        "volume": "5",
                        "issue": "1",
                        "pages": {
                            "first": "50",
                            "last": "75"
                        },
                        "in": {
                            "name": "Quantitative Science Studies",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/062501778099",
                            "identifiers": [
                                {
                                    "value": "2641-3337",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "S4210195326",
                                    "scheme": "openalex"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/062501777134",
            "product_type": "literature",
            "titles": {
                "none": [
                    "OpenCitations, An Infrastructure Organization For Open Scholarship"
                ]
            },
            "identifiers": [
                {
                    "value": "W3106215946",
                    "scheme": "openalex"
                },
                {
                    "value": "10.1162/qss_a_00023",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0614010840729"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Shotton, D M",
                        "entity_type": "person",
                        "family_name": "Shotton",
                        "given_name": "D M",
                        "identifiers": [
                            {
                                "value": "0000-0001-5506-523X",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621010775619"
                    },
                    "rank": 2
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Mit Press",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116105"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2020-02-01T00:00:00"
                        ]
                    },
                    "biblio": {
                        "volume": "1",
                        "issue": "1",
                        "pages": {
                            "first": "428",
                            "last": "444"
                        },
                        "in": {
                            "name": "Quantitative Science Studies",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/062501778099",
                            "identifiers": [
                                {
                                    "value": "S4210195326",
                                    "scheme": "openalex"
                                },
                                {
                                    "value": "2641-3337",
                                    "scheme": "issn"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/061302130471",
            "product_type": "literature",
            "titles": {
                "none": [
                    "Software Review: COCI, The OpenCitations Index Of Crossref Open DOI-to-DOI Citations"
                ]
            },
            "identifiers": [
                {
                    "value": "W2938946739",
                    "scheme": "openalex"
                },
                {
                    "value": "10.1007/s11192-019-03217-6",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "identifiers": [
                            {
                                "value": "0000-0001-5366-5194",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/063011864088"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0614010840729"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Shotton, D M",
                        "entity_type": "person",
                        "family_name": "Shotton",
                        "given_name": "D M",
                        "identifiers": [
                            {
                                "value": "0000-0001-5506-523X",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0621010775619"
                    },
                    "rank": 3
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Springer Science And Business Media Llc",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116006"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2019-09-14T00:00:00"
                        ]
                    },
                    "biblio": {
                        "volume": "121",
                        "issue": "2",
                        "pages": {
                            "first": "1213",
                            "last": "1228"
                        },
                        "in": {
                            "name": "Scientometrics",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/0626055628",
                            "identifiers": [
                                {
                                    "value": "S148561398",
                                    "scheme": "openalex"
                                },
                                {
                                    "value": "1588-2861",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "0138-9130",
                                    "scheme": "issn"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/06404693975",
            "product_type": "literature",
            "titles": {
                "none": [
                    "The Integration Of The Japan Link Center’s Bibliographic Data Into OpenCitations"
                ]
            },
            "identifiers": [
                {
                    "value": "10.5334/johd.178",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Moretti, Arianna",
                        "entity_type": "person",
                        "family_name": "Moretti",
                        "given_name": "Arianna",
                        "identifiers": [
                            {
                                "value": "0000-0001-5486-7070",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/061206532421"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Soricetti, Marta",
                        "entity_type": "person",
                        "family_name": "Soricetti",
                        "given_name": "Marta",
                        "identifiers": [
                            {
                                "value": "0009-0008-1466-7742",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/064013186641"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "identifiers": [
                            {
                                "value": "0000-0001-5366-5194",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/063011864088"
                    },
                    "rank": 3
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Massari, Arcangelo",
                        "entity_type": "person",
                        "family_name": "Massari",
                        "given_name": "Arcangelo",
                        "identifiers": [
                            {
                                "value": "0000-0002-8420-0696",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/06250110138"
                    },
                    "rank": 4
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/0614010840729"
                    },
                    "rank": 5
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Rizzetto, Elia",
                        "entity_type": "person",
                        "family_name": "Rizzetto",
                        "given_name": "Elia",
                        "identifiers": [
                            {
                                "value": "0009-0003-7161-9310",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/064013186645"
                    },
                    "rank": 6
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Ubiquity Press, Ltd.",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116010"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2024-01-01T00:00:00"
                        ]
                    },
                    "biblio": {
                        "volume": "10",
                        "in": {
                            "name": "Journal Of Open Humanities Data",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/06160186133",
                            "identifiers": [
                                {
                                    "value": "2059-481X",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "S4210240912",
                                    "scheme": "openalex"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/06290518281",
            "product_type": "literature",
            "titles": {
                "none": [
                    "The OpenCitations Index: Description Of A Database Providing Open Citation Data"
                ]
            },
            "identifiers": [
                {
                    "value": "10.1007/s11192-024-05160-7",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "identifiers": [
                            {
                                "value": "0000-0001-5366-5194",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/063011864088"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Moretti, Arianna",
                        "entity_type": "person",
                        "family_name": "Moretti",
                        "given_name": "Arianna",
                        "identifiers": [
                            {
                                "value": "0000-0001-5486-7070",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/062901363345"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "identifiers": [
                            {
                                "value": "0000-0003-0530-4305",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/062901363346"
                    },
                    "rank": 3
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Soricetti, Marta",
                        "entity_type": "person",
                        "family_name": "Soricetti",
                        "given_name": "Marta",
                        "identifiers": [
                            {
                                "value": "0009-0008-1466-7742",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/062901363347"
                    },
                    "rank": 4
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Springer Science And Business Media Llc",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116006"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2024-09-28T00:00:00"
                        ]
                    },
                    "biblio": {
                        "in": {
                            "name": "Scientometrics",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/0626055628",
                            "identifiers": [
                                {
                                    "value": "1588-2861",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "0138-9130",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "S148561398",
                                    "scheme": "openalex"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        },
        {
            "local_identifier": "https://w3id.org/oc/meta/br/06011163661",
            "product_type": "literature",
            "titles": {
                "none": [
                    "Validating And Monitoring Bibliographic And Citation Data In OpenCitations Collections"
                ]
            },
            "identifiers": [
                {
                    "value": "10.1007/s00799-025-00425-9",
                    "scheme": "doi"
                }
            ],
            "contributions": [
                {
                    "role": "author",
                    "by": {
                        "name": "Heibi, Ivan",
                        "entity_type": "person",
                        "family_name": "Heibi",
                        "given_name": "Ivan",
                        "local_identifier": "https://w3id.org/oc/meta/ra/06028914346"
                    },
                    "rank": 1
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Peroni, Silvio",
                        "entity_type": "person",
                        "family_name": "Peroni",
                        "given_name": "Silvio",
                        "local_identifier": "https://w3id.org/oc/meta/ra/06028914347"
                    },
                    "rank": 2
                },
                {
                    "role": "author",
                    "by": {
                        "name": "Rizzetto, Elia",
                        "entity_type": "person",
                        "family_name": "Rizzetto",
                        "given_name": "Elia",
                        "identifiers": [
                            {
                                "value": "0009-0003-7161-9310",
                                "scheme": "orcid"
                            }
                        ],
                        "local_identifier": "https://w3id.org/oc/meta/ra/064013186645"
                    },
                    "rank": 3
                },
                {
                    "role": "publisher",
                    "by": {
                        "name": "Springer Science And Business Media Llc",
                        "entity_type": "organisation",
                        "local_identifier": "https://w3id.org/oc/meta/ra/0610116006"
                    },
                    "rank": 1
                }
            ],
            "manifestations": [
                {
                    "type": {
                        "class": "http://purl.org/spar/fabio/JournalArticle",
                        "defined_in": "http://purl.org/spar/fabio",
                        "labels": {
                            "en": "journal article"
                        }
                    },
                    "dates": {
                        "publication": [
                            "2025-07-27T00:00:00"
                        ]
                    },
                    "biblio": {
                        "volume": "26",
                        "issue": "3",
                        "in": {
                            "name": "International Journal On Digital Libraries",
                            "entity_type": "venue",
                            "local_identifier": "https://w3id.org/oc/meta/br/06160781188",
                            "identifiers": [
                                {
                                    "value": "S110615584",
                                    "scheme": "openalex"
                                },
                                {
                                    "value": "1432-5012",
                                    "scheme": "issn"
                                },
                                {
                                    "value": "1432-1300",
                                    "scheme": "issn"
                                }
                            ]
                        }
                    }
                }
            ],
            "entity_type": "product"
        }
    ]
}

/persons/{local_identifier} back to operations

Coming soon. Returns a single person when implemented; this placeholder currently returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/persons/https://w3id.org/oc/meta/ra/0621012370564

Exemplar output (in JSON)

HTTP status code 404: entity not found

/persons back to operations

Coming soon. Returns a list of persons matching the given filters when implemented; this placeholder currently returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. Attribute filters:

    • identifiers.id
    • identifiers.scheme
    • given_name
    • family_name
    • name
    • affiliations.affiliation.local_identifier
    • affiliations.affiliation.name
    • affiliations.affiliation.short_name
    • affiliations.role

    Convenience filters (cf.*):

    • cf.search.family_name
    • cf.search.given_name
    • cf.search.name

Example/persons?filter=cf.search.given_name:Silvio,cf.search.family_name:Peroni

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/persons?filter=cf.search.given_name:Silvio,cf.search.family_name:Peroni&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/persons?filter=cf.search.given_name:Silvio,cf.search.family_name:Peroni",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/persons?filter=cf.search.given_name:Silvio,cf.search.family_name:Peroni&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/persons?filter=cf.search.given_name:Silvio,cf.search.family_name:Peroni&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}

/organisations/{local_identifier} back to operations

Coming soon. Returns a single organisation when implemented; this placeholder currently returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/organisations/https://w3id.org/oc/meta/ra/0610116105

Exemplar output (in JSON)

HTTP status code 404: entity not found

/organisations back to operations

Coming soon. Returns a list of organisations matching the given filters when implemented; this placeholder currently returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. Attribute filters:

    • identifiers.id
    • identifiers.scheme
    • name
    • short_name
    • website
    • country

    Convenience filters (cf.*):

    • cf.search.name

Example/organisations?filter=cf.search.name:Mit Press

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/organisations?filter=cf.search.name:Mit Press&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/organisations?filter=cf.search.name:Mit Press",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/organisations?filter=cf.search.name:Mit Press&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/organisations?filter=cf.search.name:Mit Press&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}

/venues/{local_identifier} back to operations

Coming soon. Returns a single venue when implemented; this placeholder currently returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/venues/https://w3id.org/oc/meta/br/062501778099

Exemplar output (in JSON)

HTTP status code 404: entity not found

/venues back to operations

Coming soon. Returns a list of venues matching the given filters when implemented; this placeholder currently returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. Attribute filters:

    • acronym
    • type
    • identifiers.scheme
    • identifiers.value
    • name

    Convenience filters (cf.*):

    • cf.search.name

Example/venues?filter=cf.search.name:Quantitative Science Studies

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/venues?filter=cf.search.name:Quantitative Science Studies&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/venues?filter=cf.search.name:Quantitative Science Studies",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/venues?filter=cf.search.name:Quantitative Science Studies&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/venues?filter=cf.search.name:Quantitative Science Studies&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}

/grants/{local_identifier} back to operations

Returns a single grant. Note: OpenCitations does not currently hold grant data; this endpoint always returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/grants/example-grant-id

Exemplar output (in JSON)

HTTP status code 404: entity not found

/grants back to operations

Returns a list of grants matching the given filters. Note: OpenCitations does not currently hold grant data; this endpoint always returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. All filters below are accepted but currently return no matches because OpenCitations does not hold grant data.

    Attribute filters:

    • identifiers.scheme
    • identifiers.value
    • acronym
    • currency
    • website
    • beneficiaries.identifiers.scheme
    • beneficiaries.identifiers.value
    • beneficiaries.name
    • beneficiaries.short_name
    • beneficiaries.website
    • beneficiaries.country
    • contributions.by.local_identifier
    • contributions.by.identifiers.scheme
    • contributions.by.identifiers.value
    • contributions.by.given_name
    • contributions.by.family_name
    • contributions.by.name
    • contributions.declared_affiliations.local_identifier
    • contributions.declared_affiliations.identifiers.scheme
    • contributions.declared_affiliations.identifiers.value
    • contributions.declared_affiliations.name
    • contributions.declared_affiliations.short_name
    • contributions.declared_affiliations.website
    • contributions.declared_affiliations.country
    • contributions.role
    • grant_number
    • funding_agency.identifiers.scheme
    • funding_agency.identifiers.value
    • funding_agency.name
    • funding_agency.short_name
    • funding_agency.website
    • funding_agency.country
    • funding_stream

    Convenience filters (cf.*):

    • cf.search.title
    • cf.search.title_abstract
    • cf.funded_amount.from
    • cf.funded_amount.to
    • cf.duration.start.from
    • cf.duration.start.to
    • cf.duration.end.from

Example/grants?filter=grant_number:12345

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/grants?filter=grant_number:12345&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/grants?filter=grant_number:12345",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/grants?filter=grant_number:12345&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/grants?filter=grant_number:12345&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}

/datasources/{local_identifier} back to operations

Returns a single data source. Note: OpenCitations does not currently hold data source records; this endpoint always returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/datasources/example-datasource-id

Exemplar output (in JSON)

HTTP status code 404: entity not found

/datasources back to operations

Returns a list of data sources matching the given filters. Note: OpenCitations does not currently hold data source records; this endpoint always returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. All filters below are accepted but currently return no matches because OpenCitations does not hold data source records.

    Attribute filters:

    • data_source_classification
    • research_product_type
    • identifiers.scheme
    • identifiers.value
    • acronym

    Convenience filters (cf.*):

    • cf.search.name

Example/datasources?filter=research_product_type:literature

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/datasources?filter=research_product_type:literature&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/datasources?filter=research_product_type:literature",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/datasources?filter=research_product_type:literature&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/datasources?filter=research_product_type:literature&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}

/topics/{local_identifier} back to operations

Returns a single topic. Note: OpenCitations does not currently hold topic data; this endpoint always returns 404.

Accepted HTTP method(s) get

Parameter(s)
  • local_identifier: type str, regular expression shape .+

Example/topics/example-topic-id

Exemplar output (in JSON)

HTTP status code 404: entity not found

/topics back to operations

Returns a list of topics matching the given filters. Note: OpenCitations does not currently hold topic data; this endpoint always returns an empty result.

Accepted HTTP method(s) get

Parameter(s)
  • filter (query, optional):

    Search filter. Format: comma-separated filter_name:filter_value pairs (AND logic). Filters in the first group use exact matching. For cf.search.*, matching is text contains. All filters below are accepted but currently return no matches because OpenCitations does not hold topic data.

    Attribute filters:

    • identifiers.scheme
    • identifiers.value

    Convenience filters (cf.*):

    • cf.search.labels
    • cf.search.language

Example/topics?filter=cf.search.labels:biology

Exemplar output (in JSON)

{
    "@context": [
        "https://w3id.org/skg-if/context/1.1.0/skg-if.json",
        "https://w3id.org/skg-if/context/1.0.0/skg-if-api.json",
        {
            "@base": "https://w3id.org/skg-if/sandbox/oc/"
        }
    ],
    "meta": {
        "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/topics?filter=cf.search.labels:biology&page=1&page_size=1",
        "entity_type": "search_result_page",
        "part_of": {
            "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/topics?filter=cf.search.labels:biology",
            "entity_type": "search_result",
            "total_items": 0,
            "first_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/topics?filter=cf.search.labels:biology&page=1&page_size=1",
                "entity_type": "search_result_page"
            },
            "last_page": {
                "local_identifier": "https://api-stg.opencitations.net/skg-if/v1/topics?filter=cf.search.labels:biology&page=1&page_size=1",
                "entity_type": "search_result_page"
            }
        }
    },
    "@graph": []
}