## Table of Contents

- [Basic rules definition](#basic-rules-definition)

---

[](https://microlink.io/docs/api/getting-started/overview)

[API](https://microlink.io/docs/api/getting-started/overview)

[](https://microlink.io/docs/guides)

GUIDES

[](https://microlink.io/docs/mql/getting-started/overview)

MQL

[](https://microlink.io/docs/sdk/getting-started/overview)

SDK

[](https://microlink.io/docs/cards/getting-started/overview)

CARDS

## Basic rules definition

For any [url](https://microlink.io/docs/api/parameters/url) provided, [Microlink API](https://microlink.io/docs/api/getting-started/overview) returns normalized data known as [meta](https://microlink.io/docs/api/parameters/meta):

``` js
const mql = require('@microlink/mql')

const { data } = await mql('https://www.meetup.com/Murcia-Frontend')

console.log(data)
```

These [data fields](https://microlink.io/docs/api/getting-started/data-fields) values are extracted from the HTML markup, using Open Graph, JSON+LD, and a series of fallbacks based on DOM selectors.

In the same way these information is extracted, you can define your **own data rules**, being possible overwrite or extend the default data extracted, creating your own API on top of any website.

A **rule** is defined by three primitives:

- A DOM query ([selector](https://microlink.io/docs/mql/data/selector) / [selectorAll](https://microlink.io/docs/mql/data/selectorAll)): It defines the HTML element(s) that will be used for getting the value (e.g., 'img').
- An attribute ([attr](https://microlink.io/docs/mql/data/attr)): It defines what field over the matched selector should be used for extracting the value (e.g., 'src').
- A data type ([type](https://microlink.io/docs/mql/data/type)): It defines how the value extracted should be considered (e.g., 'image').

Combining these primitives, you can get any value present in any website:

``` js
const mql = require('@microlink/mql')

const { data } = await mql('https://kikobeats.com', {

  data: {

    avatar: {

      selector: '#avatar',

      type: 'image',

      attr: 'src'

    }

  }

})

console.log(

  `The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`

)
```