Guides

Place

Attributes available to place/location entities in the Knowledge Graph.

Suggest Edits

The place entity type encompasses cities, landmarks, countries, administrative areas, and other locations known to the Knowledge Graph.

Note that fields are not guaranteed to exist in every entity record.

For convenience, a complete ontology source in JSON format is also available here.

🙋

New to the Diffbot Knowledge Graph? Start here.

Place Fields

Place Field Details

Note that certain longer field examples may be truncated for readability.

allDescriptions

All descriptions found for this entity. For the best description, refer to the field 'description'.

  • Type: String
  • Example:
{
	"allDescriptions": [
		"Country primarily located in North America",
		"The United States of America (USA), commonly known as the United States (U.S. or US) or America, is a country primarily located in North America. It is a federal union of 50 states, the federal capital district of Washington, D.C., and 326 Indian reservations. The 48 contiguous states border Canada to the north and Mexico to the south. The State of Alaska lies to the northwest, while the State of Hawaii is an archipelago in the Pacific Ocean. The United States also asserts sovereignty over five major island territories and various uninhabited islands. The country has the world's third-largest land area, second-largest exclusive economic zone, and third-largest population, exceeding 334 million."
	]
}

allNames

All names used, including nicknames, full names and transliterations to other languages.

  • Type: String
  • Example:
{
	"allNames": [
		"Vereenichde Staate van Amerika",
		"Stados Ounidos de la América",
		"د امریکا متحده ایالات"
	]
}

allOriginHashes

For Diffbot's internal use only.

  • Type: String
  • Example:
{
	"allOriginHashes": [
		"XM-p70f3OhaqLnsuKWeABA",
		"oITpNcvcM2GYrb07pvWDaQ",
		"j-tkJEFSNsGfGsJlEGDLNA"
	]
}

allUriDetails

Additional information about each URI in 'allUris', which lists the URIs associated with this entity.

  • Type: UriDetails
  • Example:
{
	"allUriDetails": [
		{
			"domainMonthlyTrafficGrowth": "",
			"domainMonthlyTraffic": 0,
			"redirectsTo": "",
			"nbFollowing": 0,
			"uriType": "",
			"verified": false,
			"nbLinkedAccounts": 0,
			"nbFollowers": 0,
			"httpCodeTimestamp": 0,
			"httpCode": "",
			"uri": ""
		}
	]
}

allUris

All URIs associated with an entity. A URI (uniform resource identifier) is a page on the web that describes an entity (e.g., an company's homepage or a person's social network profile).

  • Type: URL
  • Example:
{
	"allUris": [
		"wikidata.org/entity/Q30",
		"en.wikipedia.org/?curid=3434750",
		"en.wikipedia.org/wiki/United_States"
	]
}

area

Square kilometers of AdministrativeArea

  • Type: Integer
  • Example:
{
	"area": 9826675
}

areaCodes

  • Type: String
  • Example:
{
	"areaCodes": ""
}

crawlTimestamp

The default crawlTimestamp is the most recent date of all of the crawlTimestamps of the origins used to compute the Entity, returned as a UNIX time.

  • Type: Integer
  • Example:
{
	"crawlTimestamp": 1728284400
}

description

A few sentences describing an entity

  • Type: String
  • Example:
{
	"description": "The United States of America (USA), commonly known as the United States (U.S. or US) or America, is a country primarily located in North America. It is a federal union of 50 states, the federal capital district of Washington, D.C., and 326 Indian reservations. The 48 contiguous states border Canada to the north and Mexico to the south. The State of Alaska lies to the northwest, while the State of Hawaii is an archipelago in the Pacific Ocean. The United States also asserts sovereignty over five major island territories and various uninhabited islands. The country has the world's third-largest land area, second-largest exclusive economic zone, and third-largest population, exceeding 334 million."
}

descriptors

A list of free-form keywords describing this entity

  • Type: String
  • Example:
{
	"descriptors": ""
}

diffbotUri

diffbotUri is the URI an entity's (URI), which is defined by appending the Diffbot ID to the URL https://diffbot.com/entity/. For example, Diffbot's entityID is CWSwJ_SWQPfqO3HQsxY4lGg and its DiffbotUri is https://diffbot.com/entity/CWSwJ_SWQPfqO3HQsxY4lGg

  • Type: URL
  • Example:
{
	"diffbotUri": "http://diffbot.com/entity/E01d4EK33MmCosgI2KXa4-A"
}

id

An alphanumeric string like CWSwJ_SWQPfqO3HQsxY4lGg that uniquely identifies an entity.

  • Type: String
  • Example:
{
	"id": "E01d4EK33MmCosgI2KXa4-A"
}

image

The main image used to represent the entity.

  • Type: String
  • Example:
{
	"image": "https://kg.diffbot.com/image/api/get?fetch=yes&urls=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FhvGq%3Eh%5D%7Dab%3B%60zBlElnGl6anIdpR%7BW%5EvOdKQBTx.oCJ,g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FBvqr%3EkZ%7DTb%3B%60zUb%3DXdFoKRjCX%3FE6Hl.c7%3E,g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FevDs%3El%601Nw%7BM0Bf7hu7z%3FRe9s4XwGXedrKUAN%28%40aCHnM%60%29.%7BOV"
}

images

The visual representation of an entity usually in the form of a png, jpeg, gif, or svg file.

  • Type: ImageField
  • Example:
{
	"images": [
		{
			"url": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FhvGq%3Eh%5D%7Dab%3B%60zBlElnGl6anIdpR%7BW%5EvOdKQBTx.oCJ",
			"primary": false
		},
		{
			"url": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FBvqr%3EkZ%7DTb%3B%60zUb%3DXdFoKRjCX%3FE6Hl.c7%3E",
			"primary": false
		},
		{
			"url": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FevDs%3El%601Nw%7BM0Bf7hu7z%3FRe9s4XwGXedrKUAN%28%40aCHnM%60%29.%7BOV",
			"primary": false
		}
	]
}

importance

A number between 0 and 100 indicating how important or popular an entity is.

  • Type: Float
  • Example:
{
	"importance": 99.97897338867188
}

isPartOf

  • Type: LinkedEntity
  • Example:
{
	"isPartOf": [
		{
			"summary": "",
			"image": "",
			"images": [
				{
					"classifications": "",
					"fingerprint": "",
					"title": "",
					"isCached": false,
					"url": ""
				}
			],
			"types": "",
			"diffbotUri": "",
			"name": "",
			"targetDiffbotUri": ""
		}
	]
}

location

  • Type: Location
  • Example:
{
	"location": {
		"country": {
			"summary": "Country primarily located in North America",
			"image": "https://kg.diffbot.com/image/api/get?fetch=yes&url=g%3Cj7P0St0DnBJf.x0KwLZrUn.%5B%3CR0Aa4Hh%3B%5Bv738ZqOr7U%3FhvGq%3Eh%5D%7Dab%3B%60zBlElnGl6anIdpR%7BW%5EvOdKQBTx.oCJ",
			"types": [
				"Place",
				"AdministrativeArea",
				"Country"
			],
			"name": "United States of America",
			"diffbotUri": "http://diffbot.com/entity/E01d4EK33MmCosgI2KXa4-A",
			"targetDiffbotId": "E01d4EK33MmCosgI2KXa4-A",
			"type": "Place"
		},
		"address": "United States of America",
		"latitude": 39.82817459106445,
		"precision": 3134.752685546875,
		"surfaceForm": "United States of America",
		"longitude": -98.57949829101562
	}
}

name

Primary text label for this entity.

  • Type: String
  • Example:
{
	"name": "United States of America"
}

nbIncomingEdges

This is the number of edges in the Knowledge Graph that point to this entity. For example, the nbIncomingEdges field for Google is over 100,000. This number includes the number of people that work at google, the number of investors who invested in google, etc.

  • Type: Integer
  • Example:
{
	"nbIncomingEdges": 1446351876
}

nbOrigins

Total number of origins in the field 'origins'. This field is only available in extended JSON mode.

  • Type: Integer
  • Example:
{
	"nbOrigins": 9
}

nonCanonicalFacts

Enumerates all the non-canonical fields (i.e., those not defined in the ontology) that have a value for this entity. For instance, if 'numberOfChildren' is listed in 'nonCanonicalFacts' then the entity JSON will have the key 'numberOfChildren' with an associated value. This field is only provided when the parameter nonCanonicalFacts=1 is set. See: https://docs.diffbot.com/kgapi

  • Type: String
  • Example:
{
	"nonCanonicalFacts": ""
}

originDetails

Additional information about origins listed in 'origins', including the latest time it was crawled. This field is only available in extended JSON mode.

  • Type: OriginDetail
  • Example:
{
	"originDetails": [
		{
			"crawledAt": {
				"str": "",
				"precision": 0,
				"timestamp": 0
			},
			"origin": ""
		}
	]
}

origins

An origin is a web address where Diffbot found one or more facts about an entity. This field is only available in extended JSON mode.

  • Type: String
  • Example:
{
	"origins": [
		"dbpedia.org/page/United_States",
		"en.wikipedia.org/?curid=3434750",
		"en.wikipedia.org/wiki/United_States"
	]
}

placeType

Deprecated Deprecated: Used to denote Place category for a location; ex. Park, City, etc. `types` is now the preferred field for getting this information.

  • Type: String
  • Example:
{
	"placeType": "COUNTRY"
}

population

  • Type: Integer
  • Example:
{
	"population": 332278200
}

postalCodes

  • Type: String
  • Example:
{
	"postalCodes": ""
}

summary

A short phrase designed to disambiguate entities with the same or similar name

  • Type: String
  • Example:
{
	"summary": "Country primarily located in North America"
}

type

The top-level type of a Diffbot entity. Examples of type include Person, Organization, Article, Product.

  • Type: Type
  • Example:
{
	"type": "Place"
}

types

All types of a Diffbot entity, including the value of the field 'type'.

  • Type: String
  • Example:
{
	"types": [
		"Place",
		"AdministrativeArea",
		"Country"
	]
}

wikipediaPageviews

The number of views of its Wikipedia page of the last month if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviews": 2516859
}

wikipediaPageviewsGrowth

The month over month growth of wikipediaPageviews, where we count the increment of the number of page views of the second to last (full) month, compared with that of the last (full) month. if today was Aug 16th, 2022, the last complete month is July. So it refers to the increment from June to July, i.e., ( f(July) - f(June) ) ÷ f(June) x 100%. The f(.) only counts the first 28 days of a month, to avoid fluctuations between 31-days months like Jan and 28(29)-days months like Feb.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsGrowth": -0.080562174
}

wikipediaPageviewsLastQuarter

The number of views of its Wikipedia page of the last quarter if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviewsLastQuarter": 8173121
}

wikipediaPageviewsLastQuarterGrowth

The quarter over quarter growth of wikipediaPageviews, where we count the increment of the number of page views of the second to last (full) quarter, compared with that of the last (full) quarter. If today was Aug 16th, 2022, the last complete quarter is Q2 (April, May, June). So it refers to the increment from Q1 to Q2, i.e., ( f(Q2) - f(Q1) ) ÷ f(Q1) x 100%.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsLastQuarterGrowth": -0.044443756
}

wikipediaPageviewsLastYear

The number of views of its Wikipedia page of the last year if it exists.

  • Type: Integer
  • Example:
{
	"wikipediaPageviewsLastYear": 36662385
}

wikipediaPageviewsLastYearGrowth

The year over year growth of wikipediaPageviews, where we count the monthly-rolling increment of the year before last than the last year. It today was Aug 16th, 2022, it is computed by comparing the numbers from Aug 2021 to July 2022 and from Aug 2020 to July 2021, i.e., ( f(Aug 2021 to July 2022) - f(Aug 2020 to July 2021) ) ÷ f(Aug 2020 to July 2021) x 100%.

  • Type: Float
  • Example:
{
	"wikipediaPageviewsLastYearGrowth": -0.30713123
}

Updated 3 months ago