# About

Sirdata created a semantic technology to be able to classify web content for its data provider business.\
We, now, open this amazing semantic API to our clients.

## IAB categories & Sirdata categories

Semantic API allows you to obtain a list of categories for a web content.\
Two taxonomies are available : IAB & Sirdata.\
IAB is a standard taxonomy market but Sirdata has a lot more precise categories.

```javascript
{
  "iab_categories": [
    {
      "unique_id": 680,
      "name": "Video Gaming",
      "taxonomy": "IAB",
      "tier1": "Taxonomy IAB",
      "tier2": "Video Gaming",
      "relevancy": 1.0
    }
  ],
  "custom_categories": [
    {
      "unique_id": 7363,
      "name": "PlayStation",
      "taxonomy": "SIRDATA",
      "tier1": "ARTS & ENTERTAINMENT",
      "tier2": "Video Games",
      "tier3": "Video Game Consoles",
      "tier4": "Sony",
      "relevancy": 1.0
    },
    {
      "unique_id": 6638,
      "name": "PS4 Consoles",
      "taxonomy": "SIRDATA",
      "tier1": "ARTS & ENTERTAINMENT",
      "tier2": "Video Games",
      "tier3": "Video Game Consoles",
      "tier4": "Sony",
      "relevancy": 1.0
    },
    {
      "unique_id": 7320,
      "name": "Video Games",
      "taxonomy": "SIRDATA",
      "tier1": "ARTS & ENTERTAINMENT",
      "tier2": "Video Games",
      "relevancy": 1.0
    }
  ]
}
```

{% hint style="info" %}
IAB taxonomy gives you video game information, Sirdata will give you playstation AND PS4
{% endhint %}

## Brand safety

Sometimes, it's better to avoid advertise on some contents like terrorist attack on plane crash. Sirdata Semantic API can identify this kind of content.

Example with this url : <https://www.huffpost.com/entry/malaysia-airlines-downed-plane-black-boxes_n_5619890>

```javascript
{
  "brand_safety_categories": [
    {
      "unique_id": 4823,
      "name": "Plane Crash",
      "taxonomy": "BRAND_SAFETY",
      "tier1": "WARNING! [Brand Safety]",
      "tier2": "Plane Crash",
      "relevancy": 0.606
    },
    {
      "unique_id": 4846,
      "name": "Death or Injury",
      "taxonomy": "BRAND_SAFETY",
      "tier1": "WARNING! [Brand Safety]",
      "tier2": "Death or Injury",
      "relevancy": 0.183
    }
  ]
}
```

{% hint style="danger" %}
If you are not able to detect  this content your brand image can be damaged
{% endhint %}

## Supported languages

* English
* French
* Arabic
* Czech
* Danish
* German
* Greek
* Spanish
* Finnish
* Hindi
* Italian
* Japanese
* Dutch
* Norwegian
* Polish
* Portuguese
* Romanian
* Russian
* Swedish
* Thai
* Ukrainian
* Chinese
* Indonesian
* Malay
* Turkish
* Vietnamese
* Bengali
* Korean
* Persian
* Urdu
* Hebrew