Structured Knowledge Graph

A graph of real word concepts, people, places, and things that you can query in natural language.

Entity Search

Searches the knowledge graph for a particular entity or concept to get a list of matching results with rich metadata.

Request

ParameterTypeValues
entity
(required)
StringThe entity value may be:
  • a string value like Mark Zuckerberg or Zuckerberg
  • a Wikipedia URL like https://en.wikipedia.org/wiki/Mark_Zuckerberg
  • a Freebase Identifier like /m/086dny
  • a Cortex Knowledge Graph ID like PWE36215
scoreStringThe score value determines which scoring function should be used when ordering results. The score value may be:
  • popularity(default) which ranks the entities by a popularity heuristic
  • exact which ranks the entities by how closely their label matches the query string
prettyBooleanPretty print the response. Useful for debugging. The pretty value may be:
  • true
  • false(default)

Response

Returns a list of entities that resulted from the search as ordered by the scoring function. Each entity is returned with rich metadata.

Example

    Request
    Response
https://api.plasticity.ai/cortex/structuredGETPOST
{
}

Property Search

This API endpoint is currently under development and will be released shortly. Please create an account to stay updated on future releases.

Category Search

This API endpoint is currently under development and will be released shortly. Please create an account to stay updated on future releases.

Entity and Property Search

Searches the knowledge graph for a property of a particular entity or concept to get a list of matching results with rich metadata.

Request

ParameterTypeValues
entity
(required)
StringThe entity value may be:
  • a string value like Mark Zuckerberg or Zuckerberg
  • a Wikipedia URL like https://en.wikipedia.org/wiki/Mark_Zuckerberg
  • a Freebase Identifier like /m/086dny
  • a Cortex Knowledge Graph ID like PWE36215
property
(required)
StringThe property value may be:
  • a string value like wife
  • a Cortex Knowledge Graph ID like PWP26
scoreStringThe score value determines which scoring function should be used when ordering results. The score value may be:
  • popularity(default) which ranks the entities by a popularity heuristic
  • exact which ranks the entities by how closely their label matches the query string
prettyBooleanPretty print the response. Useful for debugging. The pretty value may be:
  • true
  • false(default)

Response

Returns a list of relationships that resulted from the search as ordered by the scoring function. Each relationship is returned with rich metadata.

Example

    Request
    Response
https://api.plasticity.ai/cortex/structuredGETPOST
{
}

Natural Language Question Answering

Searches the knowledge graph with a natural language query to get a list of matching answers with rich metadata.

Request

ParameterTypeValues
query
(required)
StringThe query value is any natural language query. It can be a keyword search, simple natural language query, or a more complicated compound or nested query. Here are a few examples:
  • Who's Zuckerberg's wife?
  • birthday of bill gates
  • michael jordan height
  • When is Beyonce's husband's birthday?
  • Who directed Shawshank Redemption, Dead Poets Society, and Good Will Hunting?
prettyBooleanPretty print the response. Useful for debugging. The pretty value may be:
  • true
  • false(default)

Response

Returns a list of relationships that resulted from the search. Each relationship is returned with rich metadata.

Example

    Request
    Response
https://api.plasticity.ai/cortex/structuredGETPOST
{
}