question

Upvote
Accepted
270 2 4 4

Looking for guidance on utilizing API and confidence scores

If I use api/entity/search with parentPredicateFilters=3|||[...]IsSupplierOf, I get back a list of suppliers/customers. What is the next step to, for example, narrow this list down to suppliers with >75% confidence score?

data-fusion
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

Upvote
Accepted
1.2k 6 10 8

entity/search will filter the predicates but does not provide the annotation information or further filtering.

You can use annotation/search to retrieve the info per edge, e.g., apple - nokia

GET /datafusion/api/annotation/search?searchString=*%3A*&subject=http%3A%2F%2Fpermid.org%2F1-4295905573&object=http%3A%2F%2Fpermid.org%2F1-4295866480&start=0&limit=50&dir=asc 
"subject": "<http://permid.org/1-4295905573>",
    "predicate": "<http://permid.org/sc/supplierOf>",
    "object": "<http://permid.org/1-4295866480>",
    "context": "<http://rdf.entagen.com/context/rdf-connector/graph-feed-supply-chain>",
    "score": 0.757,
    "properties": [
      {
        "name": "snippettext",
        "value": [
          "\"~~~Apple~~~ will\nintroduce a 7-inch tablet, Microsoft will bring out its Surface tablet, and\nTexas Instruments will continue to supply Amazon (even though the company is\npulling back from the smartphone market as ~~~Nokia~~~ loses market share).\""
        ],
        "type": {
          "name": "TEXT",
          "displayName": "text"
        }
      }
    ]
  }

You can also pull all annotations for a specific subject.

GET /datafusion/api/annotation/search?searchString=*%3A*&subject=http%3A%2F%2Fpermid.org%2F1-4295905573&start=0&limit=50&dir=asc

Alternatively, you can use analyze/search (does not allow you to filter by predicate) and filter out the connections by parsing the response outside DF.

GET /datafusion/api/entity/analyze/search?uri=http%3A%2F%2Fpermid.org%2F1-4295905573&searchString=nokia&level=1&rowsPerLevel=25&includeTimestamps=false
"paths": [
{
"predicates": [
{
"IN_http://rdf.entagen.com/context/rdf-connector/graph-feed-supply-chain```http://permid.org/sc/supplierOf_uri": [
{
"id": "85b1d8ff-168a-4d57-bdfc-98868e544715",
"activeRange": "1350622800000 1125899906842624",
"score": 0.757,
"properties": [
{
"name": "snippettext",
"value": [
"\"~~~Apple~~~ will\nintroduce a 7-inch tablet, Microsoft will bring out its Surface tablet, and\nTexas Instruments will continue to supply Amazon (even though the company is\npulling back from the smartphone market as ~~~Nokia~~~ loses market share).\""
]
}
]
},
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.