---
id: "url"
kind: "datatype"
status: "stable"
is_pii: false
categories: ["common", "internet"]
langs: ["common"]
quality: 100
url: "http://registry.apicrafter.io/datatype/url"
---

# Uniform Resource Locator (URL) (`url`)

Address of a resource on a network that also says how to retrieve it: a scheme such as https, a host, an optional port, a path, a query and a fragment, as in https://www.example.com/docs?page=2#intro. URLs are the most common kind of URI (RFC 3986), and browsers follow the WHATWG URL Standard. The regexp covers http, https and ftp URLs whose host is a dotted domain name, an IPv4 address or an IPv6 address in brackets; other schemes are covered by uri.

- Parent datatype: `uri`
- Personal data (PII): no
- Categories: Common (common), Internet (internet)
- Countries: global
- Languages: Common to most languages (common)

## Detection

Regular expression (Python `re`):

```
^(?:https?|ftp)://(?:[^\s/?#@]+@)?(?:[^\s/?#@:.\[\]]+(?:\.[^\s/?#@:.\[\]]+)+\.?|\[[0-9A-Fa-f:.]+\])(?::[0-9]{1,5})?(?:[/?#]\S*)?$
```

## Examples

- `http://www.rdaregistry.info/xml/termList/AspectRatio.xml` — RDA aspect ratio designation
- `http://vocab.getty.edu/doc/` — Art & Architecture Thesaurus LOD Dataset
- `ftp://ftp.is.co.za/rfc/rfc1808.txt` — Example of RFC 3986, section 1.1.2
- `www.example.com` (invalid example) — No scheme
- `mailto:John.Doe@example.com` (invalid example) — A URI without a host, not a web address

## Mappings

- autotype: `url`
- cdm: `means.reference.URL`
- d3m: `http://schema.org/URL`
- fta: `URI.URL`
- google_dlp: `URL`
- presidio: `URL`
- schema_org: `url`
- wikidata: `P2699`

## Metacrafter rules

7 rules: 5 match the field name, 2 match values.

- `urlbyknownpat` (field, `common/commonurl.yaml`)
- `urlbyvalidators` (data, `common/commonurl.yaml`)
- `urlknownpat` (field, `common/internet.yaml`)
- `websiteknown` (field, `common/internet.yaml`)
- `ruurlknown` (field, `de/de_internet.yaml`)
- `url` (data, `ext/ext_internet.yaml`)
- `ru_internet_ruurlknown` (field, `ru/ru_internet.yaml`)

## Supported by tools

- `alteryxdesignercloud`
- `auctus`
- `autotype`
- `awscomprehend`
- `azureailanguage`
- `collibra`
- `csvdetective`
- `databricks`
- `dataiku`
- `dataprep`
- `dataprofiler`
- `fta`
- `googledatastudio`
- `googledlp`
- `greatexpectations`
- `ibmknowledgecatalog`
- `metabase`
- `metacrafter`
- `metacrafterpro`
- `openmetadata`
- `powerbi`
- `presidio`
- `snowflake`
- `sqldatacatalog`
- `tableau`
- `talend`
- `woodwork`

## Translations

- ru: URL (адрес ресурса): Адрес ресурса в сети со схемой доступа, например https://www.example.com/docs.

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/URL>
- wikidata: <https://www.wikidata.org/wiki/Property:P2699>
- schema.org: <https://schema.org/URL>
- doc: <https://www.rfc-editor.org/rfc/rfc3986>
- doc: <https://url.spec.whatwg.org/>

## Quality

Score 100/100.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/url.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/common/url.yaml>
