ASasknews
graph

Build a custom mega-news-knowledge graph

Changed on

Explore our mega-news-knowledge-graph at which ever level of resolution you need.

Fully disambiguated and ready to be used in any downstream application.

Pass a natural language query to get a graph of the latest news. Add parameters to build a graph from our archive, filter your graph by language, country, reporting voice, sentiment, provocative levels, and much more.

post/v1/news/graph

Request

Request body

querystring

Query string that can be any phrase, keyword, question, or paragraph. If method='nl', then this will be used as a natural language query. If method='kw', then this will be used as a direct keyword query.

return_articlesboolean

Whether to return articles or not.

min_cluster_probabilitynumber

Minimum cluster probability to use for disambiguation

geo_disambiguationboolean

Whether to use geo disambiguation or not.

filter_paramsobject nullable

All parameters available on the search_news endpoint located here: https://docs.asknews.app/en/reference#get-/v1/news/search

constrained_disambiguationsobject[] nullable

Disambiguation correction parameters.

docs_uploadobject[] nullable

Document upload parameters.

visualize_withstring nullable

Request a visualization graph returned in the response.

Response

A fully disambiguated knowledge graph, dismabiguation metadata, and the full list of news articles

full_graphobject required
disambiguationsobject[] required
querystring nullable
docs_enhancedobject[] nullable
triples_urlstring nullable
visualize_urlstring nullable

Changes

  • 6513c99e2917Revision changes
    • info

      added the optional property /////// to the response with the status

  • f1818f4f772bRevision changes
    • breaking

      the response property /// became optional for the status

    • breaking

      the response property /// became optional for the status

    • breaking

      response property articles/anyOf[subschema #1]/items/centroid_distance list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property articles/anyOf[subschema #1]/items/cluster_probability list-of-types was widened by adding types null to media type application/json of response 200