v6

latestSwagger 2.0raw.githubusercontent.com2016-06-012214.9 KB

get/name/{concept-type}/{specific-concept}.json

Path parameters

concept-type'nytd_geo' | 'nytd_per' | 'nytd_org' | 'nytd_des' required

The type of the concept, used for Constructing a Semantic API Request by Concept Type and Specific Concept Name. The parameter is defined as a name-value pair, as in "concept_type=[nytd_geo|nytd_per|nytd_org|nytd_des]".

specific-conceptstring required

The name of the concept, used for Constructing a Semantic API Request by Concept Type and Specific Concept Name. The parameter is defined in the URI path, as the element immediately preceding ".json" like with "Baseball.json".

Query parameters

fields'all' | 'pages' | 'ticker_symbol' | 'links' | 'taxonomy' | 'combinations' | 'geocodes' | 'article_list' | 'scope_notes' | 'search_api_query'

"all" or comma-separated list of specific optional fields: pages, ticker_symbol, links, taxonomy, combinations, geocodes, article_list, scope_notes, search_api_query

Optional fields are returned in result_set. They are briefly explained here:

pages: A list of topic pages associated with a specific concept. ticker_symbol: If this concept is a publicly traded company, this field contains the ticker symbol. links: A list of links from this concept to external data resources. taxonomy: For descriptor concepts, this field returns a list of taxonomic relations to other concepts. combinations: For descriptor concepts, this field returns a list of the specific meanings tis concept takes on when combined with other concepts. geocodes: For geographic concepts, the full GIS record from geonames. article_list: A list of up to 10 articles associated with this concept. scope_notes: Scope notes contains clarifications and meaning definitions that explicate the relationship between the concept and an article. search_api_query: Returns the request one would need to submit to the Article Search API to obtain a list of articles annotated with this concept.

querystring required

Precedes the search term string. Used in a Search Query. Except for <specific_concept_name>, Search Query will take the required parameters listed above (<concept_type>, <concept_uri>, <article_uri>) as an optional_parameter in addition to the query=<query_term>.

Response

An array of Concepts

statusstring
copyrightstring
num_resultsinteger
All 2 operations