newsdev/nyt-entity-service

Name: nyt-entity-service

Owner: NYT Newsroom Developers

Description: A web service for disambiguating and canonically storing entities.

Created: 2017-05-22 21:01:49.0

Updated: 2018-04-13 12:19:11.0

Pushed: 2017-07-05 16:03:39.0

Homepage:

Size: 29

Language: Python

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

NYT Entity Service

A web service for disambiguating entities.

Your application can POST some JSON to the service with a name to match and some optional flags describing how to process your request. The service will return a UUID that will uniquely identify this entity across a variety of applications.

Alternately, if you're writing Python, you can use our entity uploader.

Coming soon: An admin interface for combining / deduplicating entities and for searching / exploring entities.

Usage

Example: Entity Uploader

See the entity uploader docs for more.

Example: Raw JSON

Required fields

• name, string: The entity's name, e.g., Bank of America or Jared Kushner.

Optional fields

• create_if_below, integer, 0-100: If the fuzzy match score is below this threshold, a new entity will be created. Default: 80

POST data

ame": "Bank of America N.A.",
reate_if_below": 80,

Response data

equest": {
"name": "Bank of America, N.A.",
"create_if_below": 80,

esponse": {
"name": "Bank of America",
"score": 95,
"uuid": "ccb4e4c1-b3de-4688-b036-97550c717103",
"created": false