Introduction

Neticle's Data API is a standard REST API for retrieving all the data that is available in our system.

It makes possible the integration of our analyzed textual and aggregated data to any third-party systems directly or via connectors.

The most frequent (but not only) use cases:

Channeling Neticle's enhanced textual data (mentions) within your own BI system
Getting aggregations / KPIs for your own dashboards
Retrieving identified insights about keywords

Use cases to be covered in upcoming releases:

Retrieving chart data as JSON for chart visualization purposes- under development

Authorization

For the rest of this documentation, the lock icon () will indicate endpoints which are protected, and where you must provide an Authorization header in order to be able to successfully receive a response from them.

Endpoints with icon can be used without any Authorization header.

Api-key based authentication

Include your API key in a Basic Authorization header, like so: Authorization: Basic <api-key>

JWT based authentication

Include your token in a Bearer Authorization header, like so: Authorization: Bearer <jwt-token>

Rate limiting

All of our endpoints are limited for querying in a given timeframe. We differentiate our rate limiting policy based on the authorization of the endpoints:

ApiKey protected endpoints
No more than 5000 requests can be processed in each 1 hour timeframe with the same ApiKey. (This means no more than 83 requests / min or 1,3 requests / sec in average for 1 hour.)
Endpoints without ApiKey authorization
No more than 60 requests can be processed in each 1 minute timeframe from the same IP address.

In each API response's response header we embed the current quota usage information:

RateLimit-Limit: <number> --max allowed queries in the timeframe
RateLimit-Remaining: <number> --how many queries can be made for the same endpoint and for all other endpoints with the same authorization method
RateLimit-Reset: <number> --seconds left until the end of the current timeframe so when the quota usage resets
RateLimit-ResetAt: <number> --timestamp when the timeframe ends

In particular we suggest not to perform more than 1 query in each sec to our API so no rate limitation error will be responded.

Versioning

Versions	Status	Released	End-of-life
24.04	Latest	2024.04.03.
22.09	Flagged for depreciation	2022.09.15.	~ 2025.12.31
v2.7	Flagged for depreciation		2023.03.15.
v2.6	Flagged for depreciation		2023.03.15
v2.5	Flagged for depreciation		2023.03.15.
v2.4	Flagged for depreciation		2023.03.15.
v2.3	Flagged for depreciation		2023.03.15.

Depreciation policy

When a new API version is released, the older ones are starting their 6 month depreciation period.

We plan new versions twice a year, approximately 6 month apart. The different versions may not be backwards compatible but not necessarily.

Versioning scheme

From 22.09 we no longer use the SemVer but the CalVer versioning scheme.

The minor changes will not increase the API version and should be backwards compatible so no URL modification needed from the client side.

Because of this approach the response structure JSONs are never missing a previously existing key, but the JSONs can be extended with new keys within the same version.

Also new endpoints may be added without increasing the version.

Clients

Provides an interface to interact with the client objects stored in our databases.

Listing clients

 GET /clients


      curl -G https://data.skema.co.id/24.04/clients \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' 
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/clients',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/clients")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/clients"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/clients', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Client[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "en_demo",
      "label": "Demo client",
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Client[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "en_demo",
      "label": "Demo client",
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Client[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "en_demo",
      "label": "Demo client",
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

Finding a single client

 GET /clients/:clientId


      curl -G https://data.skema.co.id/24.04/clients/:clientId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' 
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/clients/:clientId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/clients/:clientId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/clients/:clientId"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/clients/:clientId', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Client	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "en_demo",
    "label": "Demo client",
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Client	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "en_demo",
    "label": "Demo client",
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Client	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "en_demo",
    "label": "Demo client",
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

Aspects

Provides an interface to interact with the aspect objects stored in our databases.

Listing aspects

 GET /aspects

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

If multiple constraints are given, only the most specific one is taken into consideration.

Constraints (struct)
Property	Type	Comment
clientId omittable	number	Filter by a client.
profileId omittable	number	Filter by a profile.
keywordGroupId omittable	number	Filter by a keyword group.
aspectGroupId omittable	number	Filter by an aspect group.
keywordId omittable	number	Filter by a keyword.

Example:

{
  "clientId": 0,
  "profileId": 0,
  "keywordGroupId": 0,
  "aspectGroupId": 0,
  "keywordId": 0
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/aspects?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0


      curl -G https://data.skema.co.id/24.04/aspects \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'clientId=0'\
    -d 'profileId=0'\
    -d 'keywordGroupId=0'\
    -d 'aspectGroupId=0'\
    -d 'keywordId=0'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/aspects?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/aspects?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/aspects?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/aspects?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Aspect[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

ApiPayload (struct)
Property	Type	Comment
data	Aspect[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

ApiPayload (struct)
Property	Type	Comment
data	Aspect[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Finding a single aspect

 GET /aspects/:aspectId


      curl -G https://data.skema.co.id/24.04/aspects/:aspectId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' 
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/aspects/:aspectId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/aspects/:aspectId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/aspects/:aspectId"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/aspects/:aspectId', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Aspect	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0_0",
    "name": "demokeyw_demas",
    "label": "Demo keyword - Demo aspect",
    "keywordId": 0,
    "profileId": 0,
    "aspectGroupId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

ApiPayload (struct)
Property	Type	Comment
data	Aspect	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0_0",
    "name": "demokeyw_demas",
    "label": "Demo keyword - Demo aspect",
    "keywordId": 0,
    "profileId": 0,
    "aspectGroupId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

ApiPayload (struct)
Property	Type	Comment
data	Aspect	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0_0",
    "name": "demokeyw_demas",
    "label": "Demo keyword - Demo aspect",
    "keywordId": 0,
    "profileId": 0,
    "aspectGroupId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Sources

Provides an interface to interact with the content sources stored in our databases.

Listing content sources

 GET /sources

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

If multiple constraints are given, only the most specific one is taken into consideration.

SourceConstraints (struct)
Property	Type	Comment
countryId omittable	number	The id of the country to query sources for.
keywordId omittable	number	The id of the keyword to query sources for.
aspectId omittable	string	The id of the aspect to query sources for.

Example:

{
  "countryId": 0,
  "keywordId": 0,
  "aspectId": 0
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

countryId=0&keywordId=0&aspectId=0

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/sources?countryId=0&keywordId=0&aspectId=0


      curl -G https://data.skema.co.id/24.04/sources \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'countryId=0'\
    -d 'keywordId=0'\
    -d 'aspectId=0'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/sources?countryId=0&keywordId=0&aspectId=0',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/sources?countryId=0&keywordId=0&aspectId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/sources?countryId=0&keywordId=0&aspectId=0"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/sources?countryId=0&keywordId=0&aspectId=0', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Source[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

ApiPayload (struct)
Property	Type	Comment
data	Source[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

ApiPayload (struct)
Property	Type	Comment
data	Source[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Mentions

Provides an interface to interact with the mention objects stored in our databases.

Listing mentions

 GET /mentions

This is an endpoint that will return mentions for every keyword and/or aspect you specify in the filter structure in a paginated manner. The maximum number of mentions on a single page is 1 000.

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

As our systems process mentions in an asynchronous manner, the time it has been inserted to our database and the date/time it was published on can, and most of the time will differ. This API filters and returns the time the mention was published on, not the time it was inserted to our database. As an example, this asynchronicity also means that if you list monday's mentions on tuesday, and also list them on wednesday, you can get more results on wednesday for monday. This variation in the results is usually only a characteristic of the most recent of time periods, as you query older data, the numer of mentions will be more stable, as the system had more time to find and process all the results.

If you use this endpoint to import/store mentions in your own database, you most likely are only interested in the new mentions in the time period since the last time you checked. To achieve this, you can overwrite the defaults of this endpoint by:

Ordering the results by the mentions' identifier (this creates a natural ordering by the insertion time and not by the published time)
Providing the identifier of the last mention your system knows about

To change the ordering of the results, you want to look at the presentation.order field in the request structure below.

To tell the the API the last mention you know of, you can utilize the filters.keywords and filters.aspects fields in the request structure. You can do so, because each mentions' identifier you receive in this API's response is actually a composite of the data source (be it a keyword or an aspect of a keyword) and the sequential identifier of the mention.

For example, if the last mention your system knows about is 123-456 (as the composite of the keyword's id "123", and the mention's id "456"). You can simply put this identifier into the filters.keywords array, and the API will only return mentions for that keyword that were found after this one.

If you have multiple keywords to query in a single request, you can include the last mention's identifier for each keyword. For example, you have keywords with ids of "123" and "789". For the first keyword, the last mention you know about is "123-456", and for the second keyword, the last mention you know about is "789-123". Your query string would look like this:

?filters[keywords][0]=123-456&filters[keywords][1]=789-123&presentation[order][0][by]=15&presentation[order][0][direction]=asc

You can also mix plain keyword ids and mention ids as well, by providing only the keyword id for one keyword (in which case all the mentions in the time period will be listed for it), and a mention id for another keyword. Providing multiple mention ids for a single keyword is not supported, and might result in an error in the future.

The same logic applies to the filters.aspects field as well.

View (struct)
filters required	ViewFilter	A structure that influences the multiplicity of the results.
presentation omittable	Presentation	A structure that influences how your data will be presented. Default: `{ "currentPage": 1, "numberOfValues": 100, "includeResourceMap": false, "order": [ { "by": 1, "direction": "desc" } ] }`

View (struct)

Property Type Comment

filters

required

ViewFilter

A structure that influences the multiplicity of the results.

presentation

omittable

Presentation

A structure that influences how your data will be presented.

Default:

{
  "currentPage": 1,
  "numberOfValues": 100,
  "includeResourceMap": false,
  "order": [
    {
      "by": 1,
      "direction": "desc"
    }
  ]
}

Example:

{
  "filters": {
    "aspects": [
      "10001_20002"
    ],
    "keywords": [
      10001,
      10002
    ]
  }
}

Referenced entities by View

ViewFilter (struct)
Property	Type	Comment
aspects required	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords required	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval omittable	IntervalFilter	The timestamps to search beween. Default:last 7 days (start: start of `current day - 7 days` day, end: end of the current day)
sources omittable	SourceGroup[]	Filters between the content sources. Default: `[1]`
genders omittable	GenderGroup[]	Filters for the gender of the author. Default: `[1]`
polarities omittable	PolarityGroup[]	Filters for sentiment between the results. Default: `[1]`
filterLanguages omittable	number[]	Filters for the language of the mention. Default: `[]`
excludeLanguages omittable	number[]	Excludes mentions with the given languages. Default: `[]`
filterPersons omittable	number[][]	Filters for mentions with the given persons. Default: `[]`
excludePersons omittable	number[][]	Excludes mentions with the given persons. Default: `[]`
filterCities omittable	number[]	Filters for the city of the mention. Default: `[]`
filterRegions omittable	number[]	Filters for the region of the mention. Default: `[]`
excludeRegions omittable	number[]	Excludes mentions with the given regions. Default: `[]`
excludeCities omittable	number[]	Excludes mentions with the given cities. Default: `[]`
filterOwnChannels omittable	number[]	Filters for mentions for the given own channels. Default: `[]`
excludeOwnChannels omittable	number[]	Excludes mentions belonging to the given own channels. Default: `[]`
filterTags omittable	number[][]	Filters for mentions with the given tags. Default: `[]`
excludeTags omittable	number[][]	Excludes mentions with the given tags. Default: `[]`
excludeSources omittable	SourceGroup[]	Excludes mentions with the given source types. Default: `[]`
numeric omittable	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count. Default: `[]`
filterPhrases omittable	ConditionFilterDetails	Filters mentions that has the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
excludePhrases omittable	ConditionFilterDetails	Excludes mentions with the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
filterTitles omittable	ConditionFilterDetails	Filters mentions that has the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
excludeTitles omittable	ConditionFilterDetails	Excludes mentions with the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
filterUrls omittable	ConditionFilterDetails	Filters mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
excludeUrls omittable	ConditionFilterDetails	Excludes mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
filterDomains omittable	ConditionFilterDetails	Filters mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
excludeDomains omittable	ConditionFilterDetails	Excludes mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
filterAuthors omittable	ConditionFilterDetails	Filters mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`
excludeAuthors omittable	ConditionFilterDetails	Excludes mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`

Example:

{
  "aspects": [
    "10001_20002"
  ],
  "keywords": [
    10001,
    10002
  ]
}

Referenced entities by ViewFilter

IntervalFilter (struct)
end required	number	The latest time in milliseconds.
start required	number	The earliest time in milliseconds.

IntervalFilter (struct)

Property

Type

Comment

end

required

number

The latest time in milliseconds.

start

required

number

The earliest time in milliseconds.

Example:

{
  "end": 1650978557230,
  "start": 1649768957230
}

NumericFilterDetails (struct)
Property	Type	Comment
id required	NumericFilter	The identifier of the numeric filter.
value required	number	The value of the numeric filter.
operator omittable	Operator	- Default: `"gte"`

Example:

{
  "id": 2,
  "value": 0
}

Referenced entities by NumericFilterDetails

NumericFilter (enum)
Value	Comment
1	Creation time
2	Polarity index
3	Content length
4	Importance score
5	AVE
6	Reach
7	Sum interaction
8	Like count
9	Dislike count
10	Reaction count
11	Share count
12	Comment count
13	Follower count
14	Engagement rate

Operator (enum)
Value	Comment
gte	Greater than or equal to
lte	Less than or equal to
gt	Greater than
lt	Less than
e	Equal to

ConditionFilterDetails (struct)
values required	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType omittable	MatchType	- Default: `"contains"`

ConditionFilterDetails (struct)

Property Type Comment

values

required

string[][]

The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.

matchingType

omittable

MatchType

Default:

"contains"

Example:

{
  "values": [
    [
      "example"
    ]
  ]
}

Referenced entities by ConditionFilterDetails

MatchType (enum)
Value	Comment
contains	The field contains the given phrase
exactMatch	The field matches the given phrase exactly (e.g. author) or contains the exact phrase (e.g. text)
startsWith	The field starts with the given phrase (e.g. author) or contains a phrase that starts with the word (e.g. text)

SourceGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	News
3	Social media
4	Offline sources
5	Front page
6	Forum
7	Blog
8	Comment
9	Article
10	Review
11	Offline print
12	Offline radio
13	Offline tv
14	Facebook
15	Google+
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
23	Vk
24	Vk comment
25	Instagram
26	Tiktok
27	Review classic
28	Review Apple
29	Review Play
30	Review Huawei
31	Facebook page post
32	Facebook page comment
33	Facebook page reply
34	Instagram post
35	Instagram comment
36	Tiktok post
37	Tiktok comment
38	Other - Google+
39	Other - Pinterest
40	Other - Tumblr
41	Video - YouTube video
42	Video - YouTube comment
43	Facebook event post
44	Facebook event comment
45	Facebook group post
46	Facebook group comment
47	News aggregator
48	Facebook group reply
49	Facebook event reply

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

PolarityGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	All not negative
3	All not neutral
4	All not positive
5	All extremes (only very positive or very negative)
6	Positive
7	Neutral
8	Negative
9	Only very positive
10	Only very negative

Presentation (struct)
Property	Type	Comment
currentPage omittable	number	Controls from which page the result set will be returned Default: `1`
numberOfValues omittable	number	The number of mentions per page Default: `100`
order omittable	OrderBy[]	Controls the order of the result set Default: `[{"by":1,"direction":"desc"}]`
includeResourceMap omittable	boolean	Toggles whether the response should include a lookup map for all the resource IDs as a meta object. Default: `false`
ianaTimeZone omittable	string	The time zone that should be applied to the stored data's creation time. Defaults to the profile of the first keyword/aspect filter.

Example:

{
  "currentPage": 1,
  "numberOfValues": 100,
  "order": [
    {
      "by": 1,
      "direction": "desc"
    }
  ],
  "includeResourceMap": false,
  "ianaTimeZone": "Europe/Budapest"
}

Referenced entities by Presentation

OrderBy (struct)
id required	NumericProperty	The identifier of the property to order by
order required	OrderDirection	The direction of the order

OrderBy (struct)

Property

Type

Comment

id

required

NumericProperty

The identifier of the property to order by

order

required

OrderDirection

The direction of the order

Example:

{
  "id": 1,
  "order": "desc"
}

Referenced entities by OrderBy

NumericProperty (enum)
Value	Comment
1	Creation time
2	Polarity index
3	Content length
4	Importance
6	Reach
7	Count of interactions
8	Count of likes
9	Count of dislikes
10	Count of reactions
11	Count of shares
12	Count of comments
13	Count of followers
14	Engagement rate
15	Mention identifier

OrderDirection (enum)
Value	Comment
asc	Ascending
desc	Descending

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/mentions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002


      curl -G https://data.skema.co.id/24.04/mentions \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'filters[aspects][0]=10001_20002'\
    -d 'filters[keywords][0]=10001'\
    -d 'filters[keywords][1]=10002'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/mentions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/mentions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/mentions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/mentions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	MentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0-0",
      "url": "some.domain.net/xyz",
      "title": "Title of the mention",
      "author": "Anonymous",
      "createdAtUtcMs": 0,
      "textOriginal": "The contents of the mention.",
      "textFormatted": "The <span>contents</span> of the mention.",
      "aspectId": 0,
      "keywordId": 0,
      "genderId": 0,
      "sourceId": 10,
      "languageId": 0,
      "subSourceId": null,
      "ownChannelId": null,
      "cityId": null,
      "regionId": null,
      "topicLabelIds": [],
      "brandLabelIds": [],
      "personLabelIds": [],
      "emotionLabelIds": [],
      "locationLabelIds": [],
      "attributeLabelIds": [],
      "organizationLabelIds": [],
      "domain": "some.domain.net",
      "polarity": 0,
      "hash": "asd976asd764asd746a7sd657asd65a7sd",
      "note": "",
      "thumbnailUrl": "",
      "reach": 0,
      "latitude": null,
      "longitude": null,
      "importance": null,
      "isMarked": false,
      "relatedUrl": "",
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 0,
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "facebookDetails": null,
      "instagramDetails": null,
      "twitterDetails": null,
      "youtubeDetails": null,
      "tiktokDetails": null,
      "reviewDetails": {
        "upvote": 0,
        "downvote": 2,
        "starRatingMax": null,
        "starRatingScore": null,
        "starRatingVersion": null
      },
      "pinterestDetails": null,
      "linkedinDetails": null,
      "contentLength": 0,
      "threadId": null,
      "urlAttachments": [
        "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
      ],
      "imageAttachments": [
        "https://some-image-cdn.com/some-image-url"
      ],
      "videoAttachments": [
        "https://www.facebook.com/316463203625299/videos/654117656586322"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

MentionMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the mentions
relatedResources	null \| RelatedResourceMap	Shows the resources that appeared in the mentions (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by MentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	MentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0-0",
      "url": "some.domain.net/xyz",
      "title": "Title of the mention",
      "author": "Anonymous",
      "createdAtUtcMs": 0,
      "textOriginal": "The contents of the mention.",
      "textFormatted": "The <span>contents</span> of the mention.",
      "aspectId": 0,
      "keywordId": 0,
      "genderId": 0,
      "sourceId": 10,
      "languageId": 0,
      "subSourceId": null,
      "ownChannelId": null,
      "cityId": null,
      "regionId": null,
      "topicLabelIds": [],
      "brandLabelIds": [],
      "personLabelIds": [],
      "emotionLabelIds": [],
      "locationLabelIds": [],
      "attributeLabelIds": [],
      "organizationLabelIds": [],
      "domain": "some.domain.net",
      "polarity": 0,
      "hash": "asd976asd764asd746a7sd657asd65a7sd",
      "note": "",
      "thumbnailUrl": "",
      "reach": 0,
      "latitude": null,
      "longitude": null,
      "importance": null,
      "isMarked": false,
      "relatedUrl": "",
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 0,
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "facebookDetails": null,
      "instagramDetails": null,
      "twitterDetails": null,
      "youtubeDetails": null,
      "tiktokDetails": null,
      "reviewDetails": {
        "upvote": 0,
        "downvote": 2,
        "starRatingMax": null,
        "starRatingScore": null,
        "starRatingVersion": null
      },
      "pinterestDetails": null,
      "linkedinDetails": null,
      "contentLength": 0,
      "threadId": null,
      "urlAttachments": [
        "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
      ],
      "imageAttachments": [
        "https://some-image-cdn.com/some-image-url"
      ],
      "videoAttachments": [
        "https://www.facebook.com/316463203625299/videos/654117656586322"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

MentionMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the mentions
relatedResources	null \| RelatedResourceMap	Shows the resources that appeared in the mentions (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by MentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	MentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": "0-0",
      "url": "some.domain.net/xyz",
      "title": "Title of the mention",
      "author": "Anonymous",
      "createdAtUtcMs": 0,
      "textOriginal": "The contents of the mention.",
      "textFormatted": "The <span>contents</span> of the mention.",
      "aspectId": 0,
      "keywordId": 0,
      "genderId": 0,
      "sourceId": 10,
      "languageId": 0,
      "subSourceId": null,
      "ownChannelId": null,
      "cityId": null,
      "regionId": null,
      "topicLabelIds": [],
      "brandLabelIds": [],
      "personLabelIds": [],
      "emotionLabelIds": [],
      "locationLabelIds": [],
      "attributeLabelIds": [],
      "organizationLabelIds": [],
      "domain": "some.domain.net",
      "polarity": 0,
      "hash": "asd976asd764asd746a7sd657asd65a7sd",
      "note": "",
      "thumbnailUrl": "",
      "reach": 0,
      "latitude": null,
      "longitude": null,
      "importance": null,
      "isMarked": false,
      "relatedUrl": "",
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 0,
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "facebookDetails": null,
      "instagramDetails": null,
      "twitterDetails": null,
      "youtubeDetails": null,
      "tiktokDetails": null,
      "reviewDetails": {
        "upvote": 0,
        "downvote": 2,
        "starRatingMax": null,
        "starRatingScore": null,
        "starRatingVersion": null
      },
      "pinterestDetails": null,
      "linkedinDetails": null,
      "contentLength": 0,
      "threadId": null,
      "urlAttachments": [
        "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
      ],
      "imageAttachments": [
        "https://some-image-cdn.com/some-image-url"
      ],
      "videoAttachments": [
        "https://www.facebook.com/316463203625299/videos/654117656586322"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

MentionMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the mentions
relatedResources	null \| RelatedResourceMap	Shows the resources that appeared in the mentions (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by MentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

Finding a single mention

 GET /mentions/:mentionId

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

PartialPresentation (struct)

Property

Type

Comment

presentation

omittable

RelatedResourcesPresentation

A structure that influences how your data will be presented.

Example:

{
  "presentation": {
    "includeResourceMap": false
  }
}

Referenced entities by PartialPresentation

RelatedResourcesPresentation (struct)

Property Type Comment

includeResourceMap

omittable

boolean

Toggles whether the response should include a lookup map for all the resource IDs as a meta object.

Default:

false

Example:

{
  "includeResourceMap": false
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

presentation[includeResourceMap]=false

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/mentions/:mentionid?presentation[includeResourceMap]=false


      curl -G https://data.skema.co.id/24.04/mentions/:mentionId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'presentation[includeResourceMap]=false'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/mentions/:mentionId?presentation[includeResourceMap]=false',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/mentions/:mentionId?presentation[includeResourceMap]=false")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/mentions/:mentionId?presentation[includeResourceMap]=false"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/mentions/:mentionId?presentation[includeResourceMap]=false', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Mention	The resource model(s).
meta	SingleMentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0-0",
    "url": "some.domain.net/xyz",
    "title": "Title of the mention",
    "author": "Anonymous",
    "createdAtUtcMs": 0,
    "textOriginal": "The contents of the mention.",
    "textFormatted": "The <span>contents</span> of the mention.",
    "aspectId": 0,
    "keywordId": 0,
    "genderId": 0,
    "sourceId": 10,
    "languageId": 0,
    "subSourceId": null,
    "ownChannelId": null,
    "cityId": null,
    "regionId": null,
    "topicLabelIds": [],
    "brandLabelIds": [],
    "personLabelIds": [],
    "emotionLabelIds": [],
    "locationLabelIds": [],
    "attributeLabelIds": [],
    "organizationLabelIds": [],
    "domain": "some.domain.net",
    "polarity": 0,
    "hash": "asd976asd764asd746a7sd657asd65a7sd",
    "note": "",
    "thumbnailUrl": "",
    "reach": 0,
    "latitude": null,
    "longitude": null,
    "importance": null,
    "isMarked": false,
    "relatedUrl": "",
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 0,
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "facebookDetails": null,
    "instagramDetails": null,
    "twitterDetails": null,
    "youtubeDetails": null,
    "tiktokDetails": null,
    "reviewDetails": {
      "upvote": 0,
      "downvote": 2,
      "starRatingMax": null,
      "starRatingScore": null,
      "starRatingVersion": null
    },
    "pinterestDetails": null,
    "linkedinDetails": null,
    "contentLength": 0,
    "threadId": null,
    "urlAttachments": [
      "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
    ],
    "imageAttachments": [
      "https://some-image-cdn.com/some-image-url"
    ],
    "videoAttachments": [
      "https://www.facebook.com/316463203625299/videos/654117656586322"
    ]
  },
  "meta": {
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

SingleMentionMeta (struct)
Property	Type	Comment
relatedResources	RelatedResourceMap	Shows the resources that appeared in the mention (controlled by presentation.includeResourceMap)

Example:

{
  "relatedResources": null
}

Referenced entities by SingleMentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention	The resource model(s).
meta	SingleMentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0-0",
    "url": "some.domain.net/xyz",
    "title": "Title of the mention",
    "author": "Anonymous",
    "createdAtUtcMs": 0,
    "textOriginal": "The contents of the mention.",
    "textFormatted": "The <span>contents</span> of the mention.",
    "aspectId": 0,
    "keywordId": 0,
    "genderId": 0,
    "sourceId": 10,
    "languageId": 0,
    "subSourceId": null,
    "ownChannelId": null,
    "cityId": null,
    "regionId": null,
    "topicLabelIds": [],
    "brandLabelIds": [],
    "personLabelIds": [],
    "emotionLabelIds": [],
    "locationLabelIds": [],
    "attributeLabelIds": [],
    "organizationLabelIds": [],
    "domain": "some.domain.net",
    "polarity": 0,
    "hash": "asd976asd764asd746a7sd657asd65a7sd",
    "note": "",
    "thumbnailUrl": "",
    "reach": 0,
    "latitude": null,
    "longitude": null,
    "importance": null,
    "isMarked": false,
    "relatedUrl": "",
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 0,
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "facebookDetails": null,
    "instagramDetails": null,
    "twitterDetails": null,
    "youtubeDetails": null,
    "tiktokDetails": null,
    "reviewDetails": {
      "upvote": 0,
      "downvote": 2,
      "starRatingMax": null,
      "starRatingScore": null,
      "starRatingVersion": null
    },
    "pinterestDetails": null,
    "linkedinDetails": null,
    "contentLength": 0,
    "threadId": null,
    "urlAttachments": [
      "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
    ],
    "imageAttachments": [
      "https://some-image-cdn.com/some-image-url"
    ],
    "videoAttachments": [
      "https://www.facebook.com/316463203625299/videos/654117656586322"
    ]
  },
  "meta": {
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

SingleMentionMeta (struct)
Property	Type	Comment
relatedResources	RelatedResourceMap	Shows the resources that appeared in the mention (controlled by presentation.includeResourceMap)

Example:

{
  "relatedResources": null
}

Referenced entities by SingleMentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention	The resource model(s).
meta	SingleMentionMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": "0-0",
    "url": "some.domain.net/xyz",
    "title": "Title of the mention",
    "author": "Anonymous",
    "createdAtUtcMs": 0,
    "textOriginal": "The contents of the mention.",
    "textFormatted": "The <span>contents</span> of the mention.",
    "aspectId": 0,
    "keywordId": 0,
    "genderId": 0,
    "sourceId": 10,
    "languageId": 0,
    "subSourceId": null,
    "ownChannelId": null,
    "cityId": null,
    "regionId": null,
    "topicLabelIds": [],
    "brandLabelIds": [],
    "personLabelIds": [],
    "emotionLabelIds": [],
    "locationLabelIds": [],
    "attributeLabelIds": [],
    "organizationLabelIds": [],
    "domain": "some.domain.net",
    "polarity": 0,
    "hash": "asd976asd764asd746a7sd657asd65a7sd",
    "note": "",
    "thumbnailUrl": "",
    "reach": 0,
    "latitude": null,
    "longitude": null,
    "importance": null,
    "isMarked": false,
    "relatedUrl": "",
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 0,
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "facebookDetails": null,
    "instagramDetails": null,
    "twitterDetails": null,
    "youtubeDetails": null,
    "tiktokDetails": null,
    "reviewDetails": {
      "upvote": 0,
      "downvote": 2,
      "starRatingMax": null,
      "starRatingScore": null,
      "starRatingVersion": null
    },
    "pinterestDetails": null,
    "linkedinDetails": null,
    "contentLength": 0,
    "threadId": null,
    "urlAttachments": [
      "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
    ],
    "imageAttachments": [
      "https://some-image-cdn.com/some-image-url"
    ],
    "videoAttachments": [
      "https://www.facebook.com/316463203625299/videos/654117656586322"
    ]
  },
  "meta": {
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Mention (struct)
Property	Type	Comment
id	string	The identifier of the mention
url	string	The source url of this mention.
title	string	The title of the mention.
author	string	The name of the author of this mention.
createdAtUtcMs	number	The creation time in milliseconds, GMT.
textOriginal	string	The contents of this mention (plain text)
textFormatted	string	The contents of this mention (negative/positive phrases, links, etc. are decorated by html tags).
aspectId	null \| string	The identifier of the aspect this mention belongs to.
keywordId	number	The identifier of the keyword this mention belongs to.
genderId	GenderGroup	A gender identifier this mention's author was identified as.
sourceId	number	The identifier of the source this mention belongs to.
languageId	number	The identifier of the mention's language.
subSourceId	number	The identifier of the sub-source this mention belongs to.
ownChannelId	null \| number	The identifier of the own channel this mention belongs to.
cityId	null \| number	The identifier of the mention's city.
regionId	null \| number	The identifier of the mention's region.
topicLabelIds	number[]	Topic-related labels
brandLabelIds	number[]	Brand-related labels
personLabelIds	number[]	Person-related labels
emotionLabelIds	number[]	Emotion-related labels
locationLabelIds	number[]	Location-related labels
attributeLabelIds	number[]	Attribute-related labels
organizationLabelIds	number[]	Organization-related labels
domain	string	The source domain of this mention.
polarity	number	The overall sentiment of the mention.
hash	string	The hash of the contents of this mention
note	string	User-added note on the mention.
thumbnailUrl	string\|null	The url of the mention's thumbnail.
reach	number	-
latitude	number	-
longitude	number	-
importance	null \| number	An unsigned int score indicating the importance of this mention. NULL means that it cannot be determined.
isMarked	boolean	Was this mention marked by a user?
relatedUrl	string	The attached/linked external URL in case of (for example) facebook posts/comments.
sumLikes	number	The like count of this mention.
sumShares	number	The share count of this mention.
sumComments	number	The number of comments on this mention.
sumFollowers	number	The follower number of the mention's author.
sumInteractions	number	The interaction count of this mention.
sumDislikes	number	The dislike count of this mention.
sumReactions	number	The reaction count of this mention.
engagementRate	number	The engagement rate of this mention.
facebookDetails	null \| FacebookDetails	Is null when the sum of it's fields is 0 (to save on json size).
instagramDetails	null \| InstagramDetails	Is null when the sum of it's fields is 0 (to save on json size).
twitterDetails	null \| TwitterDetails	Is null when the sum of it's fields is 0 (to save on json size).
youtubeDetails	null \| YouTubeDetails	Is null when the sum of it's fields is 0 (to save on json size).
tiktokDetails	null \| TiktokDetails	Is null when the sum of it's fields is 0 (to save on json size).
reviewDetails	null \| ReviewDetails	Is null when the sum of it's fields is 0 (to save on json size).
pinterestDetails	null \| PinterestDetails	Is null when the sum of it's fields is 0 (to save on json size).
linkedinDetails	null \| LinkedInDetails	Is null when the sum of it's fields is 0 (to save on json size).
contentLength	number	The length of the mention's original text.
threadId	null \| number	The identifier of the thread the mention belongs to.
urlAttachments	string[]	Any links that have been attached to this mention.
imageAttachments	string[]	Any images URLs that have been attached to this mention.
videoAttachments	string[]	Any video URLs that have been attached to this mention.

Example:

{
  "id": "0-0",
  "url": "some.domain.net/xyz",
  "title": "Title of the mention",
  "author": "Anonymous",
  "createdAtUtcMs": 0,
  "textOriginal": "The contents of the mention.",
  "textFormatted": "The <span>contents</span> of the mention.",
  "aspectId": 0,
  "keywordId": 0,
  "genderId": 0,
  "sourceId": 10,
  "languageId": 0,
  "subSourceId": null,
  "ownChannelId": null,
  "cityId": null,
  "regionId": null,
  "topicLabelIds": [],
  "brandLabelIds": [],
  "personLabelIds": [],
  "emotionLabelIds": [],
  "locationLabelIds": [],
  "attributeLabelIds": [],
  "organizationLabelIds": [],
  "domain": "some.domain.net",
  "polarity": 0,
  "hash": "asd976asd764asd746a7sd657asd65a7sd",
  "note": "",
  "thumbnailUrl": "",
  "reach": 0,
  "latitude": null,
  "longitude": null,
  "importance": null,
  "isMarked": false,
  "relatedUrl": "",
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 0,
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "facebookDetails": null,
  "instagramDetails": null,
  "twitterDetails": null,
  "youtubeDetails": null,
  "tiktokDetails": null,
  "reviewDetails": {
    "upvote": 0,
    "downvote": 2,
    "starRatingMax": null,
    "starRatingScore": null,
    "starRatingVersion": null
  },
  "pinterestDetails": null,
  "linkedinDetails": null,
  "contentLength": 0,
  "threadId": null,
  "urlAttachments": [
    "https://telex.hu/podcast/2023/07/13/after-aranylemez-slagerlista-mezei-csaba"
  ],
  "imageAttachments": [
    "https://some-image-cdn.com/some-image-url"
  ],
  "videoAttachments": [
    "https://www.facebook.com/316463203625299/videos/654117656586322"
  ]
}

Referenced entities by Mention

FacebookDetails (struct)
Property	Type	Comment
angry	number	The count of angry reactions on this mention.
care	number	The count of care reactions on this mention.
haha	number	The count of haha reactions on this mention.
love	number	The count of love reactions on this mention.
sad	number	The count of sad reactions on this mention.
wow	number	The count of wow reactions on this mention.
fan	number	The count of fans on this page.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
reply	number	The count of replies on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0,
  "fan": 0,
  "like": 0,
  "share": 0,
  "reply": 0,
  "comment": 0
}

InstagramDetails (struct)
Property	Type	Comment
like	number	The count of likes of this mention.
view	number	The count of views of this mention.
score	number	The count of scores of this mention.
comment	number	The count of comments of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "view": 0,
  "score": 0,
  "comment": 0,
  "follower": 0
}

TwitterDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.
retweet	number	The number of retweets of this mention.
follower	number	The count of followers of the author.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0
}

YouTubeDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
dislike	number	The count of dislikes on this mention.
comment	number	The count of comments on this mention.
subscribe	number	The count of subscriptions on the channel.

Example:

{
  "view": 0,
  "like": 0,
  "dislike": 0,
  "comment": 0,
  "subscribe": 0
}

TiktokDetails (struct)
Property	Type	Comment
view	number	The count of views on this mention.
like	number	The count of likes on this mention.
share	number	The count of shares on this mention.
follower	number	The count of followers of the author.

Example:

{
  "view": 0,
  "like": 0,
  "share": 0,
  "follower": 0
}

ReviewDetails (struct)
Property	Type	Comment
upvote	number	The count of upvotes on this mention.
downvote	number	The count of downvotes on this mention.
starRatingMax	number	The maximum stars one can give.
starRatingScore	number	The count of stars this mention got.
starRatingVersion	string	The version this mention is associated to.

Example:

{
  "upvote": 0,
  "downvote": 2,
  "starRatingMax": null,
  "starRatingScore": null,
  "starRatingVersion": null
}

PinterestDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
comment	number	The count of comments on this mention.

Example:

{
  "like": 0,
  "comment": 0
}

LinkedInDetails (struct)
Property	Type	Comment
like	number	The count of likes on this mention.
view	number	The count of views on this mention.
love	number	The count of love reactions on this mention.
share	number	The count of shares on this mention.
funny	number	The count of funny reactions on this mention.
comment	number	The count of comments on this mention.
support	number	The count of support reactions on this mention.
curious	number	The count of curious reactions on this mention.
follower	number	The count of followers of the author.
celebrate	number	The count of celebrate reactions on this mention.
insightful	number	The count of insightful reactions on this mention.

Example:

{
  "like": 0,
  "view": 0,
  "love": 0,
  "share": 0,
  "funny": 0,
  "comment": 0,
  "support": 0,
  "curious": 0,
  "follower": 0,
  "celebrate": 0,
  "insightful": 0
}

GenderGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	Only males.
3	Only females.
4	Only genders not identified as any previous variants.

SingleMentionMeta (struct)
Property	Type	Comment
relatedResources	RelatedResourceMap	Shows the resources that appeared in the mention (controlled by presentation.includeResourceMap)

Example:

{
  "relatedResources": null
}

Referenced entities by SingleMentionMeta

RelatedResourceMap (struct)
Property	Type	Comment
labels	ByLabelTypes<Record<number, Label>>	Map of the labels that appeared in the mentions
sources	Record<number, Source>	Map of the sources that appeared in the mentions
aspects	Record<number, Aspect>	Map of the aspects that appeared in the mentions
keywords	Record<number, Keyword>	Map of the keywords that appeared in the mentions
ownChannels	Record<number, OwnChannel>	Map of the own channels that appeared in the mentions
genders	Record<number, GenderRecord>	Map of the genders that appeared in the mentions
languages	Record<number, Language>	Map of the languages the mentions appeared in
cities	Record<number, City>	Map of the cities the mentions are from
regions	Record<number, Region>	Map of the regions the mentions are from

Example:

{
  "labels": {
    "topic": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "brand": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "person": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "emotion": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "location": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "attribute": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    },
    "organization": {
      "0": {
        "id": 0,
        "label": "demo label"
      }
    }
  },
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  },
  "ownChannels": {
    "0": {
      "id": 0,
      "type": "google_location",
      "keywordId": 0,
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "channelId": "18120169027748581498",
      "channelName": "Location#1",
      "createdAt": 0,
      "createdBy": 0,
      "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
      "label": "Location#1"
    }
  },
  "genders": {
    "2": {
      "id": 2,
      "name": "male",
      "label": "Male"
    }
  },
  "languages": {
    "0": {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  },
  "cities": {
    "0": {
      "id": 0,
      "label": "Budapest",
      "countryId": 1
    }
  },
  "regions": {
    "0": {
      "id": 0,
      "label": "Pest",
      "countryId": 1
    }
  }
}

Referenced entities by RelatedResourceMap

GenderRecord (struct)
Property	Type	Comment
id	number	The identifier of the gender
name	string	An internal name for the gender
label	string	A displayable name of the gender

Example:

{
  "id": 2,
  "name": "male",
  "label": "Male"
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	string	The type of the own channel.
keywordId	number	The id of the keyword this own channel belongs to.
keywordGroupId	number	The id of the group this own channel belongs to.
profileId	number	The id of the profile this own channel belongs to.
clientId	number	The id of the client this own channel belongs to.
countryId	number	The id of the country this own channel belongs to.
channelId	string	The channel's identifier on its original source.
channelName	string	The name of the channel.
createdAt	number	The date of creation in milliseconds.
createdBy	number	The id of the creator.
additionalInfo	string	Any additional information, e.g.: address.
label	string	A displayable name of the own channel.

Example:

{
  "id": 0,
  "type": "google_location",
  "keywordId": 0,
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "channelId": "18120169027748581498",
  "channelName": "Location#1",
  "createdAt": 0,
  "createdBy": 0,
  "additionalInfo": "Budapest 1083, Bókay János utca 44-46",
  "label": "Location#1"
}

ByLabelTypes (struct)
Property	Type	Comment
topic	Label	Topic labels that appeared in the mentions
brand	Label	Brand labels that appeared in the mentions
person	Label	Person labels that appeared in the mentions
emotion	Label	Emotion labels that appeared in the mentions
location	Label	Location labels that appeared in the mentions
attribute	Label	Attribute labels that appeared in the mentions
organization	Label	Organization labels that appeared in the mentions

Example:

{
  "topic": {
    "id": 0,
    "label": "demo label"
  },
  "brand": {
    "id": 0,
    "label": "demo label"
  },
  "person": {
    "id": 0,
    "label": "demo label"
  },
  "emotion": {
    "id": 0,
    "label": "demo label"
  },
  "location": {
    "id": 0,
    "label": "demo label"
  },
  "attribute": {
    "id": 0,
    "label": "demo label"
  },
  "organization": {
    "id": 0,
    "label": "demo label"
  }
}

Referenced entities by ByLabelTypes

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Language (struct)
Property	Type	Comment
id	number	The identifier of the language
label	string	A displayable name of the language
isoCode2	string	The 2-letter ISO code of the language
neticleCode	string	An internal code for the language

Example:

{
  "id": 0,
  "label": "Ukrainian",
  "isoCode2": "uk",
  "neticleCode": "ua"
}

City (struct)
Property	Type	Comment
id	number	The identifier of the city
label	string	A displayable name of the city
countryId	string	The identifier of the city's country

Example:

{
  "id": 0,
  "label": "Budapest",
  "countryId": 1
}

Region (struct)
Property	Type	Comment
id	number	The identifier of the region
label	string	A displayable name of the region
countryId	string	The identifier of the region's country

Example:

{
  "id": 0,
  "label": "Pest",
  "countryId": 1
}

Label (struct)
Property	Type	Comment
id	number	The identifier of the label
label	string	The label

Example:

{
  "id": 0,
  "label": "demo label"
}

Keywords

Provides an interface to interact with the keyword objects stored in our databases.

Listing keywords

 GET /keywords

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

If multiple constraints are given, only the most specific one is taken into consideration.

Constraints (struct)
Property	Type	Comment
clientId omittable	number	Filter by a client.
profileId omittable	number	Filter by a profile.
keywordGroupId omittable	number	Filter by a keyword group.

Example:

{
  "clientId": 0,
  "profileId": 0,
  "keywordGroupId": 0
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

clientId=0&profileId=0&keywordGroupId=0

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/keywords?clientId=0&profileId=0&keywordGroupId=0


      curl -G https://data.skema.co.id/24.04/keywords \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'clientId=0'\
    -d 'profileId=0'\
    -d 'keywordGroupId=0'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/keywords?clientId=0&profileId=0&keywordGroupId=0',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/keywords?clientId=0&profileId=0&keywordGroupId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keywords?clientId=0&profileId=0&keywordGroupId=0"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/keywords?clientId=0&profileId=0&keywordGroupId=0', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Keyword[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

ApiPayload (struct)
Property	Type	Comment
data	Keyword[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

ApiPayload (struct)
Property	Type	Comment
data	Keyword[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Finding a single keyword

 GET /keywords/:keywordId


      curl -G https://data.skema.co.id/24.04/keywords/:keywordId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' 
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/keywords/:keywordId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/keywords/:keywordId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keywords/:keywordId"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/keywords/:keywordId', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Keyword	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "demokeyw",
    "label": "Demo keyword",
    "profileId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true,
    "isOwn": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0,
    "synCheckForumTitle": false,
    "createdForIntegration": null,
    "notes": null
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

ApiPayload (struct)
Property	Type	Comment
data	Keyword	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "demokeyw",
    "label": "Demo keyword",
    "profileId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true,
    "isOwn": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0,
    "synCheckForumTitle": false,
    "createdForIntegration": null,
    "notes": null
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

ApiPayload (struct)
Property	Type	Comment
data	Keyword	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "demokeyw",
    "label": "Demo keyword",
    "profileId": 0,
    "keywordGroupId": 0,
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "sourceIds": [],
    "color": "#0099FF",
    "isActive": true,
    "isOwn": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0,
    "synCheckForumTitle": false,
    "createdForIntegration": null,
    "notes": null
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Profiles

Provides an interface to interact with the profile objects stored in our databases.

Listing profiles

 GET /profiles

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

Constraints (struct)

Property

Type

Comment

clientId

omittable

number

Filter by a client.

Example:

{
  "clientId": 0
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

clientId=0

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/profiles?clientId=0


      curl -G https://data.skema.co.id/24.04/profiles \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'clientId=0'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/profiles?clientId=0',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/profiles?clientId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/profiles?clientId=0"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/profiles?clientId=0', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Profile[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Demo profile",
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "isAiEnabled": false,
      "hasActiveKeywords": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Profile[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Demo profile",
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "isAiEnabled": false,
      "hasActiveKeywords": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Profile[]	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Demo profile",
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "isAiEnabled": false,
      "hasActiveKeywords": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

Finding a single profile

 GET /profiles/:profileId


      curl -G https://data.skema.co.id/24.04/profiles/:profileId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' 
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/profiles/:profileId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/profiles/:profileId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/profiles/:profileId"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/profiles/:profileId', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Profile	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "label": "Demo profile",
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "isAiEnabled": false,
    "hasActiveKeywords": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Profile	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "label": "Demo profile",
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "isAiEnabled": false,
    "hasActiveKeywords": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

ApiPayload (struct)
Property	Type	Comment
data	Profile	The resource model(s).
meta	null	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "label": "Demo profile",
    "clientId": 0,
    "countryId": 0,
    "ianaTimeZone": "Europe/Budapest",
    "ianaLanguages": [
      "hu"
    ],
    "isActive": true,
    "isAiEnabled": false,
    "hasActiveKeywords": true,
    "updatedAtUtcMs": null,
    "updatedBy": null,
    "createdAtUtcMs": 0,
    "createdBy": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

Insights

Provides an interface to interact with the insight objects stored in our databases.

Listing insights

 GET /insights

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

InsightView (struct)

Property Type Comment

filters

required

InsightViewFilter

A structure that influences the multiplicity of the results.

presentation

omittable

InsightPresentation

A structure that influences how your data will be presented.

Default:

{
  "currentPage": 1,
  "numberOfValues": 100,
  "includeResourceMap": false
}

Example:

{
  "filters": {
    "aspects": [
      "10001_20002"
    ],
    "keywords": [
      10001,
      10002
    ],
    "interval": {
      "end": 1650978557230,
      "start": 1649768957230
    }
  }
}

Referenced entities by InsightView

InsightViewFilter (struct)
Property	Type	Comment
aspects required	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords required	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval required	IntervalFilter	The timestamps to search beween.
sources omittable	SourceGroup[]	Filters between the content sources.

Example:

{
  "aspects": [
    "10001_20002"
  ],
  "keywords": [
    10001,
    10002
  ],
  "interval": {
    "end": 1650978557230,
    "start": 1649768957230
  }
}

Referenced entities by InsightViewFilter

IntervalFilter (struct)

Property

Type

Comment

end

required

number

The latest time in milliseconds.

start

required

number

The earliest time in milliseconds.

Example:

{
  "end": 1650978557230,
  "start": 1649768957230
}

SourceGroup (enum)
Value	Comment
1	No restriction, includes all following variants.
2	News
3	Social media
4	Offline sources
5	Front page
6	Forum
7	Blog
8	Comment
9	Article
10	Review
11	Offline print
12	Offline radio
13	Offline tv
14	Facebook
15	Google+
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
23	Vk
24	Vk comment
25	Instagram
26	Tiktok
27	Review classic
28	Review Apple
29	Review Play
30	Review Huawei
31	Facebook page post
32	Facebook page comment
33	Facebook page reply
34	Instagram post
35	Instagram comment
36	Tiktok post
37	Tiktok comment
38	Other - Google+
39	Other - Pinterest
40	Other - Tumblr
41	Video - YouTube video
42	Video - YouTube comment
43	Facebook event post
44	Facebook event comment
45	Facebook group post
46	Facebook group comment
47	News aggregator
48	Facebook group reply
49	Facebook event reply

InsightPresentation (struct)
Property	Type	Comment
currentPage omittable	number	Controls from which page the result set will be returned Default: `1`
numberOfValues omittable	number	The number of mentions per page Default: `100`
includeResourceMap omittable	boolean	Toggles whether the response should include a lookup map for all the resource IDs as a meta object. Default: `false`

Example:

{
  "currentPage": 1,
  "numberOfValues": 100,
  "includeResourceMap": false
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/insights?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230


      curl -G https://data.skema.co.id/24.04/insights \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'filters[aspects][0]=10001_20002'\
    -d 'filters[keywords][0]=10001'\
    -d 'filters[keywords][1]=10002'\
    -d 'filters[interval][end]=1650978557230'\
    -d 'filters[interval][start]=1649768957230'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/insights?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/insights?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/insights?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/insights?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002&filters[interval][end]=1650978557230&filters[interval][start]=1649768957230', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Insight[]	The resource model(s).
meta	InsightsMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "groupUuid": "",
      "aspectId": null,
      "keywordId": 0,
      "sourceId": 0,
      "type": "",
      "entity": null,
      "mentionIds": [],
      "previousValue": 0,
      "currentValue": 0,
      "createdAtUtcMs": 0,
      "description": {
        "title": "Title of the insight",
        "text": "Text of the insight"
      }
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Insight (struct)
Property	Type	Comment
id	number	The identifier of the insight
groupUuid	string	The group identifier of the insight
aspectId	string \| null	The identifier of the aspect this insight belongs to
keywordId	number	The identifier of the keyword this insight belongs to
sourceId	number \| null	The identifier of the source this insight belongs to
type	string	The type of the insight
entity	string \| null	The subject of the insight
mentionIds	number[]	The related mentions
previousValue	number	The previous value (number of mentions, reach, web opinion index etc.)
currentValue	number	The current value (number of mentions, reach, web opinion index etc.)
createdAtUtcMs	number	The creation time in milliseconds, GMT
description	InsightDescription	-

Example:

{
  "id": 0,
  "groupUuid": "",
  "aspectId": null,
  "keywordId": 0,
  "sourceId": 0,
  "type": "",
  "entity": null,
  "mentionIds": [],
  "previousValue": 0,
  "currentValue": 0,
  "createdAtUtcMs": 0,
  "description": {
    "title": "Title of the insight",
    "text": "Text of the insight"
  }
}

Referenced entities by Insight

InsightDescription (struct)
Property	Type	Comment
title	string	The title of the insight.
text	string	The text of the insight.

Example:

{
  "title": "Title of the insight",
  "text": "Text of the insight"
}

InsightsMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the insights
relatedResources	InsightsRelatedResourceMap	Shows the resources that appeared in the insights (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by InsightsMeta

InsightsRelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	Map of the sources the insights belong to
aspects	Record<number, Aspect>	Map of the aspects the insights belong to
keywords	Record<number, Keyword>	Map of the keywords the insights belong to

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  }
}

Referenced entities by InsightsRelatedResourceMap

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

ApiPayload (struct)
Property	Type	Comment
data	Insight[]	The resource model(s).
meta	InsightsMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "groupUuid": "",
      "aspectId": null,
      "keywordId": 0,
      "sourceId": 0,
      "type": "",
      "entity": null,
      "mentionIds": [],
      "previousValue": 0,
      "currentValue": 0,
      "createdAtUtcMs": 0,
      "description": {
        "title": "Title of the insight",
        "text": "Text of the insight"
      }
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Insight (struct)
Property	Type	Comment
id	number	The identifier of the insight
groupUuid	string	The group identifier of the insight
aspectId	string \| null	The identifier of the aspect this insight belongs to
keywordId	number	The identifier of the keyword this insight belongs to
sourceId	number \| null	The identifier of the source this insight belongs to
type	string	The type of the insight
entity	string \| null	The subject of the insight
mentionIds	number[]	The related mentions
previousValue	number	The previous value (number of mentions, reach, web opinion index etc.)
currentValue	number	The current value (number of mentions, reach, web opinion index etc.)
createdAtUtcMs	number	The creation time in milliseconds, GMT
description	InsightDescription	-

Example:

{
  "id": 0,
  "groupUuid": "",
  "aspectId": null,
  "keywordId": 0,
  "sourceId": 0,
  "type": "",
  "entity": null,
  "mentionIds": [],
  "previousValue": 0,
  "currentValue": 0,
  "createdAtUtcMs": 0,
  "description": {
    "title": "Title of the insight",
    "text": "Text of the insight"
  }
}

Referenced entities by Insight

InsightDescription (struct)
Property	Type	Comment
title	string	The title of the insight.
text	string	The text of the insight.

Example:

{
  "title": "Title of the insight",
  "text": "Text of the insight"
}

InsightsMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the insights
relatedResources	InsightsRelatedResourceMap	Shows the resources that appeared in the insights (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by InsightsMeta

InsightsRelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	Map of the sources the insights belong to
aspects	Record<number, Aspect>	Map of the aspects the insights belong to
keywords	Record<number, Keyword>	Map of the keywords the insights belong to

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  }
}

Referenced entities by InsightsRelatedResourceMap

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

ApiPayload (struct)
Property	Type	Comment
data	Insight[]	The resource model(s).
meta	InsightsMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "groupUuid": "",
      "aspectId": null,
      "keywordId": 0,
      "sourceId": 0,
      "type": "",
      "entity": null,
      "mentionIds": [],
      "previousValue": 0,
      "currentValue": 0,
      "createdAtUtcMs": 0,
      "description": {
        "title": "Title of the insight",
        "text": "Text of the insight"
      }
    }
  ],
  "meta": {
    "pagination": {
      "to": 100,
      "from": 1,
      "total": 300,
      "perPage": 100,
      "currentPage": 1,
      "lastPage": 1,
      "queryParams": {
        "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
        "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
        "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
        "previousPage": ""
      }
    },
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Insight (struct)
Property	Type	Comment
id	number	The identifier of the insight
groupUuid	string	The group identifier of the insight
aspectId	string \| null	The identifier of the aspect this insight belongs to
keywordId	number	The identifier of the keyword this insight belongs to
sourceId	number \| null	The identifier of the source this insight belongs to
type	string	The type of the insight
entity	string \| null	The subject of the insight
mentionIds	number[]	The related mentions
previousValue	number	The previous value (number of mentions, reach, web opinion index etc.)
currentValue	number	The current value (number of mentions, reach, web opinion index etc.)
createdAtUtcMs	number	The creation time in milliseconds, GMT
description	InsightDescription	-

Example:

{
  "id": 0,
  "groupUuid": "",
  "aspectId": null,
  "keywordId": 0,
  "sourceId": 0,
  "type": "",
  "entity": null,
  "mentionIds": [],
  "previousValue": 0,
  "currentValue": 0,
  "createdAtUtcMs": 0,
  "description": {
    "title": "Title of the insight",
    "text": "Text of the insight"
  }
}

Referenced entities by Insight

InsightDescription (struct)
Property	Type	Comment
title	string	The title of the insight.
text	string	The text of the insight.

Example:

{
  "title": "Title of the insight",
  "text": "Text of the insight"
}

InsightsMeta (struct)
Property	Type	Comment
pagination	Pagination	Pagination for the insights
relatedResources	InsightsRelatedResourceMap	Shows the resources that appeared in the insights (controlled by presentation.includeResourceMap)

Example:

{
  "pagination": {
    "to": 100,
    "from": 1,
    "total": 300,
    "perPage": 100,
    "currentPage": 1,
    "lastPage": 1,
    "queryParams": {
      "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
      "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
      "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
      "previousPage": ""
    }
  },
  "relatedResources": null
}

Referenced entities by InsightsMeta

InsightsRelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	Map of the sources the insights belong to
aspects	Record<number, Aspect>	Map of the aspects the insights belong to
keywords	Record<number, Keyword>	Map of the keywords the insights belong to

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null
    }
  },
  "aspects": {
    "0_0": {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  },
  "keywords": {
    "0": {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  }
}

Referenced entities by InsightsRelatedResourceMap

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Source (struct)
Property	Type	Comment
id	number	The identifier of the source
name	string	An internal name for the source
order	number	The order of the source
color	string	The color of the source
isGroup	boolean	-
isEnabled	boolean	-
sourceCode	number	An internal code for the source
parentSourceId	null \| number	The id of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null
}

Pagination (struct)
Property	Type	Comment
to	number	The placement of the last mention in the order
from	number	The placement of the first mention in the order
total	number	The number of mentions in total that satisfied the original filter conditions
perPage	number	The number of mentions per page
currentPage	number	The current page number
lastPage	number	The last page number
queryParams	QueryParams	Query strings

Example:

{
  "to": 100,
  "from": 1,
  "total": 300,
  "perPage": 100,
  "currentPage": 1,
  "lastPage": 1,
  "queryParams": {
    "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
    "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
    "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
    "previousPage": ""
  }
}

Referenced entities by Pagination

QueryParams (struct)
Property	Type	Comment
lastPage	string	-
nextPage	string	-
firstPage	string	-
previousPage	string	-

Example:

{
  "lastPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=47",
  "nextPage": "?filters[keywords][0]=10088&filters[interval][end]=1662641856919&filters[interval][start]=1661432256919&presentation[currentPage]=2",
  "firstPage": "?filters[keywords][0]=10088&filters[interval][end]=1662642811176&filters[interval][start]=1661433211176",
  "previousPage": ""
}

Resources

Provides an interface to interact with the resources stored in our databases.

Listing resources

 GET /resources

The API expects the structure below to be passed in the url parameters (query string), formatted as an url-encoded string.

If multiple constraints are given, only the most specific one is taken into consideration.

Constraints (struct)
Property	Type	Comment
clientId omittable	number	Filter by a client.
profileId omittable	number	Filter by a profile.
keywordGroupId omittable	number	Filter by a keyword group.
aspectGroupId omittable	number	Filter by an aspect group.
keywordId omittable	number	Filter by a keyword.
aspectId omittable	string	Filter by an aspect.
presentation omittable	ResourcesPresentation	-

Example:

{
  "clientId": 0,
  "profileId": 0,
  "keywordGroupId": 0,
  "aspectGroupId": 0,
  "keywordId": 0,
  "aspectId": "0_0",
  "presentation": {
    "showInactive": false,
    "includeResourceMap": false
  }
}

Referenced entities by Constraints

ResourcesPresentation (struct)

Property Type Comment

showInactive

omittable

boolean

Toggles whether the response should include the invalid resources.

Default:

false

includeResourceMap

omittable

boolean

Toggles whether the response should include a lookup map for all the resource IDs as a meta object.

Default:

false

Example:

{
  "showInactive": false,
  "includeResourceMap": false
}

First, format the structure to an URL-encoded string (please escape only the individual properties and/or the values instead of the whole query string, bracket characters do have a meaning!):

clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false

Finally, append the string to the end of the endpoint, separated by a "?" (question mark):

/resources?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false


      curl -G https://data.skema.co.id/24.04/resources \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'clientId=0'\
    -d 'profileId=0'\
    -d 'keywordGroupId=0'\
    -d 'aspectGroupId=0'\
    -d 'keywordId=0'\
    -d 'aspectId=0_0'\
    -d 'presentation[showInactive]=false'\
    -d 'presentation[includeResourceMap]=false'
  
      const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/resources?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.get("https://data.skema.co.id/24.04/resources?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/resources?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false"

payload = {}
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6'
];

$request = new Request('GET', 'https://data.skema.co.id/24.04/resources?clientId=0&profileId=0&keywordGroupId=0&aspectGroupId=0&keywordId=0&aspectId=0_0&presentation[showInactive]=false&presentation[includeResourceMap]=false', $headers );
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

The API returns with the structure below in a JSON format.

ApiPayload (struct)
Property	Type	Comment
data	Resources	The resource model(s).
meta	ResourcesMeta	Any model/infromation related to the data.
error	null	Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "clients": [
      {
        "id": 0,
        "name": "en_demo",
        "label": "Demo client",
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "isActive": true,
        "updatedAtUtcMs": null,
        "updatedBy": null,
        "createdAtUtcMs": 0,
        "createdBy": 0
      }
    ],
    "aspects": [
      {
        "id": "0_0",
        "name": "demokeyw_demas",
        "label": "Demo keyword - Demo aspect",
        "keywordId": 0,
        "profileId": 0,
        "aspectGroupId": 0,
        "keywordGroupId": 0,
        "clientId": 0,
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "sourceIds": [],
        "color": "#0099FF",
        "isActive": true
      }
    ],
    "keywords": [
      {
        "id": 0,
        "name": "demokeyw",
        "label": "Demo keyword",
        "profileId": 0,
        "keywordGroupId": 0,
        "clientId": 0,
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "sourceIds": [],
        "color": "#0099FF",
        "isActive": true,
        "isOwn": true,
        "updatedAtUtcMs": null,
        "updatedBy": null,
        "createdAtUtcMs": 0,
        "createdBy": 0,
        "synCheckForumTitle": false,
        "createdForIntegration": null,
        "notes": null
      }
    ],
    "profiles": [
      {
        "id": 0,
        "label": "Demo profile",
        "clientId": 0,
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "isActive": true,
        "isAiEnabled": false,
        "hasActiveKeywords": true,
        "updatedAtUtcMs": null,
        "updatedBy": null,
        "createdAtUtcMs": 0,
        "createdBy": 0
      }
    ],
    "aspectGroups": [
      {
        "id": 0,
        "name": "demaspg",
        "label": "Demo aspect group",
        "keywordGroupId": 0,
        "profileId": 0,
        "clientId": 0,
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "isActive": true,
        "updatedAtUtcMs": null,
        "updatedBy": null,
        "createdAtUtcMs": 0,
        "createdBy": 0
      }
    ],
    "keywordGroups": [
      {
        "id": 0,
        "label": "Demo keyword group",
        "profileId": 0,
        "clientId": 0,
        "countryId": 0,
        "ianaTimeZone": "Europe/Budapest",
        "ianaLanguages": [
          "hu"
        ],
        "isActive": true,
        "updatedAtUtcMs": null,
        "updatedBy": null,
        "createdAtUtcMs": 0,
        "createdBy": 0
      }
    ]
  },
  "meta": {
    "relatedResources": null
  },
  "error": null
}

Referenced entities by ApiPayload

Resources (struct)
Property	Type	Comment
clients	Client[]	Available clients
aspects	Aspect[]	Available aspects
keywords	Keyword[]	Available keywords
profiles	Profile[]	Available profiles
aspectGroups	AspectGroup[]	Available aspect groups
keywordGroups	KeywordGroup[]	Available keyword groups

Example:

{
  "clients": [
    {
      "id": 0,
      "name": "en_demo",
      "label": "Demo client",
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "aspects": [
    {
      "id": "0_0",
      "name": "demokeyw_demas",
      "label": "Demo keyword - Demo aspect",
      "keywordId": 0,
      "profileId": 0,
      "aspectGroupId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true
    }
  ],
  "keywords": [
    {
      "id": 0,
      "name": "demokeyw",
      "label": "Demo keyword",
      "profileId": 0,
      "keywordGroupId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "sourceIds": [],
      "color": "#0099FF",
      "isActive": true,
      "isOwn": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0,
      "synCheckForumTitle": false,
      "createdForIntegration": null,
      "notes": null
    }
  ],
  "profiles": [
    {
      "id": 0,
      "label": "Demo profile",
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "isAiEnabled": false,
      "hasActiveKeywords": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "aspectGroups": [
    {
      "id": 0,
      "name": "demaspg",
      "label": "Demo aspect group",
      "keywordGroupId": 0,
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ],
  "keywordGroups": [
    {
      "id": 0,
      "label": "Demo keyword group",
      "profileId": 0,
      "clientId": 0,
      "countryId": 0,
      "ianaTimeZone": "Europe/Budapest",
      "ianaLanguages": [
        "hu"
      ],
      "isActive": true,
      "updatedAtUtcMs": null,
      "updatedBy": null,
      "createdAtUtcMs": 0,
      "createdBy": 0
    }
  ]
}

Referenced entities by Resources

Client (struct)
Property	Type	Comment
id	number	The identifier of the client.
name	string	An internal name for the model.
label	string	The user-displayable name of the client.
countryId	number	The id of the country this client belongs to.
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the client
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the client

Example:

{
  "id": 0,
  "name": "en_demo",
  "label": "Demo client",
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

Aspect (struct)
Property	Type	Comment
id	string	The composite identifier of this object.
name	string	The internal name of the aspect.
label	string	A displayable name of the aspect.
keywordId	number	The keyword's id this aspect is related to.
profileId	number	The id of the profile this aspect belongs to.
aspectGroupId	number	The aspect group's id this aspect is related to.
keywordGroupId	number	The id of the group this aspect belongs to.
clientId	number	The id of the client this aspect belongs to.
countryId	number	The id of the country this aspect belongs to.
ianaTimeZone	string	The IANA time zone if the keyword this aspect belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this aspect's keyword's valid sources.
color	string	The color of the aspect
isActive	boolean	-

Example:

{
  "id": "0_0",
  "name": "demokeyw_demas",
  "label": "Demo keyword - Demo aspect",
  "keywordId": 0,
  "profileId": 0,
  "aspectGroupId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true
}

Keyword (struct)
Property	Type	Comment
id	number	The identifier of the keyword
name	string	An internal name for the keyword
label	string	A displayable name of the keyword
profileId	number	The id of the profile this keyword belongs to.
keywordGroupId	number	The id of the group this keyword belongs to.
clientId	number	The id of the client this keyword belongs to.
countryId	number	The id of the country this keyword belongs to.
ianaTimeZone	string	The IANA time zone this keyword belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
sourceIds	number[]	The ids of this keyword's valid sources.
color	string	The color of the keyword
isActive	boolean	Is the keyword active or inactive?
isOwn	boolean	Is own keyword?
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the keyword
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword
synCheckForumTitle	boolean	Tells whether mentions are to be to collected from related discussions or not
createdForIntegration	string \| null	-
notes	string \| null	-

Example:

{
  "id": 0,
  "name": "demokeyw",
  "label": "Demo keyword",
  "profileId": 0,
  "keywordGroupId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "sourceIds": [],
  "color": "#0099FF",
  "isActive": true,
  "isOwn": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0,
  "synCheckForumTitle": false,
  "createdForIntegration": null,
  "notes": null
}

Profile (struct)
Property	Type	Comment
id	number	The identifier of the profile instance.
label	string	The user-displayable name of the profile.
clientId	number	The id of the client this profile belongs to.
countryId	number	The id of the country this profile belongs to.
ianaTimeZone	string	The IANA time zone this profile belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
isAiEnabled	boolean	-
hasActiveKeywords	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the profile
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the profile

Example:

{
  "id": 0,
  "label": "Demo profile",
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "isAiEnabled": false,
  "hasActiveKeywords": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

AspectGroup (struct)
Property	Type	Comment
id	number	The identifier of the aspect group
name	string	The internal name of the aspect group
label	string	The displayable name of the aspect group
keywordGroupId	number	The id of the keyword group this aspect groups belongs to.
profileId	number	The id of the profile this aspect group belongs to.
clientId	number	The id of the client this aspect group belongs to.
countryId	number	The id of the country this aspect group belongs to.
ianaTimeZone	string	The IANA time zone of the keyword group this aspect group belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.
isActive	boolean	-
updatedAtUtcMs	number \| null	The time of the last update in milliseconds, GMT
updatedBy	number \| null	The identifier of the user who updated the aspect group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the aspect group

Example:

{
  "id": 0,
  "name": "demaspg",
  "label": "Demo aspect group",
  "keywordGroupId": 0,
  "profileId": 0,
  "clientId": 0,
  "countryId": 0,
  "ianaTimeZone": "Europe/Budapest",
  "ianaLanguages": [
    "hu"
  ],
  "isActive": true,
  "updatedAtUtcMs": null,
  "updatedBy": null,
  "createdAtUtcMs": 0,
  "createdBy": 0
}

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the k