# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://semantic-api.docs.sirdata.net/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.