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>

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.

Mentions

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

Listing mentions

 GET /mentions

This endpoint has been designed for one-off operations. It can filter, group and order the mentions in multiple ways, even from multiple data sources. If you are looking to import mentions into your own database, please check out the much more efficient Mention Data Feed endpoints, as they were specifically designed for that purpose.

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.

View (struct)
filters required	ViewFilter	A structure that influences the multiplicity of the results.
presentation omitable	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

omitable

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 omitable	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 omitable	SourceGroup[]	Filters between the content sources. Default: `[1]`
genders omitable	GenderGroup[]	Filters for the gender of the author. Default: `[1]`
polarities omitable	PolarityGroup[]	Filters for sentiment between the results. Default: `[1]`
filterLanguages omitable	number[]	Filters for the language of the mention. Default: `[]`
excludeLanguages omitable	number[]	Excludes mentions with the given languages. Default: `[]`
filterPersons omitable	number[][]	Filters for mentions with the given persons. Default: `[]`
excludePersons omitable	number[][]	Excludes mentions with the given persons. Default: `[]`
filterCities omitable	number[]	Filters for the city of the mention. Default: `[]`
filterRegions omitable	number[]	Filters for the region of the mention. Default: `[]`
excludeRegions omitable	number[]	Excludes mentions with the given regions. Default: `[]`
excludeCities omitable	number[]	Excludes mentions with the given cities. Default: `[]`
filterOwnChannels omitable	number[]	Filters for mentions for the given own channels. Default: `[]`
excludeOwnChannels omitable	number[]	Excludes mentions belonging to the given own channels. Default: `[]`
filterTags omitable	number[][]	Filters for mentions with the given tags. Default: `[]`
excludeTags omitable	number[][]	Excludes mentions with the given tags. Default: `[]`
excludeSources omitable	SourceGroup[]	Excludes mentions with the given source types. Default: `[]`
numeric omitable	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count. Default: `[]`
filterPhrases omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
excludePhrases omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
filterTitles omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
excludeTitles omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
filterUrls omitable	ConditionFilterDetails	Filters mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
excludeUrls omitable	ConditionFilterDetails	Excludes mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
filterDomains omitable	ConditionFilterDetails	Filters mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
excludeDomains omitable	ConditionFilterDetails	Excludes mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
filterAuthors omitable	ConditionFilterDetails	Filters mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`
excludeAuthors omitable	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 omitable	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 omitable	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

omitable

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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 omitable	number	Controls from which page the result set will be returned Default: `1`
numberOfValues omitable	number	The number of mentions per page Default: `100`
order omitable	OrderBy[]	Controls the order of the result set Default: `[{"by":1,"direction":"desc"}]`
includeResourceMap omitable	boolean	Toggles whether the response should include a lookup map for all the resource IDs as a meta object. Default: `false`
ianaTimeZone omitable	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		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

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		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

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		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

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

omitable

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

omitable

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		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,
    "discoveredAtUtcMs": 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": "",
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention	The resource model(s).
meta	SingleMentionMeta	Any model/infromation related to the data.
error		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,
    "discoveredAtUtcMs": 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": "",
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention	The resource model(s).
meta	SingleMentionMeta	Any model/infromation related to the data.
error		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,
    "discoveredAtUtcMs": 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": "",
    "sumInteractions": 0,
    "sumDislikes": 0,
    "sumReactions": 0,
    "engagementRate": 0,
    "sumLikes": 0,
    "sumShares": 0,
    "sumComments": 0,
    "sumFollowers": 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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

Updating mentions

 PATCH /mentions/update-many

This endpoint enables clients to modify the sentiment assigned to one or more mentions. It supports batch updates, allowing multiple mentions to be updated in a single request.

The API expects the structure below to be passed in the request body, formatted as a json string.

MentionUpdate (struct)

Property

Type

Comment

fields

required

MentionUpdateableFields

The fields of mentions to be updated

mentionIds

required

string[]

The identifiers of the mentions

Example:

{
  "fields": {
    "polarity": 0
  },
  "mentionIds": [
    "0-0"
  ]
}

Referenced entities by MentionUpdate

MentionUpdateableFields (struct)

Property

Type

Comment

polarity

required

number

The overall sentiment of the mention.

Example:

{
  "polarity": 0
}

First, format the structure to a JSON string:

{"fields":{"polarity":0},"mentionIds":["0-0"]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /mentions/update-many HTTP/1.1
Content-Type: application/json
Content-Length: 46

{"fields":{"polarity":0},"mentionIds":["0-0"]}


      curl -X PATCH https://data.skema.co.id/24.04/mentions/update-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"fields":{"polarity":0},"mentionIds":["0-0"]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "fields": {
    "polarity": 0
  },
  "mentionIds": [
    "0-0"
  ]
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/mentions/update-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/mentions/update-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "fields": {
    "polarity": 0
  },
  "mentionIds": [
    "0-0"
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/mentions/update-many"

payload = json.dumps({
  "fields": {
    "polarity": 0
  },
  "mentionIds": [
    "0-0"
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "fields": {
    "polarity": 0
  },
  "mentionIds": [
    "0-0"
  ]
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/mentions/update-many', $headers , $body);
$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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Deleting mentions

 DELETE /mentions/delete-many

This endpoint enables clients to remove one or multiple mentions. It supports bulk deletion, allowing multiple mentions to be deleted in a single request.

The API expects the structure below to be passed in the request body, formatted as a json string.

MentionUpdate (struct)

Property

Type

Comment

mentionIds

required

string[]

The identifiers of the mentions

Example:

{
  "mentionIds": [
    "0-0"
  ]
}

First, format the structure to a JSON string:

{"mentionIds":["0-0"]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

DELETE /mentions/delete-many HTTP/1.1
Content-Type: application/json
Content-Length: 22

{"mentionIds":["0-0"]}


      curl -X DELETE https://data.skema.co.id/24.04/mentions/delete-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"mentionIds":["0-0"]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "mentionIds": [
    "0-0"
  ]
})
const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/mentions/delete-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.delete("https://data.skema.co.id/24.04/mentions/delete-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "mentionIds": [
    "0-0"
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/mentions/delete-many"

payload = json.dumps({
  "mentionIds": [
    "0-0"
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "mentionIds": [
    "0-0"
  ]
}'
$request = new Request('DELETE', 'https://data.skema.co.id/24.04/mentions/delete-many', $headers , $body);
$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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Deleting a single mention

 DELETE /mentions/delete/:mentionId

This endpoint enables clients to remove one mention.


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

const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/mentions/delete/:mentionId',
  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.delete("https://data.skema.co.id/24.04/mentions/delete/:mentionId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/mentions/delete/:mentionId"

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

response = requests.request("DELETE", 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('DELETE', 'https://data.skema.co.id/24.04/mentions/delete/:mentionId', $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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Restoring mentions

 PATCH /mentions/restore-many

This endpoint allows clients to recover mentions that were previously deleted. The restoration process uses details from the deleted mention logs to identify and restore the affected records.

The API expects the structure below to be passed in the request body, formatted as a json string.

DeletedMentionLog (struct)
Property	Type	Comment
id required	number	The identifier of the deleted mention log
profileId required	number	The identifier of the profile this keyword belongs to.
createdBy required	number	The identifier of the user who deleted the mentions
createdByEmail required	string	The email address of the user who deleted the mentions
createdAtUtcMs required	number	The deletion time in milliseconds, GMT
restoredBy required	null\|number	The identifier of the user who restored the mentions
restoredByEmail required	string\|null	The email address of the user who restored the mentions
restoredAtUtcMs required	null\|number	The restoration time in milliseconds, GMT
mentionsDeleted required	DeletedMentionLogDetails[]	-

Example:

{
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
}

Referenced entities by DeletedMentionLog

DeletedMentionLogDetails (struct)
Property	Type	Comment
keywordId required	number	The identifier of the keyword the mention(s) belong to
aspectId required	null\|number	The identifier of the aspect the mention(s) belong to
mentionIds required	number[]	The identifiers of the deleted mentions

Example:

{
  "keywordId": 0,
  "aspectId": 0,
  "mentionIds": [
    0
  ]
}

First, format the structure to a JSON string:

{"id":0,"profileId":0,"createdBy":0,"createdByEmail":"demo@email.com","createdAtUtcMs":0,"restoredBy":null,"restoredByEmail":null,"restoredAtUtcMs":null,"mentionsDeleted":[{"keywordId":0,"aspectId":0,"mentionIds":[0]}]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /mentions/restore-many HTTP/1.1
Content-Type: application/json
Content-Length: 219

{"id":0,"profileId":0,"createdBy":0,"createdByEmail":"demo@email.com","createdAtUtcMs":0,"restoredBy":null,"restoredByEmail":null,"restoredAtUtcMs":null,"mentionsDeleted":[{"keywordId":0,"aspectId":0,"mentionIds":[0]}]}


      curl -X PATCH https://data.skema.co.id/24.04/mentions/restore-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"id":0,"profileId":0,"createdBy":0,"createdByEmail":"demo@email.com","createdAtUtcMs":0,"restoredBy":null,"restoredByEmail":null,"restoredAtUtcMs":null,"mentionsDeleted":[{"keywordId":0,"aspectId":0,"mentionIds":[0]}]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/mentions/restore-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/mentions/restore-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/mentions/restore-many"

payload = json.dumps({
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/mentions/restore-many', $headers , $body);
$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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Creating mentions

 POST /mentions

This endpoint enables clients to create mentions.

The API expects the structure below to be passed in the request body, formatted as a json string.

MentionCreationFields (struct)
Property	Type	Comment
createdAtUtcMs required	number	The creation time in milliseconds, GMT.
keywordId required	number	The identifier of the keyword this mention belongs to.
sourceId required	Source	The identifier of the source this mention belongs to.
text required	string	The contents of this mention
subSourceId required	SubSource	The identifier of the sub-source this mention belongs to. Not required in case of article, blog, forum, frontpage, document and offline source types.
url omitable	null \| string	The source url of this mention.
author omitable	null \| string	The name of the author of this mention.
aspectGroupId omitable	null \| number	The identifier of the aspect group this mention belongs to.
ownChannelId omitable	null \| number	The identifier of the own channel this mention belongs to.
reach omitable	null \| number	The number of people that have potentially seen the mention
followers omitable	null \| number	The follower number of the mention's author.
views omitable	null \| number	The count of views of this mention.
likes omitable	null \| number	The count of likes of this mention.
comments omitable	null \| number	The count of comments of this mention.
shares omitable	null \| number	The count of shares of this mention.
reviewSpecificFields omitable	null \| ReviewSpecificFields	-
facebookSpecificFields omitable	null \| FacebookSpecificFields	-
linkedinSpecificFields omitable	null \| LinkedInSpecificFields	-
twitterSpecificFields omitable	null \| TwitterSpecificFields	-

Example:

{
  "createdAtUtcMs": 0,
  "keywordId": 0,
  "sourceId": 10,
  "text": "The contents of the mention.",
  "subSourceId": null
}

Referenced entities by MentionCreationFields

ReviewSpecificFields (struct)
Property	Type	Comment
upvote omitable	null \| number	The count of upvotes on this mention.
downvote omitable	null \| number	The count of downvotes on this mention.
starRatingMax omitable	null \| number	The maximum stars one can give.
starRatingScore omitable	null \| number	The count of stars this mention got.

Example:

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

FacebookSpecificFields (struct)
Property	Type	Comment
angry omitable	null \| number	The count of angry reactions on this mention.
care omitable	null \| number	The count of care reactions on this mention.
haha omitable	null \| number	The count of haha reactions on this mention.
love omitable	null \| number	The count of love reactions on this mention.
sad omitable	null \| number	The count of sad reactions on this mention.
wow omitable	null \| number	The count of wow reactions on this mention.

Example:

{
  "angry": 0,
  "care": 0,
  "haha": 0,
  "love": 0,
  "sad": 0,
  "wow": 0
}

LinkedInSpecificFields (struct)
Property	Type	Comment
love omitable	null \| number	The count of love reactions on this mention.
funny omitable	null \| number	The count of funny reactions on this mention.
support omitable	null \| number	The count of support reactions on this mention.
curious omitable	null \| number	The count of curious reactions on this mention.
celebrate omitable	null \| number	The count of celebrate reactions on this mention.
insightful omitable	null \| number	The count of insightful reactions on this mention.

Example:

{
  "love": 0,
  "funny": 0,
  "support": 0,
  "curious": 0,
  "celebrate": 0,
  "insightful": 0
}

TwitterSpecificFields (struct)
Property	Type	Comment
retweet omitable	null \| number	The number of retweets of this mention.
reply omitable	null \| number	The number of replies of this mention.
quote omitable	null \| number	The number of quotes of this mention.

Example:

{
  "retweet": 0,
  "reply": 0,
  "quote": 0
}

SubSource (enum)
Value	Comment
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
73	Linkedin post
74	Linkedin comment
75	Linkedin reply

Source (enum)
Value	Comment
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	Other Social
16	Video
17	Tumblr
18	Twitter
25	Instagram
26	Tiktok
50	Document
57	Direct Message
72	Linkedin

First, format the structure to a JSON string:

{"createdAtUtcMs":0,"keywordId":0,"sourceId":10,"text":"The contents of the mention.","subSourceId":null}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /mentions HTTP/1.1
Content-Type: application/json
Content-Length: 105

{"createdAtUtcMs":0,"keywordId":0,"sourceId":10,"text":"The contents of the mention.","subSourceId":null}


      curl -X POST https://data.skema.co.id/24.04/mentions \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"createdAtUtcMs":0,"keywordId":0,"sourceId":10,"text":"The contents of the mention.","subSourceId":null}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "createdAtUtcMs": 0,
  "keywordId": 0,
  "sourceId": 10,
  "text": "The contents of the mention.",
  "subSourceId": null
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/mentions',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/mentions")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "createdAtUtcMs": 0,
  "keywordId": 0,
  "sourceId": 10,
  "text": "The contents of the mention.",
  "subSourceId": null
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/mentions"

payload = json.dumps({
  "createdAtUtcMs": 0,
  "keywordId": 0,
  "sourceId": 10,
  "text": "The contents of the mention.",
  "subSourceId": null
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "createdAtUtcMs": 0,
  "keywordId": 0,
  "sourceId": 10,
  "text": "The contents of the mention.",
  "subSourceId": null
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/mentions', $headers , $body);
$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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Users

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

Creating a user

 POST /users

This endpoint allows clients to create a new user.

The API expects the structure below to be passed in the request body, formatted as a json string.

UserCreationFields (struct)
Property	Type	Comment
profileId required	number	The id of the profile this user will be added to.
firstName required	string	The first name of the user
lastName required	string	The last name of the user
email required	string	The email address of the user

Example:

{
  "profileId": 0,
  "firstName": "Demo first name",
  "lastName": "Demo last name",
  "email": "demo@email.com"
}

First, format the structure to a JSON string:

{"profileId":0,"firstName":"Demo first name","lastName":"Demo last name","email":"demo@email.com"}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /users HTTP/1.1
Content-Type: application/json
Content-Length: 98

{"profileId":0,"firstName":"Demo first name","lastName":"Demo last name","email":"demo@email.com"}


      curl -X POST https://data.skema.co.id/24.04/users \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"profileId":0,"firstName":"Demo first name","lastName":"Demo last name","email":"demo@email.com"}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "profileId": 0,
  "firstName": "Demo first name",
  "lastName": "Demo last name",
  "email": "demo@email.com"
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/users',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/users")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "profileId": 0,
  "firstName": "Demo first name",
  "lastName": "Demo last name",
  "email": "demo@email.com"
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/users"

payload = json.dumps({
  "profileId": 0,
  "firstName": "Demo first name",
  "lastName": "Demo last name",
  "email": "demo@email.com"
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "profileId": 0,
  "firstName": "Demo first name",
  "lastName": "Demo last name",
  "email": "demo@email.com"
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/users', $headers , $body);
$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	User	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

User (struct)
Property	Type	Comment
id	number	The identifier of the user

Example:

{
  "id": 0
}

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

Example:

{
  "data": {
    "id": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

User (struct)
Property	Type	Comment
id	number	The identifier of the user

Example:

{
  "id": 0
}

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

Example:

{
  "data": {
    "id": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

User (struct)
Property	Type	Comment
id	number	The identifier of the user

Example:

{
  "id": 0
}

Resetting password

 PATCH /users/:userId/reset-password

Resets the password for a specific user identified by userId.


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

const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/users/:userId/reset-password',
  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.patch("https://data.skema.co.id/24.04/users/:userId/reset-password")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/users/:userId/reset-password"

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

response = requests.request("PATCH", 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('PATCH', 'https://data.skema.co.id/24.04/users/:userId/reset-password', $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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Updating user status

 PATCH /users/:userId/activation

Activate or deactivate a user.

The API expects the structure below to be passed in the request body, formatted as a json string.

ActivationRequest (struct)

Property

Type

Comment

isActive

required

boolean

User activation status

Example:

{
  "isActive": true
}

First, format the structure to a JSON string:

{"isActive":true}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /users/:userId/activation HTTP/1.1
Content-Type: application/json
Content-Length: 17

{"isActive":true}


      curl -X PATCH https://data.skema.co.id/24.04/users/:userId/activation \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"isActive":true}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "isActive": true
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/users/:userId/activation',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/users/:userId/activation")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "isActive": true
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/users/:userId/activation"

payload = json.dumps({
  "isActive": true
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "isActive": true
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/users/:userId/activation', $headers , $body);
$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	ActivationResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ActivationResponse (struct)
Property	Type	Comment
id	number	The identifier of the user
isActive	boolean	User activation status

Example:

{
  "id": 0,
  "isActive": true
}

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

Example:

{
  "data": {
    "id": 0,
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ActivationResponse (struct)
Property	Type	Comment
id	number	The identifier of the user
isActive	boolean	User activation status

Example:

{
  "id": 0,
  "isActive": true
}

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

Example:

{
  "data": {
    "id": 0,
    "isActive": true
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ActivationResponse (struct)
Property	Type	Comment
id	number	The identifier of the user
isActive	boolean	User activation status

Example:

{
  "id": 0,
  "isActive": true
}

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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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 omitable	number	Filter by a client.
profileId omitable	number	Filter by a profile.
keywordGroupId omitable	number	Filter by a keyword group.
aspectGroupId omitable	number	Filter by an aspect group.
keywordId omitable	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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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 omitable	number	The id of the country to query sources for.
keywordId omitable	number	The id of the keyword to query sources for.
aspectId omitable	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		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

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

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

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

Example:

{
  "data": [
    {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

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 omitable	number	Filter by a client.
profileId omitable	number	Filter by a profile.
keywordGroupId omitable	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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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
}

Updating a keyword

 PATCH /keywords/:keywordId

The API expects the structure below to be passed in the request body, formatted as a json string.

UpdateableKeywordFields (struct)
Property	Type	Comment
label omitable	string	A displayable name of the keyword
color omitable	string	The color of the keyword
isActive omitable	boolean	Is the keyword active or inactive?
synCheckForumTitle omitable	boolean	Tells whether mentions are to be to collected from related discussions or not
notes omitable	string \| null	-

Example:

{
  "label": "Demo keyword",
  "color": "#0099FF",
  "isActive": true,
  "synCheckForumTitle": false,
  "notes": null
}

First, format the structure to a JSON string:

{"label":"Demo keyword","color":"#0099FF","isActive":true,"synCheckForumTitle":false,"notes":null}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /keywords/:keywordId HTTP/1.1
Content-Type: application/json
Content-Length: 98

{"label":"Demo keyword","color":"#0099FF","isActive":true,"synCheckForumTitle":false,"notes":null}


      curl -X PATCH https://data.skema.co.id/24.04/keywords/:keywordId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"label":"Demo keyword","color":"#0099FF","isActive":true,"synCheckForumTitle":false,"notes":null}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "label": "Demo keyword",
  "color": "#0099FF",
  "isActive": true,
  "synCheckForumTitle": false,
  "notes": null
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/keywords/:keywordId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/keywords/:keywordId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "label": "Demo keyword",
  "color": "#0099FF",
  "isActive": true,
  "synCheckForumTitle": false,
  "notes": null
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keywords/:keywordId"

payload = json.dumps({
  "label": "Demo keyword",
  "color": "#0099FF",
  "isActive": true,
  "synCheckForumTitle": false,
  "notes": null
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "label": "Demo keyword",
  "color": "#0099FF",
  "isActive": true,
  "synCheckForumTitle": false,
  "notes": null
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/keywords/:keywordId', $headers , $body);
$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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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
}

Creating a keyword

 POST /keywords

This endpoint allows clients to create a new keyword that will be tracked within a specific group. Each keyword must have a name, a country code, and configuration options for mention collection.

The API expects the structure below to be passed in the request body, formatted as a json string.

KeywordCreationFields (struct)
Property	Type	Comment
keywordGroupId required	number	The id of the group this keyword will belong to.
keywordLabel required	string	A displayable name of the keyword
keywordCountryCode required	string	The neticle code of the country this keyword will belong to.
synCheckForumTitle required	boolean	Tells whether mentions are to be to collected from related discussions or not

Example:

{
  "keywordGroupId": 0,
  "keywordLabel": "Demo keyword",
  "keywordCountryCode": "hu",
  "synCheckForumTitle": false
}

First, format the structure to a JSON string:

{"keywordGroupId":0,"keywordLabel":"Demo keyword","keywordCountryCode":"hu","synCheckForumTitle":false}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /keywords HTTP/1.1
Content-Type: application/json
Content-Length: 103

{"keywordGroupId":0,"keywordLabel":"Demo keyword","keywordCountryCode":"hu","synCheckForumTitle":false}


      curl -X POST https://data.skema.co.id/24.04/keywords \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"keywordGroupId":0,"keywordLabel":"Demo keyword","keywordCountryCode":"hu","synCheckForumTitle":false}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "keywordGroupId": 0,
  "keywordLabel": "Demo keyword",
  "keywordCountryCode": "hu",
  "synCheckForumTitle": false
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/keywords',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/keywords")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "keywordGroupId": 0,
  "keywordLabel": "Demo keyword",
  "keywordCountryCode": "hu",
  "synCheckForumTitle": false
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keywords"

payload = json.dumps({
  "keywordGroupId": 0,
  "keywordLabel": "Demo keyword",
  "keywordCountryCode": "hu",
  "synCheckForumTitle": false
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "keywordGroupId": 0,
  "keywordLabel": "Demo keyword",
  "keywordCountryCode": "hu",
  "synCheckForumTitle": false
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/keywords', $headers , $body);
$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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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

omitable

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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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
}

Creating a profile

 POST /profiles

This endpoint allows clients to create a new profile that within a specific client.

The API expects the structure below to be passed in the request body, formatted as a json string.

ProfileCreationFields (struct)

Property

Type

Comment

clientId

required

number

The id of the client this profile will belong to.

label

required

string

A displayable name of the profile

Example:

{
  "clientId": 0,
  "label": "Demo profile"
}

First, format the structure to a JSON string:

{"clientId":0,"label":"Demo profile"}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /profiles HTTP/1.1
Content-Type: application/json
Content-Length: 37

{"clientId":0,"label":"Demo profile"}


      curl -X POST https://data.skema.co.id/24.04/profiles \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"clientId":0,"label":"Demo profile"}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "clientId": 0,
  "label": "Demo profile"
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/profiles',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/profiles")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "clientId": 0,
  "label": "Demo profile"
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/profiles"

payload = json.dumps({
  "clientId": 0,
  "label": "Demo profile"
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "clientId": 0,
  "label": "Demo profile"
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/profiles', $headers , $body);
$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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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
}

Updating a profile

 PATCH /profiles/:profileId

The API expects the structure below to be passed in the request body, formatted as a json string.

UpdateableProfileFields (struct)

Property

Type

Comment

label

omitable

string

A displayable name of the profile

isActive

omitable

boolean

Is the profile active or inactive?

Example:

{
  "label": "Demo profile",
  "isActive": true
}

First, format the structure to a JSON string:

{"label":"Demo profile","isActive":true}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /profiles/:profileId HTTP/1.1
Content-Type: application/json
Content-Length: 40

{"label":"Demo profile","isActive":true}


      curl -X PATCH https://data.skema.co.id/24.04/profiles/:profileId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"label":"Demo profile","isActive":true}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "label": "Demo profile",
  "isActive": true
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/profiles/:profileId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/profiles/:profileId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "label": "Demo profile",
  "isActive": true
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/profiles/:profileId"

payload = json.dumps({
  "label": "Demo profile",
  "isActive": true
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "label": "Demo profile",
  "isActive": true
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/profiles/:profileId', $headers , $body);
$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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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		Any model/infromation related to the data.
error		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
}

Adding user

 POST /profiles/:profileId/users

Add (associate) an existing user to a given profile.

The API expects the structure below to be passed in the request body, formatted as a json string.

CreateProfileAssociationFields (struct)

Property

Type

Comment

userId

required

number

The id of the user to be added to this profile.

Example:

{
  "userId": 0
}

First, format the structure to a JSON string:

{"userId":0}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /profiles/:profileId/users HTTP/1.1
Content-Type: application/json
Content-Length: 12

{"userId":0}


      curl -X POST https://data.skema.co.id/24.04/profiles/:profileId/users \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"userId":0}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "userId": 0
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/profiles/:profileId/users',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/profiles/:profileId/users")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "userId": 0
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/profiles/:profileId/users"

payload = json.dumps({
  "userId": 0
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "userId": 0
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/profiles/:profileId/users', $headers , $body);
$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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Removing user

 DELETE /profiles/:profileId/users/:userId

Removes a user from a profile.


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

const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/profiles/:profileId/users/:userId',
  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.delete("https://data.skema.co.id/24.04/profiles/:profileId/users/:userId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

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

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

response = requests.request("DELETE", 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('DELETE', 'https://data.skema.co.id/24.04/profiles/:profileId/users/:userId', $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		The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

Example:

{
  "data": null,
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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

omitable

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 omitable	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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin reply

InsightPresentation (struct)
Property	Type	Comment
currentPage omitable	number	Controls from which page the result set will be returned Default: `1`
numberOfValues omitable	number	The number of mentions per page Default: `100`
includeResourceMap omitable	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		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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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		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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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		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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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": ""
}

Languages

Provides an interface to list valid languages in our system.

Listing languages

 GET /languages


      curl -G https://data.skema.co.id/24.04/languages \
    -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/languages',
  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/languages")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

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

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/languages', $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	Language[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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

Example:

{
  "data": [
    {
      "id": 0,
      "label": "Ukrainian",
      "isoCode2": "uk",
      "neticleCode": "ua"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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 omitable	number	Filter by a client.
profileId omitable	number	Filter by a profile.
keywordGroupId omitable	number	Filter by a keyword group.
aspectGroupId omitable	number	Filter by an aspect group.
keywordId omitable	number	Filter by a keyword.
aspectId omitable	string	Filter by an aspect.
presentation omitable	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

omitable

boolean

Toggles whether the response should include the invalid resources.

Default:

false

includeResourceMap

omitable

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		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 keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

ResourcesMeta (struct)
Property	Type	Comment
relatedResources	null \| RelatedResourceMap	When enabled, contains lookup maps to referenced resource models.

Example:

{
  "relatedResources": null
}

Referenced entities by ResourcesMeta

RelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	A lookup map from source id to source model.
countries	Record<number, Country>	A lookup map from country id to country model.

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": null
    }
  },
  "countries": {
    "0": {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  }
}

Referenced entities by RelatedResourceMap

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

ApiPayload (struct)
Property	Type	Comment
data	Resources	The resource model(s).
meta	ResourcesMeta	Any model/infromation related to the data.
error		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 keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

ResourcesMeta (struct)
Property	Type	Comment
relatedResources	null \| RelatedResourceMap	When enabled, contains lookup maps to referenced resource models.

Example:

{
  "relatedResources": null
}

Referenced entities by ResourcesMeta

RelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	A lookup map from source id to source model.
countries	Record<number, Country>	A lookup map from country id to country model.

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": null
    }
  },
  "countries": {
    "0": {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  }
}

Referenced entities by RelatedResourceMap

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

ApiPayload (struct)
Property	Type	Comment
data	Resources	The resource model(s).
meta	ResourcesMeta	Any model/infromation related to the data.
error		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 keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

ResourcesMeta (struct)
Property	Type	Comment
relatedResources	null \| RelatedResourceMap	When enabled, contains lookup maps to referenced resource models.

Example:

{
  "relatedResources": null
}

Referenced entities by ResourcesMeta

RelatedResourceMap (struct)
Property	Type	Comment
sources	Record<number, Source>	A lookup map from source id to source model.
countries	Record<number, Country>	A lookup map from country id to country model.

Example:

{
  "sources": {
    "6": {
      "id": 6,
      "name": "forum",
      "order": 5,
      "color": "#9F20C1",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": null
    }
  },
  "countries": {
    "0": {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  }
}

Referenced entities by RelatedResourceMap

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

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

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

Countries

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

Listing countries

 GET /countries


      curl -G https://data.skema.co.id/24.04/countries \
    -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/countries',
  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/countries")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

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

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/countries', $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	Country[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "label": "United Kingdom",
      "isoCode2": "gb",
      "neticleCode": "uk",
      "ianaTimeZone": "Europe/London",
      "ianaLanguages": [
        "en"
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

Finding a single country

 GET /countries/:countryId


      curl -G https://data.skema.co.id/24.04/countries/:countryId \
    -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/countries/:countryId',
  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/countries/:countryId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

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

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/countries/:countryId', $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	Country	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "label": "United Kingdom",
    "isoCode2": "gb",
    "neticleCode": "uk",
    "ianaTimeZone": "Europe/London",
    "ianaLanguages": [
      "en"
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

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

Example:

{
  "data": {
    "id": 0,
    "label": "United Kingdom",
    "isoCode2": "gb",
    "neticleCode": "uk",
    "ianaTimeZone": "Europe/London",
    "ianaLanguages": [
      "en"
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

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

Example:

{
  "data": {
    "id": 0,
    "label": "United Kingdom",
    "isoCode2": "gb",
    "neticleCode": "uk",
    "ianaTimeZone": "Europe/London",
    "ianaLanguages": [
      "en"
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Country (struct)
Property	Type	Comment
id	number	The identifier of the country
label	string	A displayable name of the country
isoCode2	string	The 2-letter ISO code of the country
neticleCode	string	An internal code for the country
ianaTimeZone	string	The IANA time zone this client belongs to.
ianaLanguages	string[]	The language codes the country uses, ordered by priority.

Example:

{
  "id": 0,
  "label": "United Kingdom",
  "isoCode2": "gb",
  "neticleCode": "uk",
  "ianaTimeZone": "Europe/London",
  "ianaLanguages": [
    "en"
  ]
}

Aggregations

Provides an interface to interact with the aggregations of the given mentions.

KPIs

 GET /mentions/aggregation/kpis

This is an endpoint that will return the KPIs for every keyword and/or aspect you specify in the filter structure.

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

Filters (struct)

Property

Type

Comment

filters

required

ViewFilter

A structure that influences the multiplicity of the results.

Example:

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

Referenced entities by Filters

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 omitable	IntervalFilter	The timestamps to search beween. Default:last 7 days (start: start of \`current day - 7 days\` day, end: end of the current day) The maximum allowed time interval is 30 days.
sources omitable	SourceGroup[]	Filters between the content sources. Default: `[1]`
genders omitable	GenderGroup[]	Filters for the gender of the author. Default: `[1]`
polarities omitable	PolarityGroup[]	Filters for sentiment between the results. Default: `[1]`
filterLanguages omitable	number[]	Filters for the language of the mention. Default: `[]`
excludeLanguages omitable	number[]	Excludes mentions with the given languages. Default: `[]`
filterPersons omitable	number[][]	Filters for mentions with the given persons. Default: `[]`
excludePersons omitable	number[][]	Excludes mentions with the given persons. Default: `[]`
filterCities omitable	number[]	Filters for the city of the mention. Default: `[]`
filterRegions omitable	number[]	Filters for the region of the mention. Default: `[]`
excludeRegions omitable	number[]	Excludes mentions with the given regions. Default: `[]`
excludeCities omitable	number[]	Excludes mentions with the given cities. Default: `[]`
filterOwnChannels omitable	number[]	Filters for mentions for the given own channels. Default: `[]`
excludeOwnChannels omitable	number[]	Excludes mentions belonging to the given own channels. Default: `[]`
filterTags omitable	number[][]	Filters for mentions with the given tags. Default: `[]`
excludeTags omitable	number[][]	Excludes mentions with the given tags. Default: `[]`
excludeSources omitable	SourceGroup[]	Excludes mentions with the given source types. Default: `[]`
numeric omitable	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count. Default: `[]`
filterPhrases omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
excludePhrases omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
filterTitles omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
excludeTitles omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
filterUrls omitable	ConditionFilterDetails	Filters mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
excludeUrls omitable	ConditionFilterDetails	Excludes mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
filterDomains omitable	ConditionFilterDetails	Filters mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
excludeDomains omitable	ConditionFilterDetails	Excludes mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
filterAuthors omitable	ConditionFilterDetails	Filters mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`
excludeAuthors omitable	ConditionFilterDetails	Excludes mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`

Example:

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

Referenced entities by ViewFilter

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 omitable	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)

Property Type Comment

values

required

string[][]

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

matchingType

omitable

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

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/aggregation/kpis?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002


      curl -G https://data.skema.co.id/24.04/mentions/aggregation/kpis \
    -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/aggregation/kpis?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/aggregation/kpis?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/aggregation/kpis?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/aggregation/kpis?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	KPIs	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "sumCount": 0,
    "sumReach": 0,
    "sumInteractions": 0,
    "sumPolarityIndex": 0,
    "bySources": {},
    "bySubSources": {},
    "byPolarities": {}
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KPIs (struct)
Property	Type	Comment
sumCount	number	The number of mentions in total that satisfied the filter conditions
sumReach	number	The sum of the mentions' reach values
sumInteractions	number	The sum of the mentions' interactions
sumPolarityIndex	number	The sum of the mentions' polarity indexes
bySources	Record<SourceGroup, AggregationDetails>	KPIs by source types
bySubSources	Record<SourceGroup, AggregationDetails>	KPIs by sub source types
byPolarities	Record<PolarityGroup, AggregationDetails>	KPIs by polarity types

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumInteractions": 0,
  "sumPolarityIndex": 0,
  "bySources": {},
  "bySubSources": {},
  "byPolarities": {}
}

Referenced entities by KPIs

AggregationDetails (struct)
Property	Type	Comment
sumCount	number	The total number of mentions
sumReach	number	The sum of the mentions' reach values
sumPolarityIndex	number	The sum of the mentions' polarity indexes

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumPolarityIndex": 0
}

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin reply

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

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

Example:

{
  "data": {
    "sumCount": 0,
    "sumReach": 0,
    "sumInteractions": 0,
    "sumPolarityIndex": 0,
    "bySources": {},
    "bySubSources": {},
    "byPolarities": {}
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KPIs (struct)
Property	Type	Comment
sumCount	number	The number of mentions in total that satisfied the filter conditions
sumReach	number	The sum of the mentions' reach values
sumInteractions	number	The sum of the mentions' interactions
sumPolarityIndex	number	The sum of the mentions' polarity indexes
bySources	Record<SourceGroup, AggregationDetails>	KPIs by source types
bySubSources	Record<SourceGroup, AggregationDetails>	KPIs by sub source types
byPolarities	Record<PolarityGroup, AggregationDetails>	KPIs by polarity types

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumInteractions": 0,
  "sumPolarityIndex": 0,
  "bySources": {},
  "bySubSources": {},
  "byPolarities": {}
}

Referenced entities by KPIs

AggregationDetails (struct)
Property	Type	Comment
sumCount	number	The total number of mentions
sumReach	number	The sum of the mentions' reach values
sumPolarityIndex	number	The sum of the mentions' polarity indexes

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumPolarityIndex": 0
}

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin reply

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

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

Example:

{
  "data": {
    "sumCount": 0,
    "sumReach": 0,
    "sumInteractions": 0,
    "sumPolarityIndex": 0,
    "bySources": {},
    "bySubSources": {},
    "byPolarities": {}
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KPIs (struct)
Property	Type	Comment
sumCount	number	The number of mentions in total that satisfied the filter conditions
sumReach	number	The sum of the mentions' reach values
sumInteractions	number	The sum of the mentions' interactions
sumPolarityIndex	number	The sum of the mentions' polarity indexes
bySources	Record<SourceGroup, AggregationDetails>	KPIs by source types
bySubSources	Record<SourceGroup, AggregationDetails>	KPIs by sub source types
byPolarities	Record<PolarityGroup, AggregationDetails>	KPIs by polarity types

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumInteractions": 0,
  "sumPolarityIndex": 0,
  "bySources": {},
  "bySubSources": {},
  "byPolarities": {}
}

Referenced entities by KPIs

AggregationDetails (struct)
Property	Type	Comment
sumCount	number	The total number of mentions
sumReach	number	The sum of the mentions' reach values
sumPolarityIndex	number	The sum of the mentions' polarity indexes

Example:

{
  "sumCount": 0,
  "sumReach": 0,
  "sumPolarityIndex": 0
}

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin reply

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

Interactions

 GET /mentions/aggregation/interactions

This is an endpoint that will return the interactions for every keyword and/or aspect you specify in the filter structure.

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

Filters (struct)

Property

Type

Comment

filters

required

ViewFilter

A structure that influences the multiplicity of the results.

Example:

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

Referenced entities by Filters

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 omitable	IntervalFilter	The timestamps to search beween. Default:last 7 days (start: start of \`current day - 7 days\` day, end: end of the current day) The maximum allowed time interval is 30 days.
sources omitable	SourceGroup[]	Filters between the content sources. Default: `[1]`
genders omitable	GenderGroup[]	Filters for the gender of the author. Default: `[1]`
polarities omitable	PolarityGroup[]	Filters for sentiment between the results. Default: `[1]`
filterLanguages omitable	number[]	Filters for the language of the mention. Default: `[]`
excludeLanguages omitable	number[]	Excludes mentions with the given languages. Default: `[]`
filterPersons omitable	number[][]	Filters for mentions with the given persons. Default: `[]`
excludePersons omitable	number[][]	Excludes mentions with the given persons. Default: `[]`
filterCities omitable	number[]	Filters for the city of the mention. Default: `[]`
filterRegions omitable	number[]	Filters for the region of the mention. Default: `[]`
excludeRegions omitable	number[]	Excludes mentions with the given regions. Default: `[]`
excludeCities omitable	number[]	Excludes mentions with the given cities. Default: `[]`
filterOwnChannels omitable	number[]	Filters for mentions for the given own channels. Default: `[]`
excludeOwnChannels omitable	number[]	Excludes mentions belonging to the given own channels. Default: `[]`
filterTags omitable	number[][]	Filters for mentions with the given tags. Default: `[]`
excludeTags omitable	number[][]	Excludes mentions with the given tags. Default: `[]`
excludeSources omitable	SourceGroup[]	Excludes mentions with the given source types. Default: `[]`
numeric omitable	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count. Default: `[]`
filterPhrases omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
excludePhrases omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
filterTitles omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
excludeTitles omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
filterUrls omitable	ConditionFilterDetails	Filters mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
excludeUrls omitable	ConditionFilterDetails	Excludes mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
filterDomains omitable	ConditionFilterDetails	Filters mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
excludeDomains omitable	ConditionFilterDetails	Excludes mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
filterAuthors omitable	ConditionFilterDetails	Filters mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`
excludeAuthors omitable	ConditionFilterDetails	Excludes mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`

Example:

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

Referenced entities by ViewFilter

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 omitable	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)

Property Type Comment

values

required

string[][]

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

matchingType

omitable

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

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/aggregation/interactions?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002


      curl -G https://data.skema.co.id/24.04/mentions/aggregation/interactions \
    -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/aggregation/interactions?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/aggregation/interactions?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/aggregation/interactions?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/aggregation/interactions?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	InteractionAggregation	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "sumFbLikes": 0,
    "sumFbReplies": 0,
    "sumFbShares": 0,
    "sumFbComments": 0,
    "sumFbSads": 0,
    "sumFbWows": 0,
    "sumFbCares": 0,
    "sumFbHahas": 0,
    "sumFbLoves": 0,
    "sumFbAngries": 0,
    "sumIgLikes": 0,
    "sumIgScores": 0,
    "sumIgComments": 0,
    "sumTwLikes": 0,
    "sumTwComments": 0,
    "sumTwRetweets": 0,
    "sumYtLikes": 0,
    "sumYtComments": 0,
    "sumYtDislikes": 0,
    "sumTtLikes": 0,
    "sumTtShares": 0,
    "sumPiLikes": 0,
    "sumReviewUpvotes": 0,
    "sumReviewDownvotes": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

InteractionAggregation (struct)
Property	Type	Comment
sumFbLikes	number	The sum of Facebook likes
sumFbReplies	number	The sum of Facebook replies
sumFbShares	number	The sum of Facebook shares
sumFbComments	number	The sum of Facebook comments
sumFbSads	number	The sum of Facebook sad reactions
sumFbWows	number	The sum of Facebook wow reactions
sumFbCares	number	The sum of Facebook care reactions
sumFbHahas	number	The sum of Facebook haha reactions
sumFbLoves	number	The sum of Facebook love reactions
sumFbAngries	number	The sum of Facebook angry reactions
sumIgLikes	number	The sum of Instagram likes
sumIgScores	number	The sum of Instagram scores
sumIgComments	number	The sum of Instagram comments
sumTwLikes	number	The sum of Twitter likes
sumTwComments	number	The sum of Twitter comments
sumTwRetweets	number	The sum of Twitter retweets
sumYtLikes	number	The sum of Youtube likes
sumYtComments	number	The sum of Youtube comments
sumYtDislikes	number	The sum of Youtube dislikes
sumTtLikes	number	The sum of Tiktok likes
sumTtShares	number	The sum of Tiktok shares
sumPiLikes	number	The sum of Pinterest likes
sumReviewUpvotes	number	The sum of review upvotes
sumReviewDownvotes	number	The sum of review downvotes

Example:

{
  "sumFbLikes": 0,
  "sumFbReplies": 0,
  "sumFbShares": 0,
  "sumFbComments": 0,
  "sumFbSads": 0,
  "sumFbWows": 0,
  "sumFbCares": 0,
  "sumFbHahas": 0,
  "sumFbLoves": 0,
  "sumFbAngries": 0,
  "sumIgLikes": 0,
  "sumIgScores": 0,
  "sumIgComments": 0,
  "sumTwLikes": 0,
  "sumTwComments": 0,
  "sumTwRetweets": 0,
  "sumYtLikes": 0,
  "sumYtComments": 0,
  "sumYtDislikes": 0,
  "sumTtLikes": 0,
  "sumTtShares": 0,
  "sumPiLikes": 0,
  "sumReviewUpvotes": 0,
  "sumReviewDownvotes": 0
}

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

Example:

{
  "data": {
    "sumFbLikes": 0,
    "sumFbReplies": 0,
    "sumFbShares": 0,
    "sumFbComments": 0,
    "sumFbSads": 0,
    "sumFbWows": 0,
    "sumFbCares": 0,
    "sumFbHahas": 0,
    "sumFbLoves": 0,
    "sumFbAngries": 0,
    "sumIgLikes": 0,
    "sumIgScores": 0,
    "sumIgComments": 0,
    "sumTwLikes": 0,
    "sumTwComments": 0,
    "sumTwRetweets": 0,
    "sumYtLikes": 0,
    "sumYtComments": 0,
    "sumYtDislikes": 0,
    "sumTtLikes": 0,
    "sumTtShares": 0,
    "sumPiLikes": 0,
    "sumReviewUpvotes": 0,
    "sumReviewDownvotes": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

InteractionAggregation (struct)
Property	Type	Comment
sumFbLikes	number	The sum of Facebook likes
sumFbReplies	number	The sum of Facebook replies
sumFbShares	number	The sum of Facebook shares
sumFbComments	number	The sum of Facebook comments
sumFbSads	number	The sum of Facebook sad reactions
sumFbWows	number	The sum of Facebook wow reactions
sumFbCares	number	The sum of Facebook care reactions
sumFbHahas	number	The sum of Facebook haha reactions
sumFbLoves	number	The sum of Facebook love reactions
sumFbAngries	number	The sum of Facebook angry reactions
sumIgLikes	number	The sum of Instagram likes
sumIgScores	number	The sum of Instagram scores
sumIgComments	number	The sum of Instagram comments
sumTwLikes	number	The sum of Twitter likes
sumTwComments	number	The sum of Twitter comments
sumTwRetweets	number	The sum of Twitter retweets
sumYtLikes	number	The sum of Youtube likes
sumYtComments	number	The sum of Youtube comments
sumYtDislikes	number	The sum of Youtube dislikes
sumTtLikes	number	The sum of Tiktok likes
sumTtShares	number	The sum of Tiktok shares
sumPiLikes	number	The sum of Pinterest likes
sumReviewUpvotes	number	The sum of review upvotes
sumReviewDownvotes	number	The sum of review downvotes

Example:

{
  "sumFbLikes": 0,
  "sumFbReplies": 0,
  "sumFbShares": 0,
  "sumFbComments": 0,
  "sumFbSads": 0,
  "sumFbWows": 0,
  "sumFbCares": 0,
  "sumFbHahas": 0,
  "sumFbLoves": 0,
  "sumFbAngries": 0,
  "sumIgLikes": 0,
  "sumIgScores": 0,
  "sumIgComments": 0,
  "sumTwLikes": 0,
  "sumTwComments": 0,
  "sumTwRetweets": 0,
  "sumYtLikes": 0,
  "sumYtComments": 0,
  "sumYtDislikes": 0,
  "sumTtLikes": 0,
  "sumTtShares": 0,
  "sumPiLikes": 0,
  "sumReviewUpvotes": 0,
  "sumReviewDownvotes": 0
}

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

Example:

{
  "data": {
    "sumFbLikes": 0,
    "sumFbReplies": 0,
    "sumFbShares": 0,
    "sumFbComments": 0,
    "sumFbSads": 0,
    "sumFbWows": 0,
    "sumFbCares": 0,
    "sumFbHahas": 0,
    "sumFbLoves": 0,
    "sumFbAngries": 0,
    "sumIgLikes": 0,
    "sumIgScores": 0,
    "sumIgComments": 0,
    "sumTwLikes": 0,
    "sumTwComments": 0,
    "sumTwRetweets": 0,
    "sumYtLikes": 0,
    "sumYtComments": 0,
    "sumYtDislikes": 0,
    "sumTtLikes": 0,
    "sumTtShares": 0,
    "sumPiLikes": 0,
    "sumReviewUpvotes": 0,
    "sumReviewDownvotes": 0
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

InteractionAggregation (struct)
Property	Type	Comment
sumFbLikes	number	The sum of Facebook likes
sumFbReplies	number	The sum of Facebook replies
sumFbShares	number	The sum of Facebook shares
sumFbComments	number	The sum of Facebook comments
sumFbSads	number	The sum of Facebook sad reactions
sumFbWows	number	The sum of Facebook wow reactions
sumFbCares	number	The sum of Facebook care reactions
sumFbHahas	number	The sum of Facebook haha reactions
sumFbLoves	number	The sum of Facebook love reactions
sumFbAngries	number	The sum of Facebook angry reactions
sumIgLikes	number	The sum of Instagram likes
sumIgScores	number	The sum of Instagram scores
sumIgComments	number	The sum of Instagram comments
sumTwLikes	number	The sum of Twitter likes
sumTwComments	number	The sum of Twitter comments
sumTwRetweets	number	The sum of Twitter retweets
sumYtLikes	number	The sum of Youtube likes
sumYtComments	number	The sum of Youtube comments
sumYtDislikes	number	The sum of Youtube dislikes
sumTtLikes	number	The sum of Tiktok likes
sumTtShares	number	The sum of Tiktok shares
sumPiLikes	number	The sum of Pinterest likes
sumReviewUpvotes	number	The sum of review upvotes
sumReviewDownvotes	number	The sum of review downvotes

Example:

{
  "sumFbLikes": 0,
  "sumFbReplies": 0,
  "sumFbShares": 0,
  "sumFbComments": 0,
  "sumFbSads": 0,
  "sumFbWows": 0,
  "sumFbCares": 0,
  "sumFbHahas": 0,
  "sumFbLoves": 0,
  "sumFbAngries": 0,
  "sumIgLikes": 0,
  "sumIgScores": 0,
  "sumIgComments": 0,
  "sumTwLikes": 0,
  "sumTwComments": 0,
  "sumTwRetweets": 0,
  "sumYtLikes": 0,
  "sumYtComments": 0,
  "sumYtDislikes": 0,
  "sumTtLikes": 0,
  "sumTtShares": 0,
  "sumPiLikes": 0,
  "sumReviewUpvotes": 0,
  "sumReviewDownvotes": 0
}

Own channels

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

Listing own channels

 GET /own-channels

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 omitable	number	Filter by a client.
profileId omitable	number	Filter by a profile.
keywordGroupId omitable	number	Filter by a keyword group.
keywordId omitable	number	Filter by a keyword.

Example:

{
  "clientId": 0,
  "profileId": 0,
  "keywordGroupId": 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&keywordId=0

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

/own-channels?clientId=0&profileId=0&keywordGroupId=0&keywordId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/own-channels?clientId=0&profileId=0&keywordGroupId=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/own-channels?clientId=0&profileId=0&keywordGroupId=0&keywordId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/own-channels?clientId=0&profileId=0&keywordGroupId=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/own-channels?clientId=0&profileId=0&keywordGroupId=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	OwnChannel[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "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"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": [
    {
      "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"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": [
    {
      "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"
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

Finding a single own channel

 GET /own-channels/:ownChannelId


      curl -G https://data.skema.co.id/24.04/own-channels/:ownChannelId \
    -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/own-channels/:ownChannelId',
  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/own-channels/:ownChannelId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/own-channels/:ownChannelId"

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/own-channels/:ownChannelId', $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	OwnChannel	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

Creating own channels

 POST /own-channels

Creates an own channel for a given keyword.

Please follow the rules below for each own channel type when providing a channelId:

Facebook Page: www.facebook.com/pagename/
Forum: forum’s URL
Google Play App: In case of googleplay_app please enter the whole URL.
Huawei App Gallery: In case of huawei_app please enter the whole URL.
App store: In case of appstore_app please enter the whole URL.
Instagram: In case of Instagram, please enter the whole URL.
Tiktok: In case of a TikTok page, please enter the whole URL.
Twitter: In case of Twitter, please enter the whole URL.
URL: enter the whole URL
User: enter the page’s link that user is for and in this case only the user will be added.
YouTube channel: In case of yt_channel please enter the whole URL. To get the proper channel ID for a youtube channel you can use this website.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /own-channels?keywordId=123)

PartialOwnChannel (struct)
Property	Type	Comment
type required	OwnChannelType	The type of the own channel.
channelId required	string	The channel's identifier on its original source.
channelName required	string	The name of the channel.

Example:

{
  "type": "google_location",
  "channelId": "18120169027748581498",
  "channelName": "Location#1"
}

Referenced entities by PartialOwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

First, format the structure to a JSON string:

{"type":"google_location","channelId":"18120169027748581498","channelName":"Location#1"}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /own-channels HTTP/1.1
Content-Type: application/json
Content-Length: 88

{"type":"google_location","channelId":"18120169027748581498","channelName":"Location#1"}


      curl -X POST https://data.skema.co.id/24.04/own-channels \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"type":"google_location","channelId":"18120169027748581498","channelName":"Location#1"}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "type": "google_location",
  "channelId": "18120169027748581498",
  "channelName": "Location#1"
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/own-channels',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/own-channels")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "type": "google_location",
  "channelId": "18120169027748581498",
  "channelName": "Location#1"
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/own-channels"

payload = json.dumps({
  "type": "google_location",
  "channelId": "18120169027748581498",
  "channelName": "Location#1"
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "type": "google_location",
  "channelId": "18120169027748581498",
  "channelName": "Location#1"
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/own-channels', $headers , $body);
$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	OwnChannel	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

Deleting an own channel

 DELETE /own-channels/:ownChannelId

Deletes a specific own channel associated with a keyword.

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

keywordId

required

number

Filter by a keyword.

Example:

{
  "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!):

keywordId=0

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

/own-channels/:ownchannelid?keywordId=0


      curl -X DELETE https://data.skema.co.id/24.04/own-channels/:ownChannelId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -d 'keywordId=0'
  
      const axios = require('axios');

const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/own-channels/:ownChannelId?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.delete("https://data.skema.co.id/24.04/own-channels/:ownChannelId?keywordId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/own-channels/:ownChannelId?keywordId=0"

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

response = requests.request("DELETE", 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('DELETE', 'https://data.skema.co.id/24.04/own-channels/:ownChannelId?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	OwnChannel	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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

Example:

{
  "data": {
    "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"
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

Aspect Groups

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

Listing aspect groups

 GET /aspect-groups

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 omitable	number	Filter by a client.
profileId omitable	number	Filter by a profile.
keywordGroupId omitable	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):

/aspect-groups?clientId=0&profileId=0&keywordGroupId=0


      curl -G https://data.skema.co.id/24.04/aspect-groups \
    -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/aspect-groups?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/aspect-groups?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/aspect-groups?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/aspect-groups?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	AspectGroup[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "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
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": [
    {
      "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
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": [
    {
      "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
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

Finding a single aspect group

 GET /aspect-groups/:aspectId


      curl -G https://data.skema.co.id/24.04/aspect-groups/: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/aspect-groups/: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/aspect-groups/:aspectId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/aspect-groups/: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/aspect-groups/: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	AspectGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

Creating an aspect group

 POST /aspect-groups

This endpoint allows clients to create a new aspect group that will be tracked within a specific keyword group.

The API expects the structure below to be passed in the request body, formatted as a json string.

AspectGroupCreationFields (struct)

Property

Type

Comment

keywordGroupId

required

number

The id of the group this keyword will belong to.

label

required

string

A displayable name of the aspect group

Example:

{
  "keywordGroupId": 0,
  "label": "Demo aspect group"
}

First, format the structure to a JSON string:

{"keywordGroupId":0,"label":"Demo aspect group"}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /aspect-groups HTTP/1.1
Content-Type: application/json
Content-Length: 48

{"keywordGroupId":0,"label":"Demo aspect group"}


      curl -X POST https://data.skema.co.id/24.04/aspect-groups \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"keywordGroupId":0,"label":"Demo aspect group"}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "keywordGroupId": 0,
  "label": "Demo aspect group"
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/aspect-groups',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/aspect-groups")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "keywordGroupId": 0,
  "label": "Demo aspect group"
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/aspect-groups"

payload = json.dumps({
  "keywordGroupId": 0,
  "label": "Demo aspect group"
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "keywordGroupId": 0,
  "label": "Demo aspect group"
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/aspect-groups', $headers , $body);
$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	AspectGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

Updating an aspect group

 PATCH /aspect-groups/:aspectGroupId

The API expects the structure below to be passed in the request body, formatted as a json string.

UpdateableAspectGroupFields (struct)

Property

Type

Comment

label

omitable

string

A displayable name of the keyword

isActive

omitable

boolean

Is the keyword active or inactive?

Example:

{
  "label": "Demo keyword",
  "isActive": true
}

First, format the structure to a JSON string:

{"label":"Demo keyword","isActive":true}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /aspect-groups/:aspectGroupId HTTP/1.1
Content-Type: application/json
Content-Length: 40

{"label":"Demo keyword","isActive":true}


      curl -X PATCH https://data.skema.co.id/24.04/aspect-groups/:aspectGroupId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"label":"Demo keyword","isActive":true}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "label": "Demo keyword",
  "isActive": true
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/aspect-groups/:aspectGroupId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/aspect-groups/:aspectGroupId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "label": "Demo keyword",
  "isActive": true
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/aspect-groups/:aspectGroupId"

payload = json.dumps({
  "label": "Demo keyword",
  "isActive": true
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "label": "Demo keyword",
  "isActive": true
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/aspect-groups/:aspectGroupId', $headers , $body);
$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	AspectGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

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

Example:

{
  "data": {
    "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
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

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
}

Keyword Groups

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

Listing keyword groups

 GET /keyword-groups

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

omitable

number

Filter by a client.

profileId

omitable

number

Filter by a profile.

Example:

{
  "clientId": 0,
  "profileId": 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

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

/keyword-groups?clientId=0&profileId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/keyword-groups?clientId=0&profileId=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/keyword-groups?clientId=0&profileId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keyword-groups?clientId=0&profileId=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/keyword-groups?clientId=0&profileId=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	KeywordGroup[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": [
    {
      "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": [
    {
      "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

Finding a single keyword group

 GET /keyword-groups/:keywordGroupId


      curl -G https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId \
    -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/keyword-groups/:keywordGroupId',
  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/keyword-groups/:keywordGroupId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId"

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/keyword-groups/:keywordGroupId', $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	KeywordGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

Creating a keyword group

 POST /keyword-groups

This endpoint allows clients to create a new keyword group that will be tracked within a specific profile.

The API expects the structure below to be passed in the request body, formatted as a json string.

KeywordGroupCreationFields (struct)

Property

Type

Comment

profileId

required

number

The id of the profile this keyword group will belong to.

label

required

string

A displayable name of the keyword group

Example:

{
  "profileId": 0,
  "label": "Demo keyword group"
}

First, format the structure to a JSON string:

{"profileId":0,"label":"Demo keyword group"}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /keyword-groups HTTP/1.1
Content-Type: application/json
Content-Length: 44

{"profileId":0,"label":"Demo keyword group"}


      curl -X POST https://data.skema.co.id/24.04/keyword-groups \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"profileId":0,"label":"Demo keyword group"}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "profileId": 0,
  "label": "Demo keyword group"
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/keyword-groups',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/keyword-groups")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "profileId": 0,
  "label": "Demo keyword group"
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keyword-groups"

payload = json.dumps({
  "profileId": 0,
  "label": "Demo keyword group"
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "profileId": 0,
  "label": "Demo keyword group"
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/keyword-groups', $headers , $body);
$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	KeywordGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

Updating a keyword group

 PATCH /keyword-groups/:keywordGroupId

The API expects the structure below to be passed in the request body, formatted as a json string.

UpdateableKeywordGroupFields (struct)

Property

Type

Comment

label

omitable

string

A displayable name of the keyword group

isActive

omitable

boolean

Is the keyword group active or inactive?

Example:

{
  "label": "Demo keyword group",
  "isActive": true
}

First, format the structure to a JSON string:

{"label":"Demo keyword group","isActive":true}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

PATCH /keyword-groups/:keywordGroupId HTTP/1.1
Content-Type: application/json
Content-Length: 46

{"label":"Demo keyword group","isActive":true}


      curl -X PATCH https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"label":"Demo keyword group","isActive":true}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "label": "Demo keyword group",
  "isActive": true
})
const config = {
  method: 'patch',
  url: 'https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.patch("https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "label": "Demo keyword group",
  "isActive": true
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId"

payload = json.dumps({
  "label": "Demo keyword group",
  "isActive": true
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "label": "Demo keyword group",
  "isActive": true
}'
$request = new Request('PATCH', 'https://data.skema.co.id/24.04/keyword-groups/:keywordGroupId', $headers , $body);
$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	KeywordGroup	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

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

Example:

{
  "data": {
    "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": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordGroup (struct)
Property	Type	Comment
id	number	The identifier of the keyword group
label	string	A displayable name of the keyword group
profileId	number	The id of the profile this keyword group belongs to.
clientId	number	The id of the client this keyword group belongs to.
countryId	number	The id of the country this keyword group belongs to.
ianaTimeZone	string	The IANA time zone this keyword 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 keyword group
createdAtUtcMs	number	The creation time in milliseconds, GMT
createdBy	number	The identifier of the user who created the keyword group

Example:

{
  "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
}

Keyword filters

Provides an interface to interact with the filters of the keywords stored in our databases.

Listing keyword filters

 GET /keyword-filters

This endpoint returns a list of filter words linked to a given keyword.

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

keywordId

required

number

Filter by a keyword.

Example:

{
  "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!):

keywordId=0

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

/keyword-filters?keywordId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/keyword-filters?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/keyword-filters?keywordId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keyword-filters?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/keyword-filters?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	KeywordFilter[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "filter": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordFilter (struct)
Property	Type	Comment
id	number	The identifier of the keyword filter
filter	string	The filter
keywordId	number	The identifier of the keyword this filter belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this filter belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "filter": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "filter": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordFilter (struct)
Property	Type	Comment
id	number	The identifier of the keyword filter
filter	string	The filter
keywordId	number	The identifier of the keyword this filter belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this filter belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "filter": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "filter": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

KeywordFilter (struct)
Property	Type	Comment
id	number	The identifier of the keyword filter
filter	string	The filter
keywordId	number	The identifier of the keyword this filter belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this filter belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "filter": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

Creating keyword filters

 POST /keyword-filters

Creates one or more filter words for a given keyword.

Each item is validated individually:

Successful creations appear in data.success.
Filters that fail validation (e.g., duplicates or invalid) appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /keyword-filters?keywordId=123)

FilterCreationRequest (struct)

Property

Type

Comment

filters

required

string[]

The filters to be added.

Example:

{
  "filters": [
    "demo"
  ]
}

First, format the structure to a JSON string:

{"filters":["demo"]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /keyword-filters HTTP/1.1
Content-Type: application/json
Content-Length: 20

{"filters":["demo"]}


      curl -X POST https://data.skema.co.id/24.04/keyword-filters \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"filters":["demo"]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "filters": [
    "demo"
  ]
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/keyword-filters',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/keyword-filters")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "filters": [
    "demo"
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keyword-filters"

payload = json.dumps({
  "filters": [
    "demo"
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "filters": [
    "demo"
  ]
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/keyword-filters', $headers , $body);
$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	BulkCreationResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

Deleting keyword filters

 DELETE /keyword-filters/delete-many

This endpoint enables clients to remove one or multiple filters associated with a keyword.

Each item is validated individually:

Successful deletions appear in data.success.
Deletions that failed appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /excludes/delete-many?keywordId=123)

WordDeletionRequest (struct)

Property

Type

Comment

ids

required

number[]

The identifiers of items to be deleted.

Example:

{
  "ids": [
    0
  ]
}

First, format the structure to a JSON string:

{"ids":[0]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

DELETE /keyword-filters/delete-many HTTP/1.1
Content-Type: application/json
Content-Length: 11

{"ids":[0]}


      curl -X DELETE https://data.skema.co.id/24.04/keyword-filters/delete-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"ids":[0]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "ids": [
    0
  ]
})
const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/keyword-filters/delete-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.delete("https://data.skema.co.id/24.04/keyword-filters/delete-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "ids": [
    0
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/keyword-filters/delete-many"

payload = json.dumps({
  "ids": [
    0
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "ids": [
    0
  ]
}'
$request = new Request('DELETE', 'https://data.skema.co.id/24.04/keyword-filters/delete-many', $headers , $body);
$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	BulkDeletionResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

Chart templates

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

Listing chart templates

 GET /chart-templates


      curl -G https://data.skema.co.id/24.04/chart-templates \
    -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/chart-templates',
  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/chart-templates")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/chart-templates"

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/chart-templates', $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	ChartTemplate[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "name": "keyword_map",
      "title": "Keyword map",
      "language": "hu",
      "serviceGroup": "shares",
      "description": "",
      "templateGroup": "Reputation and sentiment analysis",
      "highchartsType": "scatter",
      "insightTypeId": null,
      "drilldownCharts": []
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

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

Example:

{
  "data": [
    {
      "id": 0,
      "name": "keyword_map",
      "title": "Keyword map",
      "language": "hu",
      "serviceGroup": "shares",
      "description": "",
      "templateGroup": "Reputation and sentiment analysis",
      "highchartsType": "scatter",
      "insightTypeId": null,
      "drilldownCharts": []
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

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

Example:

{
  "data": [
    {
      "id": 0,
      "name": "keyword_map",
      "title": "Keyword map",
      "language": "hu",
      "serviceGroup": "shares",
      "description": "",
      "templateGroup": "Reputation and sentiment analysis",
      "highchartsType": "scatter",
      "insightTypeId": null,
      "drilldownCharts": []
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

Finding a single chart template

 GET /chart-templates/:chartTemplateId


      curl -G https://data.skema.co.id/24.04/chart-templates/:chartTemplateId \
    -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/chart-templates/:chartTemplateId',
  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/chart-templates/:chartTemplateId")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/chart-templates/:chartTemplateId"

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/chart-templates/:chartTemplateId', $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	ChartTemplate	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "id": 0,
    "name": "keyword_map",
    "title": "Keyword map",
    "language": "hu",
    "serviceGroup": "shares",
    "description": "",
    "templateGroup": "Reputation and sentiment analysis",
    "highchartsType": "scatter",
    "insightTypeId": null,
    "drilldownCharts": []
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

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

Example:

{
  "data": {
    "id": 0,
    "name": "keyword_map",
    "title": "Keyword map",
    "language": "hu",
    "serviceGroup": "shares",
    "description": "",
    "templateGroup": "Reputation and sentiment analysis",
    "highchartsType": "scatter",
    "insightTypeId": null,
    "drilldownCharts": []
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

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

Example:

{
  "data": {
    "id": 0,
    "name": "keyword_map",
    "title": "Keyword map",
    "language": "hu",
    "serviceGroup": "shares",
    "description": "",
    "templateGroup": "Reputation and sentiment analysis",
    "highchartsType": "scatter",
    "insightTypeId": null,
    "drilldownCharts": []
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartTemplate (struct)
Property	Type	Comment
id	number	The identifier of the chart template.
name	string	An internal name for the chart's type.
title	string	The title of the chart template.
language	string	The language of the chart template. Can be empty.
serviceGroup	string	-
description	string	The description of the template.
templateGroup	string	The template group this template belongs to.
highchartsType	string	The highcharts chart type of the template.
insightTypeId	number \| null	-
drilldownCharts	number[]	-
filters	ViewFilter	-
presentation	ChartPresentation	-

Example:

{
  "id": 0,
  "name": "keyword_map",
  "title": "Keyword map",
  "language": "hu",
  "serviceGroup": "shares",
  "description": "",
  "templateGroup": "Reputation and sentiment analysis",
  "highchartsType": "scatter",
  "insightTypeId": null,
  "drilldownCharts": []
}

Referenced entities by ChartTemplate

ViewFilter (struct)
Property	Type	Comment
aspects	string[]	A list of aspect ids. Required only when "keywords" is not defined.
keywords	number[]	A list of keyword ids. Required only when "aspects" is not defined.
interval	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	SourceGroup[]	Filters between the content sources.
genders	GenderGroup[]	Filters for the gender of the author.
polarities	PolarityGroup[]	Filters for sentiment between the results.
filterLanguages	number[]	Filters for the language of the mention.
excludeLanguages	number[]	Excludes mentions with the given languages.
filterPersons	number[][]	Filters for mentions with the given persons.
excludePersons	number[][]	Excludes mentions with the given persons.
filterCities	number[]	Filters for the city of the mention.
filterRegions	number[]	Filters for the region of the mention.
excludeRegions	number[]	Excludes mentions with the given regions.
excludeCities	number[]	Excludes mentions with the given cities.
filterOwnChannels	number[]	Filters for mentions for the given own channels.
excludeOwnChannels	number[]	Excludes mentions belonging to the given own channels.
filterTags	number[][]	Filters for mentions with the given tags.
excludeTags	number[][]	Excludes mentions with the given tags.
excludeSources	SourceGroup[]	Excludes mentions with the given source types.
numeric	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count.
filterPhrases	ConditionFilterDetails	Filters mentions that has the given phrases in their text.
excludePhrases	ConditionFilterDetails	Excludes mentions with the given phrases in their text.
filterTitles	ConditionFilterDetails	Filters mentions that has the given phrases in their title.
excludeTitles	ConditionFilterDetails	Excludes mentions with the given phrases in their title.
filterUrls	ConditionFilterDetails	Filters mentions with the given urls.
excludeUrls	ConditionFilterDetails	Excludes mentions with the given urls.
filterDomains	ConditionFilterDetails	Filters mentions with the given domains.
excludeDomains	ConditionFilterDetails	Excludes mentions with the given domains.
filterAuthors	ConditionFilterDetails	Filters mentions with the given authors.
excludeAuthors	ConditionFilterDetails	Excludes mentions with the given authors.

Example:

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

Referenced entities by ViewFilter

IntervalFilter (struct)
Property	Type	Comment
end	number	The latest time in milliseconds.
start	number	The earliest time in milliseconds.

Example:

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

NumericFilterDetails (struct)
Property	Type	Comment
id	NumericFilter	The identifier of the numeric filter.
value	number	The value of the numeric filter.
operator	Operator	-

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)
Property	Type	Comment
values	string[][]	The phrases to filter with. The arrays have OR, the phrases inside the arrays have AND connection.
matchingType	MatchType	-

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend	boolean	-
showTitle	boolean	-
showLegend	boolean	-
showAverage	boolean	-
numberOfValues	number	-
showTinyValues	boolean	-
showDescription	boolean	-
showTranslation	ShowTranslation	-
showInteractions	boolean	-
showChangeInValues	boolean	-
ianaTimeZone	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.
format	ChartDataFormat	-
ianaLanguage	string	The language of the descriptions
showInsight	string	Toggles whether the chart should display insights

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

Synonyms

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

Listing synonyms

 GET /synonyms

This endpoint returns a list of synonyms linked to a given keyword or aspect group.

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

keywordId

omitable

number

Filter by a keyword.

aspectGroupId

omitable

number

Filter by an aspect group.

Example:

{
  "keywordId": 0,
  "aspectGroupId": 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!):

keywordId=0&aspectGroupId=0

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

/synonyms?keywordId=0&aspectGroupId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/synonyms?keywordId=0&aspectGroupId=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/synonyms?keywordId=0&aspectGroupId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/synonyms?keywordId=0&aspectGroupId=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/synonyms?keywordId=0&aspectGroupId=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	Synonym[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "synonym": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Synonym (struct)
Property	Type	Comment
id	number	The identifier of the synonym
synonym	string	The synonym
keywordId	null \| number	The identifier of the keyword this synonym belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this synonym belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "synonym": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "synonym": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Synonym (struct)
Property	Type	Comment
id	number	The identifier of the synonym
synonym	string	The synonym
keywordId	null \| number	The identifier of the keyword this synonym belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this synonym belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "synonym": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "synonym": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Synonym (struct)
Property	Type	Comment
id	number	The identifier of the synonym
synonym	string	The synonym
keywordId	null \| number	The identifier of the keyword this synonym belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this synonym belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "synonym": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

Creating synonyms

 POST /synonyms

Creates one or more synonyms for a given keyword or aspect group.

Each item is validated individually:

Successful creations appear in data.success.
Synonyms that fail validation (e.g., duplicates or invalid) appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId or aspectGroupId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /synonyms?keywordId=123)

SynonymCreationRequest (struct)

Property

Type

Comment

synonyms

required

string[]

The synonyms to be added.

Example:

{
  "synonyms": [
    "demo"
  ]
}

First, format the structure to a JSON string:

{"synonyms":["demo"]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /synonyms HTTP/1.1
Content-Type: application/json
Content-Length: 21

{"synonyms":["demo"]}


      curl -X POST https://data.skema.co.id/24.04/synonyms \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"synonyms":["demo"]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "synonyms": [
    "demo"
  ]
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/synonyms',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/synonyms")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "synonyms": [
    "demo"
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/synonyms"

payload = json.dumps({
  "synonyms": [
    "demo"
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "synonyms": [
    "demo"
  ]
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/synonyms', $headers , $body);
$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	BulkCreationResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

Deleting synonyms

 DELETE /synonyms/delete-many

This endpoint enables clients to remove one or multiple synonyms associated with a keyword or aspect group.

Each item is validated individually:

Successful deletions appear in data.success.
Deletions that failed appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId or aspectGroupId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /excludes/delete-many?keywordId=123)

WordDeletionRequest (struct)

Property

Type

Comment

ids

required

number[]

The identifiers of items to be deleted.

Example:

{
  "ids": [
    0
  ]
}

First, format the structure to a JSON string:

{"ids":[0]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

DELETE /synonyms/delete-many HTTP/1.1
Content-Type: application/json
Content-Length: 11

{"ids":[0]}


      curl -X DELETE https://data.skema.co.id/24.04/synonyms/delete-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"ids":[0]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "ids": [
    0
  ]
})
const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/synonyms/delete-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.delete("https://data.skema.co.id/24.04/synonyms/delete-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "ids": [
    0
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/synonyms/delete-many"

payload = json.dumps({
  "ids": [
    0
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "ids": [
    0
  ]
}'
$request = new Request('DELETE', 'https://data.skema.co.id/24.04/synonyms/delete-many', $headers , $body);
$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	BulkDeletionResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

Excludes

Provides an interface to interact with the excludes of the keywords and aspect groups stored in our databases.

Listing excludes

 GET /excludes

This endpoint returns a list of excludes linked to a given keyword or aspect group.

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

keywordId

omitable

number

Filter by a keyword.

aspectGroupId

omitable

number

Filter by an aspect group.

Example:

{
  "keywordId": 0,
  "aspectGroupId": 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!):

keywordId=0&aspectGroupId=0

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

/excludes?keywordId=0&aspectGroupId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/excludes?keywordId=0&aspectGroupId=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/excludes?keywordId=0&aspectGroupId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/excludes?keywordId=0&aspectGroupId=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/excludes?keywordId=0&aspectGroupId=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	Exclude[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "exclude": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Exclude (struct)
Property	Type	Comment
id	number	The identifier of the exclude
exclude	string	The exclude
keywordId	null \| number	The identifier of the keyword this exclude belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this exclude belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "exclude": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "exclude": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Exclude (struct)
Property	Type	Comment
id	number	The identifier of the exclude
exclude	string	The exclude
keywordId	null \| number	The identifier of the keyword this exclude belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this exclude belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "exclude": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "exclude": "demo",
      "keywordId": 0,
      "aspectGroupId": null,
      "createdAtUtcMs": 0
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

Exclude (struct)
Property	Type	Comment
id	number	The identifier of the exclude
exclude	string	The exclude
keywordId	null \| number	The identifier of the keyword this exclude belongs to.
aspectGroupId	null \| number	The identifier of the aspect group this exclude belongs to.
createdAtUtcMs	number	The creation time in milliseconds, GMT

Example:

{
  "id": 0,
  "exclude": "demo",
  "keywordId": 0,
  "aspectGroupId": null,
  "createdAtUtcMs": 0
}

Creating excludes

 POST /excludes

Creates one or more excludes for a given keyword or aspect group..

Each item is validated individually:

Successful creations appear in data.success.
Excludes that fail validation (e.g., duplicates or invalid) appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId or aspectGroupId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /excludes?keywordId=123)

ExcludeCreationRequest (struct)

Property

Type

Comment

excludes

required

string[]

The excludes to be added.

Example:

{
  "excludes": [
    "demo"
  ]
}

First, format the structure to a JSON string:

{"excludes":["demo"]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

POST /excludes HTTP/1.1
Content-Type: application/json
Content-Length: 21

{"excludes":["demo"]}


      curl -X POST https://data.skema.co.id/24.04/excludes \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"excludes":["demo"]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "excludes": [
    "demo"
  ]
})
const config = {
  method: 'post',
  url: 'https://data.skema.co.id/24.04/excludes',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.post("https://data.skema.co.id/24.04/excludes")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "excludes": [
    "demo"
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/excludes"

payload = json.dumps({
  "excludes": [
    "demo"
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "excludes": [
    "demo"
  ]
}'
$request = new Request('POST', 'https://data.skema.co.id/24.04/excludes', $headers , $body);
$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	BulkCreationResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "item": "demo",
        "errorMessage": "Word already exists!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkCreationResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully added items
failed	failedWordResponse[]	Items that failed to be added

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "item": "demo",
      "errorMessage": "Word already exists!"
    }
  ]
}

Referenced entities by BulkCreationResponse

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

Example:

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

failedWordResponse (struct)
Property	Type	Comment
item	string	The label of the item
errorMessage	string	The reason the item was not added

Example:

{
  "item": "demo",
  "errorMessage": "Word already exists!"
}

Deleting excludes

 DELETE /excludes/delete-many

This endpoint enables clients to remove one or multiple exclude words associated with a keyword or aspect group.

Each item is validated individually:

Successful deletions appear in data.success.
Deletions that failed appear in data.failed with an errorMessage.

The API expects the structure below to be passed in the request body, formatted as a json string.

The API expects the keywordId or aspectGroupId to be passed in the url parameters (query string), formatted as an url-encoded string. (For example: /excludes/delete-many?keywordId=123)

WordDeletionRequest (struct)

Property

Type

Comment

ids

required

number[]

The identifiers of items to be deleted.

Example:

{
  "ids": [
    0
  ]
}

First, format the structure to a JSON string:

{"ids":[0]}

Finally, use the string as the body of the request. A raw HTTP request would look similar to the following:

DELETE /excludes/delete-many HTTP/1.1
Content-Type: application/json
Content-Length: 11

{"ids":[0]}


      curl -X DELETE https://data.skema.co.id/24.04/excludes/delete-many \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6' \
    -H 'Content-Type: application/json' \
    --data-raw '{"ids":[0]}'
  
      const axios = require('axios');
const data = JSON.stringify({
  "ids": [
    0
  ]
})
const config = {
  method: 'delete',
  url: 'https://data.skema.co.id/24.04/excludes/delete-many',
  headers: {
    'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
    'X-Requested-With': 'XMLHttpRequest',
    'Content-Type': 'application/json'
  }, 
  data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
      Unirest.setTimeouts(0, 0);
HttpResponse response = Unirest.delete("https://data.skema.co.id/24.04/excludes/delete-many")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .header("Content-Type", "application/json")
  .body({
  "ids": [
    0
  ]
})
  .asJson(); 
      import requests
import json
url = "https://data.skema.co.id/24.04/excludes/delete-many"

payload = json.dumps({
  "ids": [
    0
  ]
})
headers = {
  'Authorization': 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'X-Requested-With': 'XMLHttpRequest',
  'Content-Type': 'application/json'
}

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

print(response.text)
      use GuzzleHttp\Psr7\Request;
$client = new Client();
$headers = [
  'X-Requested-With' => 'XMLHttpRequest',
  'Authorization' => 'Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6',
  'Content-Type' => 'application/json'
];
$body = '{
  "ids": [
    0
  ]
}'
$request = new Request('DELETE', 'https://data.skema.co.id/24.04/excludes/delete-many', $headers , $body);
$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	BulkDeletionResponse	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

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

Example:

{
  "data": {
    "success": [
      {
        "id": 0,
        "item": "demo"
      }
    ],
    "failed": [
      {
        "id": 0,
        "errorMessage": "Item could not be deleted or was not found!"
      }
    ]
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

BulkDeletionResponse (struct)
Property	Type	Comment
success	successWordResponse[]	The list of the succesfully deleted items
failed	failedWordResponse[]	Items that failed to be deleted

Example:

{
  "success": [
    {
      "id": 0,
      "item": "demo"
    }
  ],
  "failed": [
    {
      "id": 0,
      "errorMessage": "Item could not be deleted or was not found!"
    }
  ]
}

Referenced entities by BulkDeletionResponse

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

Example:

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

failedWordDeletionResponse (struct)
Property	Type	Comment
id	number	The id of the item
errorMessage	string	The reason the item was not added

Example:

{
  "id": 0,
  "errorMessage": "Item could not be deleted or was not found!"
}

Mention Data Feed

Provides an interface to easily synchronise mentions between systems. There are 2 endpoints related to this synchronization operation, each serving different purposes:

One to poll for changes
One to iterate through consecutive pages of mentions as quickly as possible

As mentions can be rather large (especially blog and article type entities), response bodies can quickly reach the megabytes in terms of size. Because of this, both endpoints paginate the results, and return at most 1 000 mentions at once.

Each endpoint serves results in the order our system found them, and not by the results' individual creation times (so by the mentions' discoveredAtUtcMs property, not the creationTimeUtcMs property).

To load all results related to a single data source, first you should call the polling endpoint without providing a lastMentionId constraint. This will ensure that you start the pagination from the very first mentions our system found for the given data source. Then, if there are more mentions to serve, the response will contain a non-empty string called nextPageToken. By calling the next endpoint, and passing it this nextPageToken constraint, you can access the next page of results. To synchronise all mentions, you should query the next set of pages while the nextPageToken is not empty.

If you are only interested in the changes since your last visit, you can pass the lastMentionId constraint to the polling endpoint, representing the last mention in a dataset your system has knowledge about, which in turn will only serve mentions that were found since then. Note, that this "last mention" is not necessarily the last mention in terms of "creation time", rather by the time it was discovered and added to our system (discoveredAtUtcMs property on the mention).

Checking for changes (polling)

 GET /mentions/data-feed/changes

This endpoint has been designed to be called periodically, to check if there are new mentions in the system related to a single data source (which can either be a keyword- or an aspect identifier). To query what keywords and aspects you have access to, you may want to check out the resources section of this documentation.

The optional lastMentionId constraint must be a valid member of the data source you specified, and indicates the last mention your system has knowledge about (ordered by the discoveredAtUtcMs property on the mention - the order in which the data feed endpoints return their results). If you provide a value for it, this endpoint will only return mentions that has been found since your last query. If, however, you omit this constraint, we will start to serve all mentions in our system.

The optional fromTimestamp constraint can be used to further instruct the API to only return mentions that were created after a given point in time. Please note that the creation time, and the discovery time of the mentions are different - the former refers to when a content was authored at (createdAtUtcMs on the mention), the latter tells you when our system has discovered and saved it (discoveredAtUtcMs). This timestamp refers to the creation time. The timestamp can be provided in either seconds or milliseconds, as long as it represents a valid UTC point in time.

Only returns at most 1 000 mentions on a single page. If the response's body.meta.nextPageToken property is not empty, there might be more results on the next page. In this case, you should pass this token to the next endpoint, and load each page.

To protect against malicious access patterns, this endpoint can only be called once for a single data source in a minute. If you need near real-time synchronisation between our systems, we recommend a balanced polling schedule, calling about every 5 to 15 minutes or so.

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

CheckConstraints (struct)
Property	Type	Comment
dataSourceId required	string \| number	Either a keyword, or an aspect ID.
lastMentionId omitable	string	The ID of the last mention your system knows about.
fromTimestamp omitable	number	An UTC timestamp (either seconds or milliseconds). When present, the API will only serve mentions that were created after this point in time.
withRelatedResources omitable	boolean	Default: false. Whether to include a related resource map in the response or not.

Example:

{
  "dataSourceId": 10088
}

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!):

dataSourceId=10088

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

/mentions/data-feed/changes?dataSourceId=10088


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/mentions/data-feed/changes?dataSourceId=10088',
  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/data-feed/changes?dataSourceId=10088")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/mentions/data-feed/changes?dataSourceId=10088"

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/data-feed/changes?dataSourceId=10088', $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	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

Loading the next page of changes

 GET /mentions/data-feed/changes/next

This endpoint was designed to iterate over paginated results faster than one could by just using the polling endpoint. Returns at most 1 000 mentions from a single invocation, for reasons described in the introduction section.

Can only be called with a valid nextPageToken. Such tokens are only valid for 5 minutes, so please use the polling endpoint to check if there are new mentions since your last visit.

To protect against malicious access patterns, this endpoint can only be called once with a valid nextPageToken in a minute (you will receive a new token after each iteration, so this restriction only applies when you have to retry the same page for some reason). Since such tokens live for 5 minutes, you have 5 tries to query a single page, if something goes wrong. If the problem persists, you will have to call the polling endpoint at a later time, in order to continue synchronising results.

If the response's body.meta.nextPageToken property is not empty, there might be more results on the next page. In this case, you can call this endpoint repeatedly with the provided token until there are no more pages left (the body.meta.nextPageToken is an empty string).

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

NextPageConstraints (struct)

Property

Type

Comment

nextPageToken

required

string

An internal token representing the state of the pagination.

Example:

{
  "nextPageToken": ""
}

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!):

nextPageToken=

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

/mentions/data-feed/changes/next?nextPageToken=


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/mentions/data-feed/changes/next?nextPageToken=',
  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/data-feed/changes/next?nextPageToken=")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/mentions/data-feed/changes/next?nextPageToken="

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/data-feed/changes/next?nextPageToken=', $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	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

ApiPayload (struct)
Property	Type	Comment
data	Mention[]	The resource model(s).
meta	DataFeedMeta	Any model/infromation related to the data.
error		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,
      "discoveredAtUtcMs": 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": "",
      "sumInteractions": 0,
      "sumDislikes": 0,
      "sumReactions": 0,
      "engagementRate": 0,
      "sumLikes": 0,
      "sumShares": 0,
      "sumComments": 0,
      "sumFollowers": 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": {
    "nextPageToken": "",
    "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.
discoveredAtUtcMs	number	The time the mention was added to our system 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.
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.
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.
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,
  "discoveredAtUtcMs": 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": "",
  "sumInteractions": 0,
  "sumDislikes": 0,
  "sumReactions": 0,
  "engagementRate": 0,
  "sumLikes": 0,
  "sumShares": 0,
  "sumComments": 0,
  "sumFollowers": 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.
reply	number	The number of replies of this mention.
quote	number	The number of quotes of this mention.

Example:

{
  "like": 0,
  "comment": 0,
  "retweet": 0,
  "follower": 0,
  "reply": 0,
  "quote": 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.

DataFeedMeta (struct)
Property	Type	Comment
nextPageToken	string	When not empty, contains state related to the next page of the results.
relatedResources	null \| RelatedResourceMap	When requested, contains a map of related resources that are referenced by the mentions in the response.

Example:

{
  "nextPageToken": "",
  "relatedResources": null
}

Referenced entities by DataFeedMeta

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",
      "label": "Forum",
      "isGroup": true,
      "isEnabled": true,
      "sourceCode": 2,
      "parentSourceId": null,
      "parentSourceCode": 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

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
}

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

Example:

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

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
}

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
label	string	A displayable label for 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.
parentSourceCode	null \| number	The code of the source this source is a member of.

Example:

{
  "id": 6,
  "name": "forum",
  "order": 5,
  "color": "#9F20C1",
  "label": "Forum",
  "isGroup": true,
  "isEnabled": true,
  "sourceCode": 2,
  "parentSourceId": null,
  "parentSourceCode": 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	Deprecated. An internal code for the language - please use isoCode2 instead.

Example:

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

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"
}

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
}

OwnChannel (struct)
Property	Type	Comment
id	number	The identifier of the own channel instance.
type	OwnChannelType	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"
}

Referenced entities by OwnChannel

OwnChannelType (enum)
Value	Comment
appstore_app	Appstore app
fb_page	Facebook page
fb_group	Facebook group
forum	Forum
googleplay_app	Google Play App
google_location	Google location
twitter	Twitter
user	User
url	URL
yt_channel	Youtube channel
yt_video	Youtube video
fb_messenger	Facebook Messenger
instagram	Instagram
huawei_app	Huawei AppGallery
tt_page	TikTok

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"
}

Chart template data

Finding chart data by chart template

 GET /chart-templates/:chartTemplateId/data

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

ChartDataQuery (struct)

Property

Type

Comment

filters

required

ViewFilter

A structure that influences the multiplicity of the results

presentation

omitable

ChartTemplatePresentation

A structure that influences how your data will be presented.

Example:

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

Referenced entities by ChartDataQuery

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 omitable	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 omitable	SourceGroup[]	Filters between the content sources. Default: `[1]`
genders omitable	GenderGroup[]	Filters for the gender of the author. Default: `[1]`
polarities omitable	PolarityGroup[]	Filters for sentiment between the results. Default: `[1]`
filterLanguages omitable	number[]	Filters for the language of the mention. Default: `[]`
excludeLanguages omitable	number[]	Excludes mentions with the given languages. Default: `[]`
filterPersons omitable	number[][]	Filters for mentions with the given persons. Default: `[]`
excludePersons omitable	number[][]	Excludes mentions with the given persons. Default: `[]`
filterCities omitable	number[]	Filters for the city of the mention. Default: `[]`
filterRegions omitable	number[]	Filters for the region of the mention. Default: `[]`
excludeRegions omitable	number[]	Excludes mentions with the given regions. Default: `[]`
excludeCities omitable	number[]	Excludes mentions with the given cities. Default: `[]`
filterOwnChannels omitable	number[]	Filters for mentions for the given own channels. Default: `[]`
excludeOwnChannels omitable	number[]	Excludes mentions belonging to the given own channels. Default: `[]`
filterTags omitable	number[][]	Filters for mentions with the given tags. Default: `[]`
excludeTags omitable	number[][]	Excludes mentions with the given tags. Default: `[]`
excludeSources omitable	SourceGroup[]	Excludes mentions with the given source types. Default: `[]`
numeric omitable	NumericFilterDetails[]	Filters mentions by their numeric values e.g. like count. Default: `[]`
filterPhrases omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
excludePhrases omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their text. Default: `{ "values": [], "matchingType": "contains" }`
filterTitles omitable	ConditionFilterDetails	Filters mentions that has the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
excludeTitles omitable	ConditionFilterDetails	Excludes mentions with the given phrases in their title. Default: `{ "values": [], "matchingType": "contains" }`
filterUrls omitable	ConditionFilterDetails	Filters mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
excludeUrls omitable	ConditionFilterDetails	Excludes mentions with the given urls. Default: `{ "values": [], "matchingType": "contains" }`
filterDomains omitable	ConditionFilterDetails	Filters mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
excludeDomains omitable	ConditionFilterDetails	Excludes mentions with the given domains. Default: `{ "values": [], "matchingType": "contains" }`
filterAuthors omitable	ConditionFilterDetails	Filters mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`
excludeAuthors omitable	ConditionFilterDetails	Excludes mentions with the given authors. Default: `{ "values": [], "matchingType": "contains" }`

Example:

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

Referenced entities by ViewFilter

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 omitable	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)

Property Type Comment

values

required

string[][]

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

matchingType

omitable

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	Other Social
16	Video
17	Tumblr
18	Twitter
19	Twitter tweet
20	Twitter reply
21	Twitter retweet
22	Twitter quoted
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
39	Other - Pinterest
40	Other - Tumblr
41	Video - Classic
42	Video - Youtube video
45	Facebook group post
46	Facebook group comment
48	Facebook group reply
50	Document
51	Instagram reply
52	Google location review
53	Video - Youtube comment
54	Direct message - Facebook messenger message
55	Direct message - Facebook messenger reply
56	Video - Youtube reply
57	Direct Message
59	Article comment
60	Blog comment
61	Frontpage aggregator
62	Article aggregator
63	Blog aggregator
67	Tiktok reply
70	Review - Google location review answer
71	Review - Google play review answer
72	Linkedin
73	Linkedin post
74	Linkedin comment
75	Linkedin 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

ChartTemplatePresentation (struct)
Property	Type	Comment
showTrend omitable	boolean	- Default: `false`
showTitle omitable	boolean	- Default: `true`
showLegend omitable	boolean	- Default: `true`
showAverage omitable	boolean	- Default: `true`
numberOfValues omitable	number	- Default: `10`
showTinyValues omitable	boolean	- Default: `true`
showDescription omitable	boolean	- Default: `true`
showTranslation omitable	ShowTranslation	- Default: `true`
showInteractions omitable	boolean	- Default: `true`
showChangeInValues omitable	boolean	- Default: `true`
ianaTimeZone omitable	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.
format omitable	ChartDataFormat	- Default: `"highcharts"`
ianaLanguage omitable	string	The language of the descriptions Default: `""`
showInsight omitable	string	Toggles whether the chart should display insights Default: `false`

Example:

{
  "showTrend": false,
  "showTitle": true,
  "showLegend": true,
  "showAverage": false,
  "numberOfValues": 10,
  "showTinyValues": true,
  "showDescription": true,
  "showTranslation": 0,
  "showInteractions": true,
  "showChangeInValues": false,
  "ianaTimeZone": "Europe/Budapest",
  "format": "highcharts",
  "ianaLanguage": "",
  "showInsight": false
}

Referenced entities by ChartTemplatePresentation

ShowTranslation (enum)
Value	Comment
0	No
1	Yes
2	Only

ChartDataFormat (enum)
Value	Comment
highcharts	Highcharts JSON

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):

/chart-templates/:charttemplateid/data?filters[aspects][0]=10001_20002&filters[keywords][0]=10001&filters[keywords][1]=10002


      curl -G https://data.skema.co.id/24.04/chart-templates/:chartTemplateId/data \
    -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/chart-templates/:chartTemplateId/data?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/chart-templates/:chartTemplateId/data?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/chart-templates/:chartTemplateId/data?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/chart-templates/:chartTemplateId/data?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	ChartData	The chart aggregation object. It's format depends on the template, and the request's presentation settings.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "series": [
      {
        "name": "Demo keyword",
        "label": "Demo keyword (2140 pcs)",
        "color": "#D5372C",
        "type": "line",
        "data": [
          {
            "y": 422,
            "x": 1666216800000
          },
          {
            "y": 327,
            "x": 1666303200000
          },
          {
            "y": 202,
            "x": 1666389600000
          },
          {
            "y": 174,
            "x": 1666476000000
          },
          {
            "y": 316,
            "x": 1666562400000
          },
          {
            "y": 323,
            "x": 1666648800000
          },
          {
            "y": 300,
            "x": 1666735200000
          },
          {
            "y": 76,
            "x": 1666821600000
          }
        ]
      }
    ],
    "credits": {
      "enabled": false
    },
    "chart": {
      "backgroundColor": "transparent",
      "style": {
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "title": {
      "align": "left",
      "useHTML": true,
      "text": "Number of mentions (line)",
      "style": {
        "fontSize": "14px",
        "fontWeight": "600"
      }
    },
    "time": {
      "timezone": "Europe/Budapest"
    },
    "plotOptions": {
      "series": {
        "cursor": "pointer",
        "marker": {
          "enabled": false
        }
      }
    },
    "tooltip": {
      "useHTML": true,
      "shadow": false,
      "followPointer": true,
      "style": {
        "fontSize": "12px",
        "fontFamily": "Proxima-Nova, sans-serif",
        "color": "#424454"
      },
      "headerFormat": "{point.x:%Y-%m-%d} - ",
      "pointFormat": "Number of mentions: {point.y} pcs"
    },
    "legend": {
      "enabled": true,
      "labelFormat": "{options.label}"
    },
    "caption": {
      "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
      "useHTML": true,
      "style": {
        "fontSize": "12px",
        "color": "#525E6D",
        "paddingTop": "10px",
        "paddingRight": "10px",
        "borderTop": "1px solid #d8dce8",
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "xAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 0,
      "type": "datetime",
      "dateTimeLabelFormats": {
        "day": "%m.%d.",
        "week": "%m.%d.",
        "month": "%m.%d.",
        "year": "%m.%d."
      },
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      }
    },
    "yAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 1,
      "gridLineColor": "#d8dce8",
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      },
      "title": {
        "text": null
      }
    }
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

This structure's shape may vary based on the chartTemplateId route parameter. The given example represents a sample response for a "freq" chart (chartTemplateId: 13), presented as a highcharts object. More details of the different chart types can be found at [highcharts.com].

ChartData (struct)
Property	Type	Comment
series	SeriesOptions[]	-
credits	CreditsOptions	-
chart	ChartOptions	-
title	TitleOptions	-
time	TimeOptions	-
plotOptions	PlotOptions	-
tooltip	TooltipOptions	-
legend	LegendOptions	-
caption	CaptionOptions	-
xAxis	XAxisOptions	-
yAxis	YAxisOptions	-

Example:

{
  "series": [
    {
      "name": "Demo keyword",
      "label": "Demo keyword (2140 pcs)",
      "color": "#D5372C",
      "type": "line",
      "data": [
        {
          "y": 422,
          "x": 1666216800000
        },
        {
          "y": 327,
          "x": 1666303200000
        },
        {
          "y": 202,
          "x": 1666389600000
        },
        {
          "y": 174,
          "x": 1666476000000
        },
        {
          "y": 316,
          "x": 1666562400000
        },
        {
          "y": 323,
          "x": 1666648800000
        },
        {
          "y": 300,
          "x": 1666735200000
        },
        {
          "y": 76,
          "x": 1666821600000
        }
      ]
    }
  ],
  "credits": {
    "enabled": false
  },
  "chart": {
    "backgroundColor": "transparent",
    "style": {
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "title": {
    "align": "left",
    "useHTML": true,
    "text": "Number of mentions (line)",
    "style": {
      "fontSize": "14px",
      "fontWeight": "600"
    }
  },
  "time": {
    "timezone": "Europe/Budapest"
  },
  "plotOptions": {
    "series": {
      "cursor": "pointer",
      "marker": {
        "enabled": false
      }
    }
  },
  "tooltip": {
    "useHTML": true,
    "shadow": false,
    "followPointer": true,
    "style": {
      "fontSize": "12px",
      "fontFamily": "Proxima-Nova, sans-serif",
      "color": "#424454"
    },
    "headerFormat": "{point.x:%Y-%m-%d} - ",
    "pointFormat": "Number of mentions: {point.y} pcs"
  },
  "legend": {
    "enabled": true,
    "labelFormat": "{options.label}"
  },
  "caption": {
    "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
    "useHTML": true,
    "style": {
      "fontSize": "12px",
      "color": "#525E6D",
      "paddingTop": "10px",
      "paddingRight": "10px",
      "borderTop": "1px solid #d8dce8",
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "xAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 0,
    "type": "datetime",
    "dateTimeLabelFormats": {
      "day": "%m.%d.",
      "week": "%m.%d.",
      "month": "%m.%d.",
      "year": "%m.%d."
    },
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    }
  },
  "yAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 1,
    "gridLineColor": "#d8dce8",
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    },
    "title": {
      "text": null
    }
  }
}

Referenced entities by ChartData

SeriesOptions (struct)
Property	Type	Comment
name	string	-
label	string	-
color	string	-
type	string	-
data	PointOptions[]	-

Example:

{
  "name": "Demo keyword",
  "label": "Demo keyword (2140 pcs)",
  "color": "#D5372C",
  "type": "line",
  "data": [
    {
      "y": 422,
      "x": 1666216800000
    },
    {
      "y": 327,
      "x": 1666303200000
    },
    {
      "y": 202,
      "x": 1666389600000
    },
    {
      "y": 174,
      "x": 1666476000000
    },
    {
      "y": 316,
      "x": 1666562400000
    },
    {
      "y": 323,
      "x": 1666648800000
    },
    {
      "y": 300,
      "x": 1666735200000
    },
    {
      "y": 76,
      "x": 1666821600000
    }
  ]
}

Referenced entities by SeriesOptions

PointOptions (struct)
Property	Type	Comment
x	number	-
y	number	-

Example:

{
  "x": 0,
  "y": 0
}

CreditsOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

ChartOptions (struct)
Property	Type	Comment
backgroundColor	string	-
style	ChartStyleOptions	-

Example:

{
  "backgroundColor": "transparent",
  "style": {
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by ChartOptions

ChartStyleOptions (struct)
Property	Type	Comment
fontFamily	string	-

Example:

{
  "fontFamily": "Proxima-Nova, sans-serif"
}

TitleOptions (struct)
Property	Type	Comment
align	string	-
useHTML	boolean	-
text	string	-
style	TitleStyleOptions	-

Example:

{
  "align": "left",
  "useHTML": true,
  "text": "Number of mentions (line)",
  "style": {
    "fontSize": "14px",
    "fontWeight": "600"
  }
}

Referenced entities by TitleOptions

TitleStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontWeight	string	-

Example:

{
  "fontSize": "14px",
  "fontWeight": "600"
}

TimeOptions (struct)
Property	Type	Comment
timezone	string	-

Example:

{
  "timezone": "Europe/Budapest"
}

PlotOptions (struct)
Property	Type	Comment
series	SeriesPlotOptions	-

Example:

{
  "series": {
    "cursor": "pointer",
    "marker": {
      "enabled": false
    }
  }
}

Referenced entities by PlotOptions

SeriesPlotOptions (struct)
Property	Type	Comment
cursor	string	-
marker	MarkerOptions	-

Example:

{
  "cursor": "pointer",
  "marker": {
    "enabled": false
  }
}

Referenced entities by SeriesPlotOptions

MarkerOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

TooltipOptions (struct)
Property	Type	Comment
useHTML	boolean	-
shadow	boolean	-
followPointer	boolean	-
style	TooltipStyleOptions	-
headerFormat	string	-
pointFormat	string	-

Example:

{
  "useHTML": true,
  "shadow": false,
  "followPointer": true,
  "style": {
    "fontSize": "12px",
    "fontFamily": "Proxima-Nova, sans-serif",
    "color": "#424454"
  },
  "headerFormat": "{point.x:%Y-%m-%d} - ",
  "pointFormat": "Number of mentions: {point.y} pcs"
}

Referenced entities by TooltipOptions

TooltipStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontFamily	string	-
color	string	-

Example:

{
  "fontSize": "12px",
  "fontFamily": "Proxima-Nova, sans-serif",
  "color": "#424454"
}

LegendOptions (struct)
Property	Type	Comment
enabled	boolean	-
labelFormat	string	-

Example:

{
  "enabled": true,
  "labelFormat": "{options.label}"
}

CaptionOptions (struct)
Property	Type	Comment
text	string	-
useHTML	boolean	-
style	CaptionStyleOptions	-

Example:

{
  "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
  "useHTML": true,
  "style": {
    "fontSize": "12px",
    "color": "#525E6D",
    "paddingTop": "10px",
    "paddingRight": "10px",
    "borderTop": "1px solid #d8dce8",
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by CaptionOptions

CaptionStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
color	string	-
paddingTop	string	-
paddingRight	string	-
borderTop	string	-
fontFamily	string	-

Example:

{
  "fontSize": "12px",
  "color": "#525E6D",
  "paddingTop": "10px",
  "paddingRight": "10px",
  "borderTop": "1px solid #d8dce8",
  "fontFamily": "Proxima-Nova, sans-serif"
}

XAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
type	string	-
dateTimeLabelFormats	DateTimeLabelFormatOptions	-
labels	AxisLabelOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 0,
  "type": "datetime",
  "dateTimeLabelFormats": {
    "day": "%m.%d.",
    "week": "%m.%d.",
    "month": "%m.%d.",
    "year": "%m.%d."
  },
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  }
}

Referenced entities by XAxisOptions

DateTimeLabelFormatOptions (struct)
Property	Type	Comment
day	string	-
week	string	-
month	string	-
year	string	-

Example:

{
  "day": "%m.%d.",
  "week": "%m.%d.",
  "month": "%m.%d.",
  "year": "%m.%d."
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

YAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
gridLineColor	string	-
labels	AxisLabelOptions	-
title	YAxisTitleOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 1,
  "gridLineColor": "#d8dce8",
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  },
  "title": {
    "text": null
  }
}

Referenced entities by YAxisOptions

YAxisTitleOptions (struct)
Property	Type	Comment
text	string	-

Example:

{
  "text": null
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

ApiPayload (struct)
Property	Type	Comment
data	ChartData	The chart aggregation object. It's format depends on the template, and the request's presentation settings.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "series": [
      {
        "name": "Demo keyword",
        "label": "Demo keyword (2140 pcs)",
        "color": "#D5372C",
        "type": "line",
        "data": [
          {
            "y": 422,
            "x": 1666216800000
          },
          {
            "y": 327,
            "x": 1666303200000
          },
          {
            "y": 202,
            "x": 1666389600000
          },
          {
            "y": 174,
            "x": 1666476000000
          },
          {
            "y": 316,
            "x": 1666562400000
          },
          {
            "y": 323,
            "x": 1666648800000
          },
          {
            "y": 300,
            "x": 1666735200000
          },
          {
            "y": 76,
            "x": 1666821600000
          }
        ]
      }
    ],
    "credits": {
      "enabled": false
    },
    "chart": {
      "backgroundColor": "transparent",
      "style": {
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "title": {
      "align": "left",
      "useHTML": true,
      "text": "Number of mentions (line)",
      "style": {
        "fontSize": "14px",
        "fontWeight": "600"
      }
    },
    "time": {
      "timezone": "Europe/Budapest"
    },
    "plotOptions": {
      "series": {
        "cursor": "pointer",
        "marker": {
          "enabled": false
        }
      }
    },
    "tooltip": {
      "useHTML": true,
      "shadow": false,
      "followPointer": true,
      "style": {
        "fontSize": "12px",
        "fontFamily": "Proxima-Nova, sans-serif",
        "color": "#424454"
      },
      "headerFormat": "{point.x:%Y-%m-%d} - ",
      "pointFormat": "Number of mentions: {point.y} pcs"
    },
    "legend": {
      "enabled": true,
      "labelFormat": "{options.label}"
    },
    "caption": {
      "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
      "useHTML": true,
      "style": {
        "fontSize": "12px",
        "color": "#525E6D",
        "paddingTop": "10px",
        "paddingRight": "10px",
        "borderTop": "1px solid #d8dce8",
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "xAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 0,
      "type": "datetime",
      "dateTimeLabelFormats": {
        "day": "%m.%d.",
        "week": "%m.%d.",
        "month": "%m.%d.",
        "year": "%m.%d."
      },
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      }
    },
    "yAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 1,
      "gridLineColor": "#d8dce8",
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      },
      "title": {
        "text": null
      }
    }
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartData (struct)
Property	Type	Comment
series	SeriesOptions[]	-
credits	CreditsOptions	-
chart	ChartOptions	-
title	TitleOptions	-
time	TimeOptions	-
plotOptions	PlotOptions	-
tooltip	TooltipOptions	-
legend	LegendOptions	-
caption	CaptionOptions	-
xAxis	XAxisOptions	-
yAxis	YAxisOptions	-

Example:

{
  "series": [
    {
      "name": "Demo keyword",
      "label": "Demo keyword (2140 pcs)",
      "color": "#D5372C",
      "type": "line",
      "data": [
        {
          "y": 422,
          "x": 1666216800000
        },
        {
          "y": 327,
          "x": 1666303200000
        },
        {
          "y": 202,
          "x": 1666389600000
        },
        {
          "y": 174,
          "x": 1666476000000
        },
        {
          "y": 316,
          "x": 1666562400000
        },
        {
          "y": 323,
          "x": 1666648800000
        },
        {
          "y": 300,
          "x": 1666735200000
        },
        {
          "y": 76,
          "x": 1666821600000
        }
      ]
    }
  ],
  "credits": {
    "enabled": false
  },
  "chart": {
    "backgroundColor": "transparent",
    "style": {
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "title": {
    "align": "left",
    "useHTML": true,
    "text": "Number of mentions (line)",
    "style": {
      "fontSize": "14px",
      "fontWeight": "600"
    }
  },
  "time": {
    "timezone": "Europe/Budapest"
  },
  "plotOptions": {
    "series": {
      "cursor": "pointer",
      "marker": {
        "enabled": false
      }
    }
  },
  "tooltip": {
    "useHTML": true,
    "shadow": false,
    "followPointer": true,
    "style": {
      "fontSize": "12px",
      "fontFamily": "Proxima-Nova, sans-serif",
      "color": "#424454"
    },
    "headerFormat": "{point.x:%Y-%m-%d} - ",
    "pointFormat": "Number of mentions: {point.y} pcs"
  },
  "legend": {
    "enabled": true,
    "labelFormat": "{options.label}"
  },
  "caption": {
    "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
    "useHTML": true,
    "style": {
      "fontSize": "12px",
      "color": "#525E6D",
      "paddingTop": "10px",
      "paddingRight": "10px",
      "borderTop": "1px solid #d8dce8",
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "xAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 0,
    "type": "datetime",
    "dateTimeLabelFormats": {
      "day": "%m.%d.",
      "week": "%m.%d.",
      "month": "%m.%d.",
      "year": "%m.%d."
    },
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    }
  },
  "yAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 1,
    "gridLineColor": "#d8dce8",
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    },
    "title": {
      "text": null
    }
  }
}

Referenced entities by ChartData

SeriesOptions (struct)
Property	Type	Comment
name	string	-
label	string	-
color	string	-
type	string	-
data	PointOptions[]	-

Example:

{
  "name": "Demo keyword",
  "label": "Demo keyword (2140 pcs)",
  "color": "#D5372C",
  "type": "line",
  "data": [
    {
      "y": 422,
      "x": 1666216800000
    },
    {
      "y": 327,
      "x": 1666303200000
    },
    {
      "y": 202,
      "x": 1666389600000
    },
    {
      "y": 174,
      "x": 1666476000000
    },
    {
      "y": 316,
      "x": 1666562400000
    },
    {
      "y": 323,
      "x": 1666648800000
    },
    {
      "y": 300,
      "x": 1666735200000
    },
    {
      "y": 76,
      "x": 1666821600000
    }
  ]
}

Referenced entities by SeriesOptions

PointOptions (struct)
Property	Type	Comment
x	number	-
y	number	-

Example:

{
  "x": 0,
  "y": 0
}

CreditsOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

ChartOptions (struct)
Property	Type	Comment
backgroundColor	string	-
style	ChartStyleOptions	-

Example:

{
  "backgroundColor": "transparent",
  "style": {
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by ChartOptions

ChartStyleOptions (struct)
Property	Type	Comment
fontFamily	string	-

Example:

{
  "fontFamily": "Proxima-Nova, sans-serif"
}

TitleOptions (struct)
Property	Type	Comment
align	string	-
useHTML	boolean	-
text	string	-
style	TitleStyleOptions	-

Example:

{
  "align": "left",
  "useHTML": true,
  "text": "Number of mentions (line)",
  "style": {
    "fontSize": "14px",
    "fontWeight": "600"
  }
}

Referenced entities by TitleOptions

TitleStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontWeight	string	-

Example:

{
  "fontSize": "14px",
  "fontWeight": "600"
}

TimeOptions (struct)
Property	Type	Comment
timezone	string	-

Example:

{
  "timezone": "Europe/Budapest"
}

PlotOptions (struct)
Property	Type	Comment
series	SeriesPlotOptions	-

Example:

{
  "series": {
    "cursor": "pointer",
    "marker": {
      "enabled": false
    }
  }
}

Referenced entities by PlotOptions

SeriesPlotOptions (struct)
Property	Type	Comment
cursor	string	-
marker	MarkerOptions	-

Example:

{
  "cursor": "pointer",
  "marker": {
    "enabled": false
  }
}

Referenced entities by SeriesPlotOptions

MarkerOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

TooltipOptions (struct)
Property	Type	Comment
useHTML	boolean	-
shadow	boolean	-
followPointer	boolean	-
style	TooltipStyleOptions	-
headerFormat	string	-
pointFormat	string	-

Example:

{
  "useHTML": true,
  "shadow": false,
  "followPointer": true,
  "style": {
    "fontSize": "12px",
    "fontFamily": "Proxima-Nova, sans-serif",
    "color": "#424454"
  },
  "headerFormat": "{point.x:%Y-%m-%d} - ",
  "pointFormat": "Number of mentions: {point.y} pcs"
}

Referenced entities by TooltipOptions

TooltipStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontFamily	string	-
color	string	-

Example:

{
  "fontSize": "12px",
  "fontFamily": "Proxima-Nova, sans-serif",
  "color": "#424454"
}

LegendOptions (struct)
Property	Type	Comment
enabled	boolean	-
labelFormat	string	-

Example:

{
  "enabled": true,
  "labelFormat": "{options.label}"
}

CaptionOptions (struct)
Property	Type	Comment
text	string	-
useHTML	boolean	-
style	CaptionStyleOptions	-

Example:

{
  "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
  "useHTML": true,
  "style": {
    "fontSize": "12px",
    "color": "#525E6D",
    "paddingTop": "10px",
    "paddingRight": "10px",
    "borderTop": "1px solid #d8dce8",
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by CaptionOptions

CaptionStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
color	string	-
paddingTop	string	-
paddingRight	string	-
borderTop	string	-
fontFamily	string	-

Example:

{
  "fontSize": "12px",
  "color": "#525E6D",
  "paddingTop": "10px",
  "paddingRight": "10px",
  "borderTop": "1px solid #d8dce8",
  "fontFamily": "Proxima-Nova, sans-serif"
}

XAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
type	string	-
dateTimeLabelFormats	DateTimeLabelFormatOptions	-
labels	AxisLabelOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 0,
  "type": "datetime",
  "dateTimeLabelFormats": {
    "day": "%m.%d.",
    "week": "%m.%d.",
    "month": "%m.%d.",
    "year": "%m.%d."
  },
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  }
}

Referenced entities by XAxisOptions

DateTimeLabelFormatOptions (struct)
Property	Type	Comment
day	string	-
week	string	-
month	string	-
year	string	-

Example:

{
  "day": "%m.%d.",
  "week": "%m.%d.",
  "month": "%m.%d.",
  "year": "%m.%d."
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

YAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
gridLineColor	string	-
labels	AxisLabelOptions	-
title	YAxisTitleOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 1,
  "gridLineColor": "#d8dce8",
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  },
  "title": {
    "text": null
  }
}

Referenced entities by YAxisOptions

YAxisTitleOptions (struct)
Property	Type	Comment
text	string	-

Example:

{
  "text": null
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

ApiPayload (struct)
Property	Type	Comment
data	ChartData	The chart aggregation object. It's format depends on the template, and the request's presentation settings.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": {
    "series": [
      {
        "name": "Demo keyword",
        "label": "Demo keyword (2140 pcs)",
        "color": "#D5372C",
        "type": "line",
        "data": [
          {
            "y": 422,
            "x": 1666216800000
          },
          {
            "y": 327,
            "x": 1666303200000
          },
          {
            "y": 202,
            "x": 1666389600000
          },
          {
            "y": 174,
            "x": 1666476000000
          },
          {
            "y": 316,
            "x": 1666562400000
          },
          {
            "y": 323,
            "x": 1666648800000
          },
          {
            "y": 300,
            "x": 1666735200000
          },
          {
            "y": 76,
            "x": 1666821600000
          }
        ]
      }
    ],
    "credits": {
      "enabled": false
    },
    "chart": {
      "backgroundColor": "transparent",
      "style": {
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "title": {
      "align": "left",
      "useHTML": true,
      "text": "Number of mentions (line)",
      "style": {
        "fontSize": "14px",
        "fontWeight": "600"
      }
    },
    "time": {
      "timezone": "Europe/Budapest"
    },
    "plotOptions": {
      "series": {
        "cursor": "pointer",
        "marker": {
          "enabled": false
        }
      }
    },
    "tooltip": {
      "useHTML": true,
      "shadow": false,
      "followPointer": true,
      "style": {
        "fontSize": "12px",
        "fontFamily": "Proxima-Nova, sans-serif",
        "color": "#424454"
      },
      "headerFormat": "{point.x:%Y-%m-%d} - ",
      "pointFormat": "Number of mentions: {point.y} pcs"
    },
    "legend": {
      "enabled": true,
      "labelFormat": "{options.label}"
    },
    "caption": {
      "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
      "useHTML": true,
      "style": {
        "fontSize": "12px",
        "color": "#525E6D",
        "paddingTop": "10px",
        "paddingRight": "10px",
        "borderTop": "1px solid #d8dce8",
        "fontFamily": "Proxima-Nova, sans-serif"
      }
    },
    "xAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 0,
      "type": "datetime",
      "dateTimeLabelFormats": {
        "day": "%m.%d.",
        "week": "%m.%d.",
        "month": "%m.%d.",
        "year": "%m.%d."
      },
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      }
    },
    "yAxis": {
      "lineWidth": 0,
      "tickWidth": 0,
      "startOnTick": false,
      "endOnTick": false,
      "gridLineWidth": 1,
      "gridLineColor": "#d8dce8",
      "labels": {
        "align": "center",
        "style": {
          "color": "#9fa7bc"
        }
      },
      "title": {
        "text": null
      }
    }
  },
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

ChartData (struct)
Property	Type	Comment
series	SeriesOptions[]	-
credits	CreditsOptions	-
chart	ChartOptions	-
title	TitleOptions	-
time	TimeOptions	-
plotOptions	PlotOptions	-
tooltip	TooltipOptions	-
legend	LegendOptions	-
caption	CaptionOptions	-
xAxis	XAxisOptions	-
yAxis	YAxisOptions	-

Example:

{
  "series": [
    {
      "name": "Demo keyword",
      "label": "Demo keyword (2140 pcs)",
      "color": "#D5372C",
      "type": "line",
      "data": [
        {
          "y": 422,
          "x": 1666216800000
        },
        {
          "y": 327,
          "x": 1666303200000
        },
        {
          "y": 202,
          "x": 1666389600000
        },
        {
          "y": 174,
          "x": 1666476000000
        },
        {
          "y": 316,
          "x": 1666562400000
        },
        {
          "y": 323,
          "x": 1666648800000
        },
        {
          "y": 300,
          "x": 1666735200000
        },
        {
          "y": 76,
          "x": 1666821600000
        }
      ]
    }
  ],
  "credits": {
    "enabled": false
  },
  "chart": {
    "backgroundColor": "transparent",
    "style": {
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "title": {
    "align": "left",
    "useHTML": true,
    "text": "Number of mentions (line)",
    "style": {
      "fontSize": "14px",
      "fontWeight": "600"
    }
  },
  "time": {
    "timezone": "Europe/Budapest"
  },
  "plotOptions": {
    "series": {
      "cursor": "pointer",
      "marker": {
        "enabled": false
      }
    }
  },
  "tooltip": {
    "useHTML": true,
    "shadow": false,
    "followPointer": true,
    "style": {
      "fontSize": "12px",
      "fontFamily": "Proxima-Nova, sans-serif",
      "color": "#424454"
    },
    "headerFormat": "{point.x:%Y-%m-%d} - ",
    "pointFormat": "Number of mentions: {point.y} pcs"
  },
  "legend": {
    "enabled": true,
    "labelFormat": "{options.label}"
  },
  "caption": {
    "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
    "useHTML": true,
    "style": {
      "fontSize": "12px",
      "color": "#525E6D",
      "paddingTop": "10px",
      "paddingRight": "10px",
      "borderTop": "1px solid #d8dce8",
      "fontFamily": "Proxima-Nova, sans-serif"
    }
  },
  "xAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 0,
    "type": "datetime",
    "dateTimeLabelFormats": {
      "day": "%m.%d.",
      "week": "%m.%d.",
      "month": "%m.%d.",
      "year": "%m.%d."
    },
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    }
  },
  "yAxis": {
    "lineWidth": 0,
    "tickWidth": 0,
    "startOnTick": false,
    "endOnTick": false,
    "gridLineWidth": 1,
    "gridLineColor": "#d8dce8",
    "labels": {
      "align": "center",
      "style": {
        "color": "#9fa7bc"
      }
    },
    "title": {
      "text": null
    }
  }
}

Referenced entities by ChartData

SeriesOptions (struct)
Property	Type	Comment
name	string	-
label	string	-
color	string	-
type	string	-
data	PointOptions[]	-

Example:

{
  "name": "Demo keyword",
  "label": "Demo keyword (2140 pcs)",
  "color": "#D5372C",
  "type": "line",
  "data": [
    {
      "y": 422,
      "x": 1666216800000
    },
    {
      "y": 327,
      "x": 1666303200000
    },
    {
      "y": 202,
      "x": 1666389600000
    },
    {
      "y": 174,
      "x": 1666476000000
    },
    {
      "y": 316,
      "x": 1666562400000
    },
    {
      "y": 323,
      "x": 1666648800000
    },
    {
      "y": 300,
      "x": 1666735200000
    },
    {
      "y": 76,
      "x": 1666821600000
    }
  ]
}

Referenced entities by SeriesOptions

PointOptions (struct)
Property	Type	Comment
x	number	-
y	number	-

Example:

{
  "x": 0,
  "y": 0
}

CreditsOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

ChartOptions (struct)
Property	Type	Comment
backgroundColor	string	-
style	ChartStyleOptions	-

Example:

{
  "backgroundColor": "transparent",
  "style": {
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by ChartOptions

ChartStyleOptions (struct)
Property	Type	Comment
fontFamily	string	-

Example:

{
  "fontFamily": "Proxima-Nova, sans-serif"
}

TitleOptions (struct)
Property	Type	Comment
align	string	-
useHTML	boolean	-
text	string	-
style	TitleStyleOptions	-

Example:

{
  "align": "left",
  "useHTML": true,
  "text": "Number of mentions (line)",
  "style": {
    "fontSize": "14px",
    "fontWeight": "600"
  }
}

Referenced entities by TitleOptions

TitleStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontWeight	string	-

Example:

{
  "fontSize": "14px",
  "fontWeight": "600"
}

TimeOptions (struct)
Property	Type	Comment
timezone	string	-

Example:

{
  "timezone": "Europe/Budapest"
}

PlotOptions (struct)
Property	Type	Comment
series	SeriesPlotOptions	-

Example:

{
  "series": {
    "cursor": "pointer",
    "marker": {
      "enabled": false
    }
  }
}

Referenced entities by PlotOptions

SeriesPlotOptions (struct)
Property	Type	Comment
cursor	string	-
marker	MarkerOptions	-

Example:

{
  "cursor": "pointer",
  "marker": {
    "enabled": false
  }
}

Referenced entities by SeriesPlotOptions

MarkerOptions (struct)
Property	Type	Comment
enabled	boolean	-

Example:

{
  "enabled": false
}

TooltipOptions (struct)
Property	Type	Comment
useHTML	boolean	-
shadow	boolean	-
followPointer	boolean	-
style	TooltipStyleOptions	-
headerFormat	string	-
pointFormat	string	-

Example:

{
  "useHTML": true,
  "shadow": false,
  "followPointer": true,
  "style": {
    "fontSize": "12px",
    "fontFamily": "Proxima-Nova, sans-serif",
    "color": "#424454"
  },
  "headerFormat": "{point.x:%Y-%m-%d} - ",
  "pointFormat": "Number of mentions: {point.y} pcs"
}

Referenced entities by TooltipOptions

TooltipStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
fontFamily	string	-
color	string	-

Example:

{
  "fontSize": "12px",
  "fontFamily": "Proxima-Nova, sans-serif",
  "color": "#424454"
}

LegendOptions (struct)
Property	Type	Comment
enabled	boolean	-
labelFormat	string	-

Example:

{
  "enabled": true,
  "labelFormat": "{options.label}"
}

CaptionOptions (struct)
Property	Type	Comment
text	string	-
useHTML	boolean	-
style	CaptionStyleOptions	-

Example:

{
  "text": "The Number of mentions chart shows the frequency of mentions according to a given keyword. The X-axis is time; the Y-axis is the number of mentions.",
  "useHTML": true,
  "style": {
    "fontSize": "12px",
    "color": "#525E6D",
    "paddingTop": "10px",
    "paddingRight": "10px",
    "borderTop": "1px solid #d8dce8",
    "fontFamily": "Proxima-Nova, sans-serif"
  }
}

Referenced entities by CaptionOptions

CaptionStyleOptions (struct)
Property	Type	Comment
fontSize	string	-
color	string	-
paddingTop	string	-
paddingRight	string	-
borderTop	string	-
fontFamily	string	-

Example:

{
  "fontSize": "12px",
  "color": "#525E6D",
  "paddingTop": "10px",
  "paddingRight": "10px",
  "borderTop": "1px solid #d8dce8",
  "fontFamily": "Proxima-Nova, sans-serif"
}

XAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
type	string	-
dateTimeLabelFormats	DateTimeLabelFormatOptions	-
labels	AxisLabelOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 0,
  "type": "datetime",
  "dateTimeLabelFormats": {
    "day": "%m.%d.",
    "week": "%m.%d.",
    "month": "%m.%d.",
    "year": "%m.%d."
  },
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  }
}

Referenced entities by XAxisOptions

DateTimeLabelFormatOptions (struct)
Property	Type	Comment
day	string	-
week	string	-
month	string	-
year	string	-

Example:

{
  "day": "%m.%d.",
  "week": "%m.%d.",
  "month": "%m.%d.",
  "year": "%m.%d."
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

YAxisOptions (struct)
Property	Type	Comment
lineWidth	number	-
tickWidth	number	-
startOnTick	boolean	-
endOnTick	boolean	-
gridLineWidth	number	-
gridLineColor	string	-
labels	AxisLabelOptions	-
title	YAxisTitleOptions	-

Example:

{
  "lineWidth": 0,
  "tickWidth": 0,
  "startOnTick": false,
  "endOnTick": false,
  "gridLineWidth": 1,
  "gridLineColor": "#d8dce8",
  "labels": {
    "align": "center",
    "style": {
      "color": "#9fa7bc"
    }
  },
  "title": {
    "text": null
  }
}

Referenced entities by YAxisOptions

YAxisTitleOptions (struct)
Property	Type	Comment
text	string	-

Example:

{
  "text": null
}

AxisLabelOptions (struct)
Property	Type	Comment
align	string	-
style	AxisLabelStyleOptions	-

Example:

{
  "align": "center",
  "style": {
    "color": "#9fa7bc"
  }
}

Referenced entities by AxisLabelOptions

AxisLabelStyleOptions (struct)
Property	Type	Comment
color	string	-

Example:

{
  "color": "#9fa7bc"
}

Deleted Mention Logs

Provides an interface to interact with the logs of the deleted mentions stored in our databases.

Listing deleted mention logs

 GET /deleted-mention-logs

Returns a list of deleted mention log entries. Each entry contains metadata about the deletion and restoration process, including the associated profile, timestamps, and user information. The response also lists the specific mentions that were deleted, grouped by keyword and (optionally) aspect.

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

profileId

required

number

Filter by a profile.

Example:

{
  "profileId": 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!):

profileId=0

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

/deleted-mention-logs?profileId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/deleted-mention-logs?profileId=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/deleted-mention-logs?profileId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/deleted-mention-logs?profileId=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/deleted-mention-logs?profileId=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	DeletedMentionLog[]	The resource model(s).
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    {
      "id": 0,
      "profileId": 0,
      "createdBy": 0,
      "createdByEmail": "demo@email.com",
      "createdAtUtcMs": 0,
      "restoredBy": null,
      "restoredByEmail": null,
      "restoredAtUtcMs": null,
      "mentionsDeleted": [
        {
          "keywordId": 0,
          "aspectId": 0,
          "mentionIds": [
            0
          ]
        }
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

DeletedMentionLog (struct)
Property	Type	Comment
id	number	The identifier of the deleted mention log
profileId	number	The identifier of the profile this keyword belongs to.
createdBy	number	The identifier of the user who deleted the mentions
createdByEmail	string	The email address of the user who deleted the mentions
createdAtUtcMs	number	The deletion time in milliseconds, GMT
restoredBy	null\|number	The identifier of the user who restored the mentions
restoredByEmail	string\|null	The email address of the user who restored the mentions
restoredAtUtcMs	null\|number	The restoration time in milliseconds, GMT
mentionsDeleted	DeletedMentionLogDetails[]	-

Example:

{
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
}

Referenced entities by DeletedMentionLog

DeletedMentionLogDetails (struct)
Property	Type	Comment
keywordId	number	The identifier of the keyword the mention(s) belong to
aspectId	null\|number	The identifier of the aspect the mention(s) belong to
mentionIds	number[]	The identifiers of the deleted mentions

Example:

{
  "keywordId": 0,
  "aspectId": 0,
  "mentionIds": [
    0
  ]
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "profileId": 0,
      "createdBy": 0,
      "createdByEmail": "demo@email.com",
      "createdAtUtcMs": 0,
      "restoredBy": null,
      "restoredByEmail": null,
      "restoredAtUtcMs": null,
      "mentionsDeleted": [
        {
          "keywordId": 0,
          "aspectId": 0,
          "mentionIds": [
            0
          ]
        }
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

DeletedMentionLog (struct)
Property	Type	Comment
id	number	The identifier of the deleted mention log
profileId	number	The identifier of the profile this keyword belongs to.
createdBy	number	The identifier of the user who deleted the mentions
createdByEmail	string	The email address of the user who deleted the mentions
createdAtUtcMs	number	The deletion time in milliseconds, GMT
restoredBy	null\|number	The identifier of the user who restored the mentions
restoredByEmail	string\|null	The email address of the user who restored the mentions
restoredAtUtcMs	null\|number	The restoration time in milliseconds, GMT
mentionsDeleted	DeletedMentionLogDetails[]	-

Example:

{
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
}

Referenced entities by DeletedMentionLog

DeletedMentionLogDetails (struct)
Property	Type	Comment
keywordId	number	The identifier of the keyword the mention(s) belong to
aspectId	null\|number	The identifier of the aspect the mention(s) belong to
mentionIds	number[]	The identifiers of the deleted mentions

Example:

{
  "keywordId": 0,
  "aspectId": 0,
  "mentionIds": [
    0
  ]
}

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

Example:

{
  "data": [
    {
      "id": 0,
      "profileId": 0,
      "createdBy": 0,
      "createdByEmail": "demo@email.com",
      "createdAtUtcMs": 0,
      "restoredBy": null,
      "restoredByEmail": null,
      "restoredAtUtcMs": null,
      "mentionsDeleted": [
        {
          "keywordId": 0,
          "aspectId": 0,
          "mentionIds": [
            0
          ]
        }
      ]
    }
  ],
  "meta": null,
  "error": null
}

Referenced entities by ApiPayload

DeletedMentionLog (struct)
Property	Type	Comment
id	number	The identifier of the deleted mention log
profileId	number	The identifier of the profile this keyword belongs to.
createdBy	number	The identifier of the user who deleted the mentions
createdByEmail	string	The email address of the user who deleted the mentions
createdAtUtcMs	number	The deletion time in milliseconds, GMT
restoredBy	null\|number	The identifier of the user who restored the mentions
restoredByEmail	string\|null	The email address of the user who restored the mentions
restoredAtUtcMs	null\|number	The restoration time in milliseconds, GMT
mentionsDeleted	DeletedMentionLogDetails[]	-

Example:

{
  "id": 0,
  "profileId": 0,
  "createdBy": 0,
  "createdByEmail": "demo@email.com",
  "createdAtUtcMs": 0,
  "restoredBy": null,
  "restoredByEmail": null,
  "restoredAtUtcMs": null,
  "mentionsDeleted": [
    {
      "keywordId": 0,
      "aspectId": 0,
      "mentionIds": [
        0
      ]
    }
  ]
}

Referenced entities by DeletedMentionLog

DeletedMentionLogDetails (struct)
Property	Type	Comment
keywordId	number	The identifier of the keyword the mention(s) belong to
aspectId	null\|number	The identifier of the aspect the mention(s) belong to
mentionIds	number[]	The identifiers of the deleted mentions

Example:

{
  "keywordId": 0,
  "aspectId": 0,
  "mentionIds": [
    0
  ]
}

Keyword filter suggestions

Listing filter suggestions

 GET /keyword-filters-suggestions

This endpoint returns filter suggestions based on the given filters of the provided keyword.

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

keywordId

required

number

Filter by a keyword.

Example:

{
  "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!):

keywordId=0

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

/keyword-filters-suggestions?keywordId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/keyword-filters-suggestions?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/keyword-filters-suggestions?keywordId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/keyword-filters-suggestions?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/keyword-filters-suggestions?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	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

Synonym suggestions

Listing synonym suggestions

 GET /synonyms-suggestions

This endpoint returns synonym suggestions based on the given synonyms of the provided keyword or aspect group.

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

keywordId

omitable

number

Filter by a keyword.

aspectGroupId

omitable

number

Filter by an aspect group.

Example:

{
  "keywordId": 0,
  "aspectGroupId": 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!):

keywordId=0&aspectGroupId=0

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

/synonyms-suggestions?keywordId=0&aspectGroupId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/synonyms-suggestions?keywordId=0&aspectGroupId=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/synonyms-suggestions?keywordId=0&aspectGroupId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/synonyms-suggestions?keywordId=0&aspectGroupId=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/synonyms-suggestions?keywordId=0&aspectGroupId=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	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

Exclude suggestions

Listing exclude suggestions

 GET /excludes-suggestions

This endpoint returns exclude suggestions based on the given excludes of the provided keyword or aspect group.

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

keywordId

omitable

number

Filter by a keyword.

aspectGroupId

omitable

number

Filter by an aspect group.

Example:

{
  "keywordId": 0,
  "aspectGroupId": 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!):

keywordId=0&aspectGroupId=0

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

/excludes-suggestions?keywordId=0&aspectGroupId=0


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

const config = {
  method: 'get',
  url: 'https://data.skema.co.id/24.04/excludes-suggestions?keywordId=0&aspectGroupId=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/excludes-suggestions?keywordId=0&aspectGroupId=0")
  .header("X-Requested-With", "XMLHttpRequest")
  .header("Authorization", "Basic RXhhbXBsZUFwaUtleV9fbG5SRVFJSTZ5SmpNWmI0SzQ6")
  .asString(); 
      import requests

url = "https://data.skema.co.id/24.04/excludes-suggestions?keywordId=0&aspectGroupId=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/excludes-suggestions?keywordId=0&aspectGroupId=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	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}

ApiPayload (struct)
Property	Type	Comment
data	string[]	List of words.
meta		Any model/infromation related to the data.
error		Contains error information on unsuccessful requests.

Example:

{
  "data": [
    "demo",
    "DEMO"
  ],
  "meta": null,
  "error": null
}