API Documentation

See the OSM wiki for general information about the API.

/api/4/key/chronology
/api/4/key/combinations
/api/4/key/distribution/nodes
/api/4/key/distribution/ways
/api/4/key/overview
/api/4/key/prevalent_values
/api/4/key/projects
/api/4/key/similar
/api/4/key/stats
/api/4/key/values
/api/4/key/wiki_pages
/api/4/keys/all
/api/4/keys/discardable
/api/4/keys/similar
/api/4/keys/wiki_pages
/api/4/keys/without_wiki_page
/api/4/languages
/api/4/project/icon
/api/4/project/tags
/api/4/projects/all
/api/4/projects/keys
/api/4/projects/tags
/api/4/relation/projects
/api/4/relation/roles
/api/4/relation/stats
/api/4/relation/wiki_pages
/api/4/relations/all
/api/4/search/by_key_and_value
/api/4/search/by_keyword
/api/4/search/by_role
/api/4/search/by_value
/api/4/site/config/geodistribution
/api/4/site/info
/api/4/site/sources
/api/4/tag/chronology
/api/4/tag/combinations
/api/4/tag/distribution/nodes
/api/4/tag/distribution/ways
/api/4/tag/overview
/api/4/tag/projects
/api/4/tag/stats
/api/4/tag/wiki_pages
/api/4/tags/list
/api/4/tags/popular
/api/4/unicode/characters
/api/4/wiki/inconsistent_key_status
/api/4/wiki/inconsistent_tag_status
/api/4/wiki/key_status
/api/4/wiki/languages
/api/4/wiki/problems
/api/4/wiki/tag_status
/api/4/wikidata/all
/api/4/wikidata/errors

/api/4/key/chronology

Path: /api/4/key/chronology

Description: Get chronology of key counts.

Formats: json

Parameters: key — Tag key (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`date:`	TEXT	Date in format YYYY-MM-DD.
`nodes:`	INT	Difference of number of nodes with this key relative to previous entry.
`ways:`	INT	Difference of number of ways with this key relative to previous entry.
`relations:`	INT	Difference of number of relations with this key relative to previous entry.

Example: /api/4/key/chronology?key=highway

UI Example: /keys/highway#chronology

/api/4/key/combinations

Path: /api/4/key/combinations

Description: Find keys that are used together with a given key.

Formats: json, csv

Parameters: key — Tag key (required).
query — Only show results where the other_key matches this query (substring match, optional).

Paging: optional

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: together_count, other_key, from_fraction

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`other_key:`	STRING	Other key.
`together_count:`	INT	Number of objects that have both keys.
`to_fraction:`	FLOAT	Fraction of objects with this key that also have the other key.
`from_fraction:`	FLOAT	Fraction of objects with other key that also have this key.

Example: /api/4/key/combinations?key=highway&page=1&rp=10&sortname=together_count&sortorder=desc

UI Example: /keys/highway#combinations

/api/4/key/distribution/nodes

Path:	`/api/4/key/distribution/nodes`
Description:	Get map with distribution of this key in the database (nodes only).
Formats:	png
Parameters:	`key` — Tag key (required).
Paging:	no
Filter:	none
Sort:	none
Result:	PNG image.
Example:	/api/4/key/distribution/nodes?key=amenity
UI Example:	/keys/amenity#map

/api/4/key/distribution/ways

Path:	`/api/4/key/distribution/ways`
Description:	Get map with distribution of this key in the database (ways only).
Formats:	png
Parameters:	`key` — Tag key (required).
Paging:	no
Filter:	none
Sort:	none
Result:	PNG image.
Example:	/api/4/key/distribution/ways?key=highway
UI Example:	/keys/highway#map

/api/4/key/overview

Path: /api/4/key/overview

Description: Show various data for given key.

Formats: json

Parameters: key — Tag key (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results (always 1).
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	HASH	Hash with data.
`key:`	STRING	The tag key that was requested.
`projects:`	INT	Number of projects mentioning this key.
`users:`	INT	Number of users last editing objects with this key.
`wiki_pages:`	ARRAY OF HASHES	Language codes for which wiki pages about this key are available.
`lang:`	STRING	Language code.
`english:`	STRING	English name of this language.
`native:`	STRING	Native name of this language.
`dir:`	STRING	Printing direction for native name ("ltr", "rtl", or "auto")
`has_map:`	BOOL	Is a map with the geographical distribution of this key available?
`counts:`	ARRAY OF HASHES	Objects counts.
`type:`	STRING	Object type ("all", "nodes", "ways", or "relations")
`count:`	INT	Number of objects with this type and key.
`count_fraction:`	FLOAT	Number of objects in relation to all objects.
`values:`	INT	Number of different values for this key.
`description:`	HASH OF HASHES	Description of this key (hash key is language code).
`text:`	STRING	Description text.
`dir:`	STRING	Printing direction for this language ("ltr", "rtl", or "auto").
`prevalent_values:`	ARRAY OF HASHES	Prevalent values ordered by count from most often used down.
`value:`	STRING	The tag value.
`count:`	INT	Number of objects with this tag value.
`fraction:`	FLOAT	Fraction of number of objects with this tag value compared to all objects.

Example: /api/4/key/overview?key=amenity

UI Example: /keys/amenity#overview

/api/4/key/prevalent_values

Path: /api/4/key/prevalent_values

Description: Get most prevalent values used with a given key.

Formats: json

Parameters: key — Tag key (required).
min_fraction — Only return values which are used in at least this percent of all objects with this key (optional, default = 0.01, minimum 0.001).

Paging: no

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`value:`	STRING	Value
`count:`	INT	Number of times this key/value is in the OSM database.
`fraction:`	FLOAT	Number of times in relation to number of times this key is in the OSM database.

Example: /api/4/key/prevalent_values?key=highway&filter=ways

UI Example: /keys/highway#overview

Notes: Returns an additional row with value null and count the sum of the counts for all values not listed.

/api/4/key/projects

Path: /api/4/key/projects

Description: Get projects using a given key.

Formats: json, csv

Parameters: key — Tag key (required).
query — Only show results where the project name or tag value matches this query (substring match, optional).

Paging: optional

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: project_name, tag

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`project_id:`	STRING	Project ID
`project_name:`	STRING	Project name
`project_icon_url:`	STRING	Project icon URL
`key:`	STRING	Key
`value:`	STRING	Value
`on_node:`	BOOL	For nodes?
`on_way:`	BOOL	For ways?
`on_relation:`	BOOL	For relations?
`on_area:`	BOOL	For areas?
`description:`	STRING	Description
`doc_url:`	STRING	Documentation URL
`icon_url:`	STRING	Icon URL

Example: /api/4/key/projects?key=highway&page=1&rp=10&sortname=project_name&sortorder=asc

UI Example: /keys/highway#projects

/api/4/key/similar

Path: /api/4/key/similar

Description: Find keys that are similar to a given key.

Formats: json, csv

Parameters: key — Tag key (required).
query — Only show results where the other_key matches this query (substring match, optional).

Paging: optional

Filter: none

Sort: other_key, count_all, similarity

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`other_key:`	STRING	Other key.
`count_all:`	INT	Number of objects that have the other key.
`similarity:`	INT	An integer measuring the similarity of the two keys, smaller is more similar.

Example: /api/4/key/similar?key=highway&page=1&rp=10&sortname=other_key&sortorder=asc

UI Example: /keys/highway#similar

/api/4/key/stats

Path: /api/4/key/stats

Description: Show some database statistics for given key.

Formats: json

Parameters: key — Tag key (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`type:`	STRING	Object type ("all", "nodes", "ways", or "relations")
`count:`	INT	Number of objects with this type and key.
`count_fraction:`	FLOAT	Number of objects in relation to all objects.
`values:`	INT	Number of different values for this key.

Example: /api/4/key/stats?key=amenity

UI Example: /keys/amenity#overview

/api/4/key/values

Path: /api/4/key/values

Description: Get values used with a given key.

Formats: json, csv

Parameters: key — Tag key (required).
lang — Language for description (optional, default: 'en').
query — Only show results where the value matches this query (substring match, optional).

Paging: optional

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: value, count_all, count_nodes, count_ways, count_relations, in_wiki

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`value:`	STRING	Value
`count:`	INT	Number of times this key/value is in the OSM database.
`fraction:`	FLOAT	Number of times in relation to number of times this key is in the OSM database.
`in_wiki:`	BOOL	Is there at least one wiki page for this tag?
`description:`	STRING	Description of the tag from the wiki.
`desclang:`	STRING	Language the description of the tag is in.
`descdir:`	STRING	Writing direction ("ltr", "rtl", or "auto") of description of the tag.

Example: /api/4/key/values?key=highway&page=1&rp=10&sortname=count_ways&sortorder=desc

UI Example: /keys/highway#values

/api/4/key/wiki_pages

Path: /api/4/key/wiki_pages

Description: Get list of wiki pages in different languages describing a key.

Formats: json

Parameters: key — Tag key (required)

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`lang:`	STRING	Language code.
`dir:`	STRING	Writing direction ("ltr", "rtl", or "auto") of description.
`language:`	STRING	Language name in its language.
`language_en:`	STRING	Language name in English.
`title:`	STRING	Wiki page title.
`description:`	STRING	Short description of key from wiki page.
`image:`	HASH	Associated image.
`title:`	STRING	Wiki page title of associated image.
`width:`	INT	Width of image.
`height:`	INT	Height of image.
`mime:`	STRING	MIME type of image.
`image_url:`	STRING	Image URL
`thumb_url_prefix:`	STRING	Prefix of thumbnail URL.
`thumb_url_suffix:`	STRING	Suffix of thumbnail URL.
`on_node:`	BOOL	Is this a key for nodes?
`on_way:`	BOOL	Is this a key for ways?
`on_area:`	BOOL	Is this a key for areas?
`on_relation:`	BOOL	Is this a key for relations?
`tags_implies:`	ARRAY OF STRINGS	List of keys/tags implied by this key.
`tags_combination:`	ARRAY OF STRINGS	List of keys/tags that can be combined with this key.
`tags_linked:`	ARRAY OF STRINGS	List of keys/tags related to this key.
`status:`	STRING	Status of this key/tag.

Example: /api/4/key/wiki_pages?key=highway

UI Example: /keys/highway#wiki

Notes: To get the complete thumbnail image URL, concatenate thumb_url_prefix, width of image in pixels, and thumb_url_suffix. The thumbnail image width must be smaller than width, use the image_url otherwise.

/api/4/keys/all

Path: /api/4/keys/all

Description: Get list of all keys.

Formats: json, csv

Parameters: query — Only show keys matching this query (substring match, optional).

Paging: optional

Filter: characters_colon — Category B: Only show keys like category A but with one ore more colons (:) inside.
characters_letters — Category C: Only show keys like category B but with uppercase latin letters or letters from other scripts.
characters_plain — Category A: Only show keys with latin lowercase letters (a to z) or underscore (_), first and last characters must be letters.
characters_problem — Category E: Only show keys with problematic characters.
characters_rest — Category F: Only show keys not fitting in category A through E.
characters_space — Category D: Only show keys with at least one whitespace character (space, tab, new line, carriage return, or from other scripts).
in_wiki — Only show keys that appear in the wiki.
not_in_db — Only show keys that do not appear in the database.

Sort: key, count_all, count_nodes, count_ways, count_relations, values_all, users_all, in_wiki, length

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`count_all:`	INT	Number of objects in the OSM database with this key.
`count_all_fraction:`	FLOAT	Number of objects in relation to all objects.
`count_nodes:`	INT	Number of nodes in the OSM database with this key.
`count_nodes_fraction:`	FLOAT	Number of nodes in relation to all tagged nodes.
`count_ways:`	INT	Number of ways in the OSM database with this key.
`count_ways_fraction:`	FLOAT	Number of ways in relation to all ways.
`count_relations:`	INT	Number of relations in the OSM database with this key.
`count_relations_fraction:`	FLOAT	Number of relations in relation to all relations.
`values_all:`	INT	Number of different values for this key.
`users_all:`	INT	Number of users owning objects with this key.
`in_wiki:`	BOOL	Is there at least one wiki page for this key?
`projects:`	INT	Number of projects using this key

Example: /api/4/keys/all?page=1&rp=10&filter=in_wiki&sortname=key&sortorder=asc

UI Example: /keys

/api/4/keys/discardable

Path: /api/4/keys/discardable

Description: Return discardable tags.

Formats: json, csv

Parameters: none

Paging: optional

Filter: none

Sort: key, wiki, id, josm, count_all

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`wiki:`	BOOL
`id:`	BOOL
`josm:`	BOOL
`count_all:`	INT	Number of objects with this key

Example: /api/4/keys/discardable?page=1&rp=10

UI Example: /reports/discardable_tags

/api/4/keys/similar

Path: /api/4/keys/similar

Description: Get list of pairs of similar keys, one used very often, one used rarely.

Formats: json

Parameters: query — Only show keys matching this query (substring match, optional).

Paging: optional

Filter: none

Sort: key_common, key_rare, count_all_common, count_all_rare, similarity

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key_common:`	STRING	Key thats used often in OSM database
`count_all_common:`	INT	Number of objects in the OSM database with the common key.
`key_rare:`	STRING	Key thats used rarely in OSM database
`count_all_rare:`	INT	Number of objects in the OSM database with the rare key.
`similarity:`	INT	An integer measuring the similarity of the two keys, smaller is more similar.

Example: /api/4/keys/similar?page=1&rp=10&sortname=count_all_common&sortorder=desc

UI Example: /reports/similar_keys

/api/4/keys/wiki_pages

Path: /api/4/keys/wiki_pages

Description: Get list of wiki pages in different languages for all keys.

Formats: json

Parameters: query — Only show keys matching this query (substring match, optional).

Paging: optional

Filter: none

Sort: key

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`lang:`	HASH	Hash with language codes as keys and values showing what type of wiki pages are available.

Example: /api/4/keys/wiki_pages?page=1&rp=10&sortname=key&sortorder=asc

UI Example: /reports/language_comparison_table_for_keys_in_the_wiki

/api/4/keys/without_wiki_page

Path: /api/4/keys/without_wiki_page

Description: Return frequently used tag keys that have no associated wiki page.

Formats: json

Parameters: english — Check for key wiki pages in any language (0, default) or in the English language (1).
min_count — How many tags with this key must there be at least to show up here? (default 10000).
query — Only show results where the key matches this query (substring match, optional).

Paging: optional

Filter: none

Sort: key, count_all, values_all, users_all

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`count_all:`	INT	Number of objects in database with this key.
`count_all_fraction:`	FLOAT	Fraction of objects in database with this key.
`values_all:`	INT	Number of different values for this key.
`users_all:`	INT	Number of different users who own objects with this key.
`prevalent_values:`	HASH	Often used values.
`value:`	STRING	Value
`count:`	INT	Number of occurances of this value.
`fraction:`	FLOAT	Fraction of all values.

Example: /api/4/keys/without_wiki_page?min_count=1000&english=1&page=1&rp=10&sortname=count_all&sortorder=desc

UI Example: /reports/frequently_used_keys_without_wiki_page

/api/4/languages

Path:	`/api/4/languages`
Description:	Get official subtags from the IETF BCP47 registry.
Formats:	json
Parameters:	`query` — Only show entries matching this query (case insensitive substring match on subtags and description; optional).
Paging:	optional
Filter:	`language` — Show entries of type 'language' only. `region` — Show entries of type 'region' only. `script` — Show entries of type 'script' only. `variant` — Show entries of type 'variant' only.
Sort:	`subtag`, `description`, `added`
Result:	{ "type": STRING, "subtag": STRING, "description": STRING, "added": STRING, "notes": STRING }
Example:	/api/4/languages?page=1&rp=10&sortname=subtag&sortorder=asc
UI Example:	/sources/languages/subtags

/api/4/project/icon

Path:	`/api/4/project/icon`
Description:	Get icon of a project.
Formats:	image
Parameters:	`project` — Project ID (required)
Paging:	no
Filter:	none
Sort:	none
Result:	Image in some format.
Example:	/api/4/project/icon?project=id_editor
UI Example:	/projects/id_editor

/api/4/project/tags

Path: /api/4/project/tags

Description: Get list of all keys/tags used by a project.

Formats: json, csv

Parameters: project — Project ID (required)

Paging: optional

Filter: none

Sort: tag, count_all, in_wiki

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`on_node:`	BOOL	For nodes?
`on_way:`	BOOL	For ways?
`on_relation:`	BOOL	For relations?
`on_area:`	BOOL	For areas?
`description:`	STRING	Description
`doc_url:`	STRING	Documentation URL
`icon_url:`	STRING	Icon URL
`count_all:`	INTEGER	Number of objects with this key/tag in database
`in_wiki:`	BOOL	Is there at least one wiki page for this key/tag?

Example: /api/4/project/tags?project=id_editor&page=1&rp=10&sortname=tag&sortorder=asc

UI Example: /projects/id_editor

/api/4/projects/all

Path: /api/4/projects/all

Description: Get list of all projects using OSM tags known to taginfo.

Formats: json, csv

Parameters: query — Only show projects where name or description matches this query (substring match, optional).
status — Only show projects with given status (default is "OK")

Paging: optional

Filter: none

Sort: name, unique_keys, unique_values

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`id:`	STRING	Project id
`name:`	STRING	Project name
`project_url:`	STRING	Project URL
`icon_url:`	STRING	Icon URL
`doc_url:`	STRING	Documentation URL
`description:`	STRING	Project description
`key_entries:`	INT	Key entries for this project
`tag_entries:`	INT	Tag entries for this project
`unique_keys:`	INT	Unique keys known to this project
`unique_tags:`	INT	Unique tags known to this project

Example: /api/4/projects/all?page=1&rp=10&sortname=name&sortorder=asc

UI Example: /projects

/api/4/projects/keys

Path: /api/4/projects/keys

Description: Get list of all keys used by at least one project.

Formats: json, csv

Parameters: query — Only show keys matching this query (substring match, optional).

Paging: optional

Filter: none

Sort: key, projects, in_wiki, count_all

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`projects:`	INT	Number of projects using this key
`in_wiki:`	BOOL	Is there at least one wiki page for this key?
`count_all:`	INT	Number of objects in the OSM database with this key.
`count_all_fraction:`	FLOAT	Number of objects in relation to all objects.

Example: /api/4/projects/keys?page=1&rp=10&sortname=key&sortorder=asc

UI Example: /projects#keys

/api/4/projects/tags

Path: /api/4/projects/tags

Description: Get list of all tags used by at least one project.

Formats: json, csv

Parameters: query — Only show tags matching this query (substring match, optional).

Paging: optional

Filter: none

Sort: key, value, projects, in_wiki, count_all

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`projects:`	INT	Number of projects using this tag
`in_wiki:`	BOOL	Is there at least one wiki page for this tag?
`count_all:`	INT	Number of objects in the OSM database with this tag.
`count_all_fraction:`	FLOAT	Number of objects in relation to all objects.

Example: /api/4/projects/tags?page=1&rp=10&sortname=tag&sortorder=asc

UI Example: /projects#tags

/api/4/relation/projects

Path: /api/4/relation/projects

Description: Get projects using a given relation type.

Formats: json, csv

Parameters: query — Only show results where the value matches this query (substring match, optional).
rtype — Relation type (required)

Paging: optional

Filter: none

Sort: project_name

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`project_id:`	STRING	Project ID
`project_name:`	STRING	Project name
`project_icon_url:`	STRING	Project icon URL
`rtype:`	STRING	Relation type
`description:`	STRING	Description
`doc_url:`	STRING	Documentation URL
`icon_url:`	STRING	Icon URL

Example: /api/4/relation/projects?rtype=route&page=1&rp=10&sortname=project_name&sortorder=asc

UI Example: /relations/route#projects

/api/4/relation/roles

Path: /api/4/relation/roles

Description: Member role statistics for a relation of given type.

Formats: json, csv

Parameters: min_fraction — Only return roles which are used in at least this percent of all members (optional).
query — Only show results where the role matches this query (substring match, optional).
rtype — Relation type (required).

Paging: optional

Filter: none

Sort: role, count_all_members, count_node_members, count_way_members, count_relation_members

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`rtype:`	STRING	Relation type
`role:`	STRING	Relation member role.
`count_all_members:`	INT	Number of members with this role.
`count_all_members_fraction:`	FLOAT	Number of members with this role devided by all members.
`count_node_members:`	INT	Number of members of type node with this role.
`count_node_members_fraction:`	FLOAT	Number of members of type node with this role devided by all members of type node.
`count_way_members:`	INT	Number of members of type way with this role.
`count_way_members_fraction:`	FLOAT	Number of members of type way with this role devided by all members of type way.
`count_relation_members:`	INT	Number of members of type relation with this role.
`count_relation_members_fraction:`	FLOAT	Number of members of type relation with this role devided by all members of type relation.

Example: /api/4/relation/roles?rtype=multipolygon&page=1&rp=10

UI Example: /relations/multipolygon#roles

Notes: If the query parameter is not set and the min_fraction parameter is set and paging is disabled, the first row returned will have the role null and the counts are added up from all the results not shown due to the min_fraction parameter.

/api/4/relation/stats

Path: /api/4/relation/stats

Description: Show some database statistics for given relation type.

Formats: json

Parameters: rtype — Relation type (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`type:`	STRING	Member type ("all", "nodes", "ways", or "relations")
`count:`	INT	Number of members with this type.

Example: /api/4/relation/stats?rtype=multipolygon

UI Example: /relations/multipolygon#overview

/api/4/relation/wiki_pages

Path: /api/4/relation/wiki_pages

Description: Get list of wiki pages in different languages describing a relation type.

Formats: json

Parameters: rtype — Relation type (required)

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`lang:`	STRING	Language code.
`language:`	STRING	Language name in its language.
`language_en:`	STRING	Language name in English.
`title:`	STRING	Wiki page title.
`dir:`	STRING	Writing direction ("ltr", "rtl", or "auto") of description.
`description:`	STRING	Short description of key from wiki page.
`image:`	HASH	Associated image.
`title:`	STRING	Wiki page title of associated image.
`width:`	INT	Width of image.
`height:`	INT	Height of image.
`mime:`	STRING	MIME type of image.
`image_url:`	STRING	Image URL
`thumb_url_prefix:`	STRING	Prefix of thumbnail URL.
`thumb_url_suffix:`	STRING	Suffix of thumbnail URL.

Example: /api/4/relation/wiki_pages?rtype=multipolygon

UI Example: /relations/multipolygon#wiki

/api/4/relations/all

Path: /api/4/relations/all

Description: Information about the different relation types.

Formats: json

Parameters: query — Only show results where the relation type matches this query (substring match, optional).

Paging: optional

Filter: none

Sort: rtype, count

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`rtype:`	STRING	Relation type
`count:`	INT	Number of relations with this type.
`count_fraction:`	INT	Number of relations with this type divided by the overall number of relations.
`prevalent_roles:`	ARRAY	Prevalent member roles.
`role:`	STRING	Member role
`count:`	INT	Number of members with this role.
`fraction:`	FLOAT	Number of members with this role divided by all members.

Example: /api/4/relations/all?page=1&rp=10

UI Example: /relations

Notes: prevalent_roles can be null if taginfo doesn't have role information for this relation type, or an empty array when there are no roles with more than 1% of members

/api/4/search/by_key_and_value

Path: /api/4/search/by_key_and_value

Description: Search for tags by key and/or value.

Formats: json

Parameters: query — Value to search for (substring search, required).

Paging: optional

Filter: none

Sort: count_all, key, value

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`count_all:`	INT	Number of objects in the database with this tag.

Example: /api/4/search/by_key_and_value?query=highway%3Dresidential&page=1&rp=10

UI Example: /search?q=highway%3Dresidential

/api/4/search/by_keyword

Path: /api/4/search/by_keyword

Description: Search for keys and tags by keyword in wiki pages.

Formats: json

Parameters: query — Value to search for (substring search, required).

Paging: optional

Filter: none

Sort: key, value

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value

Example: /api/4/search/by_keyword?query=fire&page=1&rp=10

UI Example: /search?q=fire#fulltext

/api/4/search/by_role

Path: /api/4/search/by_role

Description: Search for relation roles.

Formats: json

Parameters: query — Role to search for (substring search, required).

Paging: optional

Filter: none

Sort: count_all, rtype, role

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`rtype:`	STRING	Relation type.
`role:`	STRING	Role
`count_all:`	INT	Number of objects in the database with this role.

Example: /api/4/search/by_role?query=foo&page=1&rp=10

UI Example: /search?q=foo#roles

/api/4/search/by_value

Path: /api/4/search/by_value

Description: Search for tags by value.

Formats: json

Parameters: query — Value to search for (substring search, required).

Paging: optional

Filter: none

Sort: count_all, key, value

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`count_all:`	INT	Number of objects in the database with this tag.

Example: /api/4/search/by_value?query=foo&page=1&rp=10

UI Example: /search?q=foo#values

/api/4/site/config/geodistribution

Path: /api/4/site/config/geodistribution

Description: Get information about the background map for distribution charts.

Formats: json

Parameters: none

Paging: no

Filter: none

Sort: none

Result:

`width:`	INT	width of background image
`height:`	INT	height of background image
`scale_image:`	FLOAT	scale factor for images
`scale_compare_image:`	FLOAT	scale factor for comparison images
`background_image:`	STRING	URL of background image
`image_attribution:`	STRING	map attribution for comparison background

Example: /api/4/site/config/geodistribution

UI Example:

/api/4/site/info

Path: /api/4/site/info

Description: Get information about this taginfo site.

Formats: json

Parameters: none

Paging: no

Filter: none

Sort: none

Result:

`url:`	STRING	URL
`name:`	STRING	Name
`description:`	STRING	Description
`icon:`	STRING	Path to icon which appears on the lop left corner of all pages.
`contact:`	STRING	Contact information to admin.
`area:`	STRING	Description of area covered.

Example: /api/4/site/info

UI Example:

/api/4/site/sources

Path: /api/4/site/sources

Description: Get information about the data sources used.

Formats: json

Parameters: none

Paging: no

Filter: none

Sort: none

Result:

`id:`	STRING	Id
`name:`	STRING	Name
`data_until:`	STRING	All changes in the source until this date are reflected in taginfo.
`update_start:`	STRING	Date/Timestamp when last update was started.
`update_end:`	STRING	Date/Timestamp when last update was finished.

Example: /api/4/site/sources

UI Example: /sources

/api/4/tag/chronology

Path: /api/4/tag/chronology

Description: Get chronology of tag counts.

Formats: json

Parameters: key — Tag key (required).
value — Tag value (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`date:`	TEXT	Date in format YYYY-MM-DD.
`nodes:`	INT	Difference of number of nodes with this tag relative to previous entry.
`ways:`	INT	Difference of number of ways with this tag relative to previous entry.
`relations:`	INT	Difference of number of relations with this tag relative to previous entry.

Example: /api/4/tag/chronology?key=highway&value=primary

UI Example: /tags/highway=primary#chronology

/api/4/tag/combinations

Path: /api/4/tag/combinations

Description: Find keys and tags that are used together with a given tag.

Formats: json, csv

Parameters: key — Tag key (required).
query — Only show results where the other_key or other_value matches this query (substring match, optional).
value — Tag value (required).

Paging: optional

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: together_count, other_tag, from_fraction

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`other_key:`	STRING	Other key.
`other_value:`	STRING	Other value (may be empty).
`together_count:`	INT	Number of objects that have both this tag and other key (or tag).
`to_fraction:`	FLOAT	Fraction of objects with this tag that also have the other key (or tag).
`from_fraction:`	FLOAT	Fraction of objects with other key (or tag) that also have this tag.

Example: /api/4/tag/combinations?key=highway&value=residential&page=1&rp=10&sortname=together_count&sortorder=desc

UI Example: /tags/highway=residential#combinations

/api/4/tag/distribution/nodes

Path:	`/api/4/tag/distribution/nodes`
Description:	Get map with distribution of this tag in the database (nodes only). Will return empty image if there is no map available for this tag.
Formats:	png
Parameters:	`key` — Tag key (required). `value` — Tag value (required).
Paging:	no
Filter:	none
Sort:	none
Result:	PNG image.
Example:	/api/4/tag/distribution/nodes?key=amenity&value=post_box
UI Example:	/tags/amenity=post_box#map

/api/4/tag/distribution/ways

Path:	`/api/4/tag/distribution/ways`
Description:	Get map with distribution of this tag in the database (ways only). Will return empty image if there is no map available for this tag.
Formats:	png
Parameters:	`key` — Tag key (required). `value` — Tag value (required).
Paging:	no
Filter:	none
Sort:	none
Result:	PNG image.
Example:	/api/4/tag/distribution/ways?key=highway&value=residential
UI Example:	/tags/highway=residential#map

/api/4/tag/overview

Path: /api/4/tag/overview

Description: Show various data for given tag.

Formats: json

Parameters: key — Tag key (required).
value — Tag value (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results (always 1).
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	HASH	Hash with data.
`key:`	STRING	The tag key that was requested.
`value:`	STRING	The tag value that was requested.
`projects:`	INT	Number of projects mentioning this tag.
`wiki_pages:`	ARRAY OF HASHES	Language codes for which wiki pages about this tag are available.
`lang:`	STRING	Language code.
`english:`	STRING	English name of this language.
`native:`	STRING	Native name of this language.
`dir:`	STRING	Printing direction for native name ("ltr", "rtl", or "auto")
`has_map:`	BOOL	Is a map with the geographical distribution of this tag available?
`counts:`	ARRAY OF HASHES	Objects counts.
`type:`	STRING	Object type ("all", "nodes", "ways", or "relations")
`count:`	INT	Number of objects with this type and tag.
`count_fraction:`	FLOAT	Number of objects in relation to all objects.
`description:`	HASH OF HASHES	Description of this tag (hash key is language code).
`text:`	STRING	Description text.
`dir:`	STRING	Printing direction for this language ("ltr", "rtl", or "auto").

Example: /api/4/tag/overview?key=amenity&value=restaurant

UI Example: /tags/amenity=restaurant#overview

/api/4/tag/projects

Path: /api/4/tag/projects

Description: Get projects using a given tag.

Formats: json, csv

Parameters: key — Tag key (required).
query — Only show results where the project name matches this query (substring match, optional).
value — Tag value (required).

Paging: optional

Filter: all — No filter.
nodes — Only values on tags used on nodes.
relations — Only values on tags used on relations.
ways — Only values on tags used on ways.

Sort: project_name, tag

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`project_id:`	STRING	Project ID
`project_name:`	STRING	Project name
`project_icon_url:`	STRING	Project icon URL
`key:`	STRING	Key
`value:`	STRING	Value
`on_node:`	BOOL	For nodes?
`on_way:`	BOOL	For ways?
`on_relation:`	BOOL	For relations?
`on_area:`	BOOL	For areas?
`description:`	STRING	Description
`doc_url:`	STRING	Documentation URL
`icon_url:`	STRING	Icon URL

Example: /api/4/tag/projects?key=highway&value=residential&page=1&rp=10&sortname=project_name&sortorder=asc

UI Example: /tags/highway=residential#projects

/api/4/tag/stats

Path: /api/4/tag/stats

Description: Show some database statistics for given tag.

Formats: json

Parameters: key — Tag key (required).
value — Tag value (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`type:`	STRING	Object type ("all", "nodes", "ways", or "relations")
`count:`	INT	Number of objects with this type and tag.
`count_fraction:`	FLOAT	Number of objects in relation to all objects.

Example: /api/4/tag/stats?key=amenity&value=school

UI Example: /tags/amenity=school#overview

/api/4/tag/wiki_pages

Path: /api/4/tag/wiki_pages

Description: Get list of wiki pages in different languages describing a tag.

Formats: json

Parameters: key — Tag key (required)
value — Tag value (required).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`lang:`	STRING	Language code.
`dir:`	STRING	Writing direction ("ltr", "rtl", or "auto") of description.
`language:`	STRING	Language name in its language.
`language_en:`	STRING	Language name in English.
`title:`	STRING	Wiki page title.
`description:`	STRING	Short description of tag from wiki page.
`image:`	HASH	Associated image.
`title:`	STRING	Wiki page title of associated image.
`width:`	INT	Width of image.
`height:`	INT	Height of image.
`mime:`	STRING	MIME type of image.
`image_url:`	STRING	Image URL
`thumb_url_prefix:`	STRING	Prefix of thumbnail URL.
`thumb_url_suffix:`	STRING	Suffix of thumbnail URL.
`on_node:`	BOOL	Is this a tag for nodes?
`on_way:`	BOOL	Is this a tag for ways?
`on_area:`	BOOL	Is this a tag for areas?
`on_relation:`	BOOL	Is this a tag for relations?
`tags_implies:`	ARRAY OF STRINGS	List of keys/tags implied by this tag.
`tags_combination:`	ARRAY OF STRINGS	List of keys/tags that can be combined with this tag.
`tags_linked:`	ARRAY OF STRINGS	List of keys/tags related to this tag.
`status:`	STRING	Status of this key/tag.

Example: /api/4/tag/wiki_pages?key=highway&value=residential

UI Example: /tags/highway=residential#wiki

/api/4/tags/list

Path: /api/4/tags/list

Description: Get information on given tags or all tags documented on the wiki with given key.

Formats: json

Parameters: key — Key (optional)
tags — Comma-separated list of tags in format key1=value1a,value1b,...,key2=value2a,value2b,... (optional).

Paging: no

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`in_wiki:`	BOOL	In there at least one wiki page for this tag?
`count_all:`	INT	Number of objects in the OSM database with this tag.
`count_all_fraction:`	FLOAT	Number of objects in relation to all objects.
`count_nodes:`	INT	Number of nodes in the OSM database with this tag.
`count_nodes_fraction:`	FLOAT	Number of nodes in relation to all tagged nodes.
`count_ways:`	INT	Number of ways in the OSM database with this tag.
`count_ways_fraction:`	FLOAT	Number of ways in relation to all ways.
`count_relations:`	INT	Number of relations in the OSM database with this tag.
`count_relations_fraction:`	FLOAT	Number of relations in relation to all relations.
`on_node:`	BOOL	Is this a tag for nodes?
`on_way:`	BOOL	Is this a tag for ways?
`on_area:`	BOOL	Is this a tag for areas?
`on_relation:`	BOOL	Is this a tag for relations?
`wiki:`	HASH	Hash with language codes as keys and values are hashes with the following keys:
`description:`	STRING	Description of this tag.
`image:`	HASH	Optional hash with information about descriptive image:
`image:`	STRING	Wiki page title of associated image.
`width:`	INT	Width of image.
`height:`	INT	Height of image.
`mime:`	STRING	MIME type of image.
`image_url:`	STRING	Image URL
`thumb_url_prefix:`	STRING	Prefix of thumbnail URL.
`thumb_url_suffix:`	STRING	Suffix of thumbnail URL.
`osmcarto_rendering:`	HASH	Optional hash with information about default rendering:
`image:`	STRING	Wiki page title of associated image.
`width:`	INT	Width of image.
`height:`	INT	Height of image.
`mime:`	STRING	MIME type of image.
`image_url:`	STRING	Image URL
`thumb_url_prefix:`	STRING	Prefix of thumbnail URL.
`thumb_url_suffix:`	STRING	Suffix of thumbnail URL.

Example: /api/4/tags/list?tags=highway=primary,secondary,amenity=post_box

UI Example:

Notes: You have to either use the key parameter or the tags parameter.

/api/4/tags/popular

Path: /api/4/tags/popular

Description: Get list of most often used tags.

Formats: json, csv

Parameters: query — Only show tags matching this query (substring match in key and value, optional).

Paging: optional

Filter: none

Sort: tag, count_all, count_nodes, count_ways, count_relations

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key
`value:`	STRING	Value
`in_wiki:`	BOOL	In there at least one wiki page for this tag?
`count_all:`	INT	Number of objects in the OSM database with this tag.
`count_all_fraction:`	FLOAT	Number of objects in relation to all objects.
`count_nodes:`	INT	Number of nodes in the OSM database with this tag.
`count_nodes_fraction:`	FLOAT	Number of nodes in relation to all tagged nodes.
`count_ways:`	INT	Number of ways in the OSM database with this tag.
`count_ways_fraction:`	FLOAT	Number of ways in relation to all ways.
`count_relations:`	INT	Number of relations in the OSM database with this tag.
`count_relations_fraction:`	FLOAT	Number of relations in relation to all relations.
`projects:`	INT	Number of projects using this tag

Example: /api/4/tags/popular?page=1&rp=10&sortname=tag&sortorder=asc

UI Example: /tags

/api/4/unicode/characters

Path: /api/4/unicode/characters

Description: Get information about unicode characters.

Formats: json

Parameters: string — Character string (required).

Paging: optional

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`char:`	TEXT	Unicode character.
`codepoint:`	INT	Unicode code point.
`script:`	TEXT	Code (Xxxx) of script this character is in.
`script_name:`	TEXT	Name of script this character is in.
`category:`	TEXT	Unicode general category (Xx) of this character.
`name:`	TEXT	Unicode name of this character (null if unknown).

Example: /api/4/unicode/characters?string=highway

UI Example: /keys/highway#characters

/api/4/wiki/inconsistent_key_status

Path: /api/4/wiki/inconsistent_key_status

Description: List all keys documented on the wiki which have a different status in different languages.

Formats: json

Parameters: none

Paging: optional

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key.
`counts:`	HASH	Hash mapping status values to counts of wiki pages.

Example: /api/4/wiki/inconsistent_key_status

UI Example: /sources/wiki/tag_status#inconsistent_keys

/api/4/wiki/inconsistent_tag_status

Path: /api/4/wiki/inconsistent_tag_status

Description: List all tags documented on the wiki which have a different status in different languages.

Formats: json

Parameters: none

Paging: optional

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`key:`	STRING	Key.
`value:`	STRING	Value.
`counts:`	HASH	Hash mapping status values to counts of wiki pages.

Example: /api/4/wiki/inconsistent_tag_status

UI Example: /sources/wiki/tag_status#inconsistent_tags

/api/4/wiki/key_status

Path: /api/4/wiki/key_status

Description: List all keys documented on the wiki with their status.

Formats: json

Parameters: status — Only show keys with this status (optional).

Paging: optional

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`status:`	STRING	Status.
`key:`	STRING	Key.
`langs:`	ARRAY OF STRINGS	List of languages that have this status and key

Example: /api/4/wiki/key_status?status=obsolete

UI Example: /sources/wiki/tag_status#keys

/api/4/wiki/languages

Path: /api/4/wiki/languages

Description: List languages taginfo knows about and how many wiki pages describing keys and tags there are in these languages.

Formats: json

Parameters: none

Paging: no

Filter: none

Sort: code, native_name, english_name, wiki_key_pages, wiki_tag_pages

Result:

`total:`	INT	Total number of results.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`code:`	STRING	Language code.
`dir:`	STRING	Direction this language is written in ("ltr", "rtl", or "auto").
`native_name:`	STRING	Name of language in this language.
`english_name:`	STRING	Name of language in English.
`wiki_key_pages:`	INT	Number of "Key" wiki pages in this language.
`wiki_key_pages_fraction:`	FLOAT	Number of "Key" wiki pages in this language in relation to the number of keys described in any language in the wiki.
`wiki_tag_pages:`	INT	Number of "Tag" wiki pages in this language.
`wiki_tag_pages_fraction:`	FLOAT	Number of "Tag" wiki pages in this language in relation to the number of tags described in any language in the wiki.

Example: /api/4/wiki/languages?sortname=wiki_key_pages&sortorder=desc

UI Example: /reports/languages

/api/4/wiki/problems

Path: /api/4/wiki/problems

Description: Show problems encountered by taginfo while parsing wiki pages

Formats: json

Parameters: none

Paging: optional

Filter: none

Sort: title, location, reason, lang, tag

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`title:`	STRING	Wiki page title where the problem occurred
`location:`	STRING	Problem location
`reason:`	STRING	Problem reason
`lang:`	STRING	Wiki language of this page
`key:`	STRING	Key this wiki page is for (or null if neither "Key" nor "Tag" page)
`value:`	STRING	Value this wiki page is for (or null if not a "Tag" page)
`info:`	STRING	Informational string dependant on type of problem

Example: /api/4/wiki/problems

UI Example: /sources/wiki/parsing_problems#list

/api/4/wiki/tag_status

Path: /api/4/wiki/tag_status

Description: List all tags documented on the wiki with their status.

Formats: json

Parameters: status — Only show tags with this status (optional).

Paging: optional

Filter: none

Sort: none

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`status:`	STRING	Status.
`key:`	STRING	Key.
`value:`	STRING	Value.
`langs:`	ARRAY OF STRINGS	List of languages that have this status, key, and value.

Example: /api/4/wiki/tag_status?status=obsolete

UI Example: /sources/wiki/tag_status#tags

/api/4/wikidata/all

Path: /api/4/wikidata/all

Description: Get all wikidata entries about keys, tags, and relations.

Formats: json

Parameters: lang — Language for description (optional, default: 'en').
query — Only show results matching this string (substring match on key/value/rtype/item code/item description, optional).

Paging: optional

Filter: none

Sort: type, ktr, item

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`type:`	STRING	One of 'key', 'tag', or 'relation'.
`item:`	STRING	The wikidata items Q or P code.
`description:`	STRING	The description of the wikidata item.
`key:`	STRING	The OSM key related to this item (set for key and 'tag' type).
`value:`	STRING	The value of the OSM tag related to this item (set for 'tag' type).
`rtype:`	STRING	The OSM relation type related to this item (set for 'relation' type).

Example: /api/4/wikidata/all?lang=fr&page=1&rp=10&sortname=item&sortorder=asc

UI Example: /sources/wikidata/items

/api/4/wikidata/errors

Path: /api/4/wikidata/errors

Description: Get import errors for wikidata source.

Formats: json

Parameters: none

Paging: optional

Filter: none

Sort: item

Result:

`total:`	INT	Total number of results.
`page:`	INT	Result page number (first has page number 1).
`rp:`	INT	Results per page.
`url:`	STRING	URL of the request.
`data_until:`	STRING	All changes in the source until this date are reflected in this taginfo result.
`data:`	ARRAY OF HASHES	Array with results.
`item:`	STRING	The wikidata items Q or P code.
`propvalue:`	STRING	The wikidata item property value.
`desciption:`	STRING	The description of the wikidata item.
`error:`	STRING	The error message.

Example: /api/4/wikidata/errors?page=1&rp=10&sortname=item&sortorder=asc

UI Example: /sources/wikidata/errors

API Documentation

Table of Contents

/api/4/key/chronology

/api/4/key/combinations

/api/4/key/distribution/nodes

/api/4/key/distribution/ways

/api/4/key/overview

/api/4/key/prevalent_values

/api/4/key/projects

/api/4/key/similar

/api/4/key/stats

/api/4/key/values

/api/4/key/wiki_pages

/api/4/keys/all

/api/4/keys/discardable

/api/4/keys/similar

/api/4/keys/wiki_pages

/api/4/keys/without_wiki_page

/api/4/languages

/api/4/project/icon

/api/4/project/tags

/api/4/projects/all

/api/4/projects/keys

/api/4/projects/tags

/api/4/relation/projects

/api/4/relation/roles

/api/4/relation/stats

/api/4/relation/wiki_pages

/api/4/relations/all

/api/4/search/by_key_and_value

/api/4/search/by_keyword

/api/4/search/by_role

/api/4/search/by_value

/api/4/site/config/geodistribution

/api/4/site/info

/api/4/site/sources

/api/4/tag/chronology

/api/4/tag/combinations

/api/4/tag/distribution/nodes

/api/4/tag/distribution/ways

/api/4/tag/overview

/api/4/tag/projects

/api/4/tag/stats

/api/4/tag/wiki_pages

/api/4/tags/list

/api/4/tags/popular

/api/4/unicode/characters

/api/4/wiki/inconsistent_key_status

/api/4/wiki/inconsistent_tag_status

/api/4/wiki/key_status

/api/4/wiki/languages

/api/4/wiki/problems

/api/4/wiki/tag_status

/api/4/wikidata/all

/api/4/wikidata/errors