{"info":{"_postman_id":"b4ccc41c-ea47-4152-bdf8-d5bf1c8908e2","name":"Mediatoolkit API v1","description":"

Documentation for Mediatoolkit (https://www.mediatoolkit.com) API v1.

You will need access token for all your API calls.

You can find one in your user settings - https://www.mediatoolkit.com/dashboard#/account-settings/user/

If you don't have an account, create one here: https://www.mediatoolkit.com/signup

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7210955","collectionId":"b4ccc41c-ea47-4152-bdf8-d5bf1c8908e2","publishedId":"S1EMUebv","public":true,"customColor":{"top-bar":"4573D9","right-sidebar":"30394D","highlight":"3BBE75"},"publishDate":"2019-04-10T09:04:53.000Z"},"item":[{"name":"Categories","item":[{"name":"Get all","id":"de52a15e-28ca-44b3-affb-2e57cbbb7157","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets all organization categories.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"e8b6954b-0a96-496b-8801-10e1edec6850","name":"Get all","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 07:49:17 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"317"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 5,\n \"code\": 1,\n \"method\": \"GET /organizations/51849/categories\",\n \"data\": {\n \"total_count\": 2,\n \"categories\": [\n {\n \"name\": \"Category One\",\n \"id\": 1068,\n \"tags\": [\n {\n \"category_id\": 1,\n \"name\": \"Tag 1\",\n \"id\": 1\n }\n ]\n },\n {\n \"name\": \"Category Two\",\n \"id\": 1069,\n \"tags\": [\n {\n \"category_id\": 2,\n \"name\": \"Tag 2\",\n \"id\": 2\n }\n ]\n }\n ]\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"de52a15e-28ca-44b3-affb-2e57cbbb7157"},{"name":"Get by ID","id":"664855a6-6bc1-4b17-aacb-39ea00eb17f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets category.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If category is not in specified organization.
\n

Method creates new category.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"a9c6b3a8-9ad6-462f-ae15-65ef6828fc92","name":"Create category","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"Category Name\"\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 07:44:08 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"153"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 28,\n \"code\": 1,\n \"method\": \"POST /organizations/51849/categories\",\n \"data\": {\n \"name\": \"Category Name\",\n \"id\": 1147,\n \"tags\": []\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"9fcb6028-3de2-419e-af3e-279d1cd5e70c"},{"name":"Update category","id":"b7658d19-d1ea-41b8-9dd1-e69695da0569","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"New Category Name\"\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method updates category

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
name	string	Name of your category

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
- If category is not in specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"24518246-e93d-41b4-be55-71629c16fb8d","name":"Update category","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"New Category Name\"\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 07:46:58 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"161"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 8,\n \"code\": 1,\n \"method\": \"POST /organizations/51849/categories/1147\",\n \"data\": {\n \"name\": \"New Category Name\",\n \"id\": 1147,\n \"tags\": []\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"b7658d19-d1ea-41b8-9dd1-e69695da0569"},{"name":"Delete category","id":"985a1926-69b8-4e95-9bf8-3391348ca089","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method deletes category.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
- If category is not in specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"f72f0bea-5160-43d4-9906-b8c40efff10a","name":"Delete category","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 07:47:55 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"218"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 36,\n \"code\": 1,\n \"method\": \"DELETE /organizations/51849/categories/1147\",\n \"data\": {\n \"message_code\": \"CATEGORY_IS_REMOVED\",\n \"message_params\": {},\n \"message_transformed\": \"category is removed\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"985a1926-69b8-4e95-9bf8-3391348ca089"}],"id":"7f5f5361-7ea2-4cdc-a5d2-4b4be8e3da52","_postman_id":"7f5f5361-7ea2-4cdc-a5d2-4b4be8e3da52","description":""},{"name":"Export","item":[{"name":"Export","id":"55b53dba-4993-48ee-b649-798db171a0d0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"mentionsSource\": {\n \"dataSourceType\": \"FEED\",\n \"feedSource\": {\n \"feedType\": \"FILTERED\",\n \"fromTime\": \"FROM_TIMESTAMP\",\n \"toTime\": \"TO_TIMESTAMP\",\n \"feed\": {\n \"channelType\": \"KEYWORD\",\n \"id\": \"YOUR_KEYWORD_ID\"\n },\n \"discardSimilar\": false,\n \"postFilter\": {\n \"maySourceTypes\": [\n \"web\"\n ]\n }\n }\n },\n \"exportContent\": {\n \"exportType\": \"EXCEL\",\n \"excelExportInfo\": {\n \"columns\": [\n \"DATE\",\n \"TIME\",\n \"TITLE\",\n \"FROM\",\n \"AUTHOR\",\n \"URL\",\n \"URL_PHOTO\",\n \"SOURCE_TYPE\",\n \"GROUP_NAME\",\n \"KEYWORD_NAME\",\n \"FOUND_KEYWORDS\",\n \"LANGUAGES\",\n \"LOCATIONS\",\n \"TAGS\",\n \"MANUAL_SENTIMENT\",\n \"AUTO_SENTIMENT\",\n \"MENTION_SNIPPET\",\n \"REACH\",\n \"VIRALITY\",\n \"FOLLOWERS_COUNT\",\n \"LIKE_COUNT\",\n \"COMMENT_COUNT\",\n \"SHARE_COUNT\",\n \"TWEET_COUNT\",\n \"LOVE_COUNT\",\n \"WOW_COUNT\",\n \"HAHA_COUNT\",\n \"SAD_COUNT\",\n \"ANGRY_COUNT\",\n \"TOTAL_REACTIONS_COUNT\",\n \"FAVORITE_COUNT\",\n \"RETWEET_COUNT\",\n \"VIEW_COUNT\",\n \"DISLIKE_COUNT\",\n \"COMMENTS_COUNT\",\n \"LIKES\",\n \"DISLIKES\",\n \"COUNT\",\n \"REPOST_COUNT\",\n \"REDDIT_TYPE\",\n \"REDDIT_SCORE\",\n \"INFLUENCE_SCORE\"\n ]\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/export?access_token=YOUR_ACCESS_TOKEN","description":"

Method downloads export result.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified feed.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","export"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[],"_postman_id":"55b53dba-4993-48ee-b649-798db171a0d0"}],"id":"82838f32-1e66-48e8-9161-6446c9d6389d","event":[{"listen":"prerequest","script":{"id":"839899a9-3473-43a6-8985-3884632ae251","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"757dd01b-3ef6-47f5-a064-a4c88c9c9aa2","type":"text/javascript","exec":[""]}}],"_postman_id":"82838f32-1e66-48e8-9161-6446c9d6389d","description":""},{"name":"Groups","item":[{"name":"Get single group","id":"ecbe2286-3d06-438e-bca1-69d9421b6b02","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets group.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"08779b2d-d170-40f8-9b77-ca158245e871","name":"Get","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"2359"},{"key":"Date","value":"Thu, 11 Apr 2019 09:24:39 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 77,\n \"code\": 1,\n \"method\": \"GET /organizations/62709/groups/100526\",\n \"data\": {\n \"zeed\": null,\n \"invited_users\": [],\n \"public\": true,\n \"keywords\": [],\n \"color\": \"#ff3d00\",\n \"members\": [],\n \"name\": \"Docs\",\n \"are_all_keywords_deactivated\": false,\n \"id\": 100526\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"ecbe2286-3d06-438e-bca1-69d9421b6b02"},{"name":"Create group","id":"bfc12b70-6942-4e91-b605-79f66ecda596","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"My group\",\n\t\"public\": true\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups?access_token=YOUR_ACCESS_TOKEN","description":"

Method creates group.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to add new group to specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"b055fe23-1623-4edf-861c-988d1f24c22b","name":"Create group","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"My group\",\n\t\"public\": true\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"2365"},{"key":"Date","value":"Thu, 11 Apr 2019 09:33:36 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 290,\n \"code\": 1,\n \"method\": \"POST /organizations/62709/groups\",\n \"data\": {\n \"zeed\": null,\n \"invited_users\": [],\n \"public\": true,\n \"keywords\": [],\n \"color\": \"#00c0f3\",\n \"members\": [],\n \"name\": \"My group\",\n \"are_all_keywords_deactivated\": false,\n \"id\": 100709\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"bfc12b70-6942-4e91-b605-79f66ecda596"},{"name":"Delete group","id":"4f990109-5403-40ec-87d3-3457c50b51d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method deletes group and keywords inside group.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"db9f2615-bdc0-42e3-a511-b844a0173a30","name":"Delete group","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"211"},{"key":"Date","value":"Thu, 11 Apr 2019 09:39:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 274,\n \"code\": 1,\n \"method\": \"DELETE /organizations/62709/groups/100709\",\n \"data\": {\n \"message_code\": \"GROUP_IS_REMOVED\",\n \"message_params\": {},\n \"message_transformed\": \"group is removed\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"4f990109-5403-40ec-87d3-3457c50b51d2"}],"id":"a00df5df-76d6-4e74-ba46-e8690e3dc4fb","_postman_id":"a00df5df-76d6-4e74-ba46-e8690e3dc4fb","description":""},{"name":"Keywords","item":[{"name":"Get single keyword","id":"e170938a-0406-4871-8c2f-f934f6ed231b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets keyword.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
- If keyword does not exits in specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"b27b482a-51d5-4459-aa51-60db6dbf9eba","name":"Get","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"815"},{"key":"Date","value":"Wed, 10 Apr 2019 08:57:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 113,\n \"code\": 1,\n \"method\": \"GET /organizations/62709/groups/100526/keywords/6308371\",\n \"data\": {\n \"history_search_coverage\": [\n {\n \"end_pretty\": \"10.04.2019. 10:56:37\",\n \"start\": 1546246588,\n \"end\": 1554886597,\n \"start_pretty\": \"31.12.2018. 09:56:28\"\n }\n ],\n \"source_keyword_preset\": null,\n \"color\": \"#ff9b00\",\n \"active\": true,\n \"tracked\": true,\n \"natural_filters\": \"language:en\\nnot_site_tag:oglasnik,agregator,katalog,global\",\n \"natural_query_indented\": \"mediatoolkit\",\n \"natural_query\": \"mediatoolkit\",\n \"group_id\": 100526,\n \"edit_timestamp\": 1554886588,\n \"name\": \"Mediatoolkit KW\",\n \"definition\": {\n \"query\": {\n \"boolean\": [\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"mediatoolkit\"\n }\n }\n }\n ]\n },\n \"may_langs\": [\n \"en\"\n ],\n \"not_tags\": [\n \"oglasnik\",\n \"agregator\",\n \"katalog\",\n \"global\"\n ]\n },\n \"id\": 6308371,\n \"hash\": \"4d9c7b6b27ab2ea75dadc2bba7b215bf\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"e170938a-0406-4871-8c2f-f934f6ed231b"},{"name":"Create keyword","id":"b0967906-c1eb-4c45-ad26-386535315acd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"Keyword Name\",\n\t\"keyword\": {\n\t\t\"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\"\"\n\t}\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets keyword.

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
name	string	Name of your keyword
keyword	object	Keyword definition

Keyword Object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
natural_query	string	Natural query with operators: \"AND, OR, NEAR, AT-LEAST, NOT, (, ), \"example phrase\"/cs - ie. \"mediatoolkit AND monitoring\"
may_langs	array	Only mentions with specific language - ie. [\"EN\", \"ES\"]
may_locations	array	Only mentions from specific locations - ie. [\"GB\", \"US\"]
may_source_types	array	Only mentions from specific source types. Accepted values: [\"forum\",\"youtube\",\"trip_advisor\",\"twitter\",\"disqus\",\"web\",\"facebook\",\"reddit\",\"vkontakte\",\"comment\",\"instagram\"]
may_domains	array	Only mentions that have domain in URL - ie. [\"mediatoolkit.com\"]

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
- If keyword does not exits in specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"b879ed05-0bc5-4a6d-a95d-9e50b73e4e87","name":"Create","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"Keyword Name\",\n\t\"keyword\": {\n\t\t\"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\"\"\n\t}\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"687"},{"key":"Date","value":"Thu, 11 Apr 2019 07:57:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 73,\n \"code\": 1,\n \"method\": \"POST /organizations/62709/groups/100526/keywords\",\n \"data\": {\n \"history_search_coverage\": [],\n \"source_keyword_preset\": null,\n \"color\": \"#cd10ac\",\n \"active\": true,\n \"tracked\": true,\n \"natural_filters\": \"\",\n \"natural_query_indented\": \"mediatoolkit OR \\\"media tool kit\\\"\",\n \"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\"\",\n \"group_id\": 100526,\n \"edit_timestamp\": 1554969438,\n \"name\": \"Keyword Name\",\n \"definition\": {\n \"query\": {\n \"boolean\": [\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"mediatoolkit\"\n }\n }\n },\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"media tool kit\"\n }\n }\n }\n ]\n }\n },\n \"id\": 6308678,\n \"hash\": \"5048473cb0ca9a40461d9e59a82c42b6\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"b0967906-c1eb-4c45-ad26-386535315acd"},{"name":"Update keyword","id":"29706825-ddc4-42d4-a726-8e07eb5af14b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"keyword\": {\n\t\t\"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\" OR \\\"media toolkit\\\"\",\n\t\t\"may_locations\": [\"GB\"]\n\t}\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method changes name and/or definiton of keyword.

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
name	string	Name of your keyword
keyword	object	Keyword definition

Keyword Object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
natural_query	string	Natural query with operators: \"AND, OR, NEAR, AT-LEAST, NOT, (, ), \"example phrase\"/cs - ie. \"mediatoolkit AND monitoring\"
may_langs	array	Only mentions with specific language - ie. [\"EN\", \"ES\"]
may_locations	array	Only mentions from specific locations - ie. [\"GB\", \"US\"]
may_source_types	array	Only mentions from specific source types. Accepted values: [\"forum\",\"youtube\",\"trip_advisor\",\"twitter\",\"disqus\",\"web\",\"facebook\",\"reddit\",\"vkontakte\",\"comment\",\"instagram\"]
may_domains	array	Only mentions that have domain in URL - ie. [\"mediatoolkit.com\"]

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to update specified group.
- If keyword does not exits in specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"ddb13a01-9b24-40d8-b3cf-75280e7532b6","name":"Update","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"keyword\": {\n\t\t\"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\" OR \\\"media toolkit\\\"\",\n\t\t\"may_locations\": [\"GB\"]\n\t}\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"858"},{"key":"Date","value":"Thu, 11 Apr 2019 08:14:45 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 134,\n \"code\": 1,\n \"method\": \"POST /organizations/62709/groups/100526/keywords/6308678\",\n \"data\": {\n \"history_search_coverage\": [],\n \"source_keyword_preset\": null,\n \"color\": \"#cd10ac\",\n \"active\": true,\n \"tracked\": true,\n \"natural_filters\": \"location:GB\",\n \"natural_query_indented\": \"mediatoolkit \\nOR \\\"media tool kit\\\" \\nOR \\\"media toolkit\\\"\",\n \"natural_query\": \"mediatoolkit OR \\\"media tool kit\\\" OR \\\"media toolkit\\\"\",\n \"group_id\": 100526,\n \"edit_timestamp\": 1554970485,\n \"name\": \"Keyword Name\",\n \"definition\": {\n \"may_locations\": [\n \"GB\"\n ],\n \"query\": {\n \"boolean\": [\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"mediatoolkit\"\n }\n }\n },\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"media tool kit\"\n }\n }\n },\n {\n \"clause\": \"may\",\n \"sub\": {\n \"phrase\": {\n \"case_sensitive\": false,\n \"text\": \"media toolkit\"\n }\n }\n }\n ]\n }\n },\n \"id\": 6308678,\n \"hash\": \"b2a474ae98c6dfb1a84b5a4a986a1997\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"29706825-ddc4-42d4-a726-8e07eb5af14b"},{"name":"Delete keyword","id":"405efadf-47ed-472b-8976-a64cfd9342fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method deletes keyword.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
- If keyword does not exits in specified group.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"2b2b220a-e17a-4c3f-be63-b1aa0c32c6a9","name":"Delete keyword","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"233"},{"key":"Date","value":"Thu, 11 Apr 2019 09:42:04 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 1894,\n \"code\": 1,\n \"method\": \"DELETE /organizations/62709/groups/100526/keywords/6308724\",\n \"data\": {\n \"message_code\": \"KEYWORD_IS_REMOVED\",\n \"message_params\": {},\n \"message_transformed\": \"keyword is removed\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"405efadf-47ed-472b-8976-a64cfd9342fd"}],"id":"37d9fdd7-f6ef-4884-a067-29c150dbd0d0","description":"

Methods for keywords management.

\n","event":[{"listen":"prerequest","script":{"id":"9bc02c58-9bf7-4715-a0b2-627b4ef1cc8b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"f5957904-7634-49c2-89dd-9139d4edfb9d","type":"text/javascript","exec":[""]}}],"_postman_id":"37d9fdd7-f6ef-4884-a067-29c150dbd0d0"},{"name":"Mentions","item":[{"name":"Get keyword feed","id":"ec73a6c3-bea7-4582-a4da-1a5e3ca734cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID/mentions?access_token=YOUR_ACCESS_TOKEN&from_time=1554112458&to_time=1554976460&count=50&sort=time&type=all&offset=0&ids_only=false","description":"

Get mentions for specified keyword.

Errors:

If user does not have permission to read specified group.,
If keyword is set and does not exist in specified group.,
If specified organization currently has more users and invitations than allowed by plan.,
If current organization plan has expired (plan end date reached),
If current organization is blocked.

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID","mentions"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"},{"description":{"content":"

Optional. Timestamp or dd.MM.yyyy. HH:mm z format.

\n","type":"text/plain"},"key":"from_time","value":"1554112458"},{"description":{"content":"

Optional. Timestamp or dd.MM.yyyy. HH:mm z format.

\n","type":"text/plain"},"key":"to_time","value":"1554976460"},{"description":{"content":"

Optional. Default value 50.

\n","type":"text/plain"},"key":"count","value":"50"},{"description":{"content":"

Optional. DESC sorting. Default value \"time\". Allowed values: time, reach, virality.

\n","type":"text/plain"},"key":"sort","value":"time"},{"description":{"content":"

Optional. Default value \"all\". Allowed values: all, web, facebook, twitter, forum, comment, disqus, youtube, instagram, trip_advisor, vkontakte, reddit.

\n","type":"text/plain"},"key":"type","value":"all"},{"description":{"content":"

Optional. Default value 0.

\n","type":"text/plain"},"key":"offset","value":"0"},{"description":{"content":"

Optional. Default value false.

\n","type":"text/plain"},"key":"ids_only","value":"false"}],"variable":[]}},"response":[{"id":"70b9b483-aa25-4fd8-b7e9-7f9f725430af","name":"Get keyword feed","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/keywords/YOUR_KEYWORD_ID/mentions?access_token=YOUR_ACCESS_TOKEN&from_time=1554112458&to_time=1554976460&count=1&sort=time&type=twitter&offset=0&ids_only=false","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","keywords","YOUR_KEYWORD_ID","mentions"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."},{"key":"from_time","value":"1554112458","description":"Optional. Timestamp or dd.MM.yyyy. HH:mm z format."},{"key":"to_time","value":"1554976460","description":"Optional. Timestamp or dd.MM.yyyy. HH:mm z format."},{"key":"count","value":"1","description":"Optional. Default value 50."},{"key":"sort","value":"time","description":"Optional. DESC sorting. Default value \"time\". Allowed values: time, reach, virality."},{"key":"type","value":"twitter","description":"Optional. Default value \"all\". Allowed values: all, web, facebook, twitter, forum, comment, disqus, youtube, instagram, trip_advisor, vkontakte, reddit."},{"key":"offset","value":"0","description":"Optional. Default value 0."},{"key":"ids_only","value":"false","description":"Optional. Default value false. "}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"1655"},{"key":"Date","value":"Thu, 11 Apr 2019 09:59:54 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 177,\n \"code\": 1,\n \"method\": \"GET /organizations/62709/groups/100526/keywords/6308741/mentions\",\n \"data\": {\n \"response\": [\n {\n \"keywords\": [\n \"mediatoolkit\"\n ],\n \"reach\": 100,\n \"insert_time\": 1554884663,\n \"number_of_similars\": 0,\n \"type\": \"twitter\",\n \"title\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/ Interested in making your content better and more relevant? Use media monitoring! 😃 Find out how in the article below!💪\",\n \"retweet_count\": 0,\n \"mention\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/ Interested in making your content better and more relevant? Use media monitoring! 😃 Find out how in the article below!💪\",\n \"twitter_handle\": \"mediatoolkit\",\n \"all_keyword_feed_locations\": [\n {\n \"keyword_id\": 6308741,\n \"group_id\": 100526\n }\n ],\n \"from\": \"Mediatoolkit\",\n \"favorite_count\": 0,\n \"id\": 10997988177,\n \"auto_sentiment\": \"positive\",\n \"database_insert_time\": 1554884818,\n \"keyword_name\": \"mediatoolkit\",\n \"image\": \"https://www.mediatoolkit.com/img/50x50,sc,sljtxD4Pga0pdyL-RmFCxxpzkuYiX357h94NYPsNpnyw/http://pbs.twimg.com/profile_images/902461903460585473/eytgeU_Y_normal.jpg\",\n \"languages\": [\n \"en\"\n ],\n \"author\": \"Mediatoolkit\",\n \"full_mention\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/\\n\\nInterested in making your content better and more relevant? Use media monitoring! 😃\\nFind out how in the article below!💪\",\n \"influence_score\": 2,\n \"url\": \"https://www.twitter.com/mediatoolkit/status/1115893274768740355\",\n \"in_zeed\": false,\n \"followers_count\": 1997,\n \"tag_feed_locations\": [],\n \"interaction\": 0,\n \"locations\": [\n \"US\"\n ],\n \"similar_mentions\": [],\n \"twitter_profile_id\": \"mediatoolkit\"\n }\n ]\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"ec73a6c3-bea7-4582-a4da-1a5e3ca734cc"},{"name":"Get group feed","id":"cab0aaa6-e870-473c-9d09-7027cda432b0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/mentions?access_token=YOUR_ACCESS_TOKEN&from_time=1554112458&to_time=1554976460&count=50&sort=time&type=all&offset=0&ids_only=false","description":"

Get mentions for specified group.

Errors:

If user does not have permission to read specified group.,
If keyword is set and does not exist in specified group.,
If specified organization currently has more users and invitations than allowed by plan.,
If current organization plan has expired (plan end date reached),
If current organization is blocked.

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","mentions"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"},{"description":{"content":"

Optional. Timestamp or dd.MM.yyyy. HH:mm z format.

\n","type":"text/plain"},"key":"from_time","value":"1554112458"},{"description":{"content":"

Optional. Timestamp or dd.MM.yyyy. HH:mm z format.

\n","type":"text/plain"},"key":"to_time","value":"1554976460"},{"description":{"content":"

Optional. Default value 50.

\n","type":"text/plain"},"key":"count","value":"50"},{"description":{"content":"

Optional. DESC sorting. Default value \"time\". Allowed values: time, reach, virality.

\n","type":"text/plain"},"key":"sort","value":"time"},{"description":{"content":"

Optional. Default value \"all\". Allowed values: all, web, facebook, twitter, forum, comment, disqus, youtube, instagram, trip_advisor, vkontakte, reddit.

\n","type":"text/plain"},"key":"type","value":"all"},{"description":{"content":"

Optional. Default value 0.

\n","type":"text/plain"},"key":"offset","value":"0"},{"description":{"content":"

Optional. Default value false.

\n","type":"text/plain"},"key":"ids_only","value":"false"}],"variable":[]}},"response":[{"id":"274c040b-4234-4405-832b-68a7a449123e","name":"Get group feed","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/mentions?access_token=YOUR_ACCESS_TOKEN&from_time=1554112458&to_time=1554976460&count=1&sort=time&type=twitter&offset=0&ids_only=false","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","mentions"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."},{"key":"from_time","value":"1554112458","description":"Optional. Timestamp or dd.MM.yyyy. HH:mm z format."},{"key":"to_time","value":"1554976460","description":"Optional. Timestamp or dd.MM.yyyy. HH:mm z format."},{"key":"count","value":"1","description":"Optional. Default value 50."},{"key":"sort","value":"time","description":"Optional. DESC sorting. Default value \"time\". Allowed values: time, reach, virality."},{"key":"type","value":"twitter","description":"Optional. Default value \"all\". Allowed values: all, web, facebook, twitter, forum, comment, disqus, youtube, instagram, trip_advisor, vkontakte, reddit."},{"key":"offset","value":"0","description":"Optional. Default value 0."},{"key":"ids_only","value":"false","description":"Optional. Default value false. "}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"1660"},{"key":"Date","value":"Thu, 11 Apr 2019 10:05:21 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 62,\n \"code\": 1,\n \"method\": \"GET /organizations/62709/groups/100526/mentions\",\n \"data\": {\n \"response\": [\n {\n \"keywords\": [\n \"mediatoolkit\"\n ],\n \"reach\": 100,\n \"insert_time\": 1554884663,\n \"number_of_similars\": 0,\n \"type\": \"twitter\",\n \"title\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/ Interested in making your content better and more relevant? Use media monitoring! 😃 Find out how in the article below!💪\",\n \"retweet_count\": 0,\n \"mention\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/ Interested in making your content better and more relevant? Use media monitoring! 😃 Find out how in the article below!💪\",\n \"twitter_handle\": \"mediatoolkit\",\n \"all_keyword_feed_locations\": [\n {\n \"keyword_id\": 6308741,\n \"group_id\": 100526\n }\n ],\n \"from\": \"Mediatoolkit\",\n \"favorite_count\": 0,\n \"id\": 10997988177,\n \"auto_sentiment\": \"positive\",\n \"database_insert_time\": 1554884818,\n \"image\": \"https://www.mediatoolkit.com/img/50x50,sc,sljtxD4Pga0pdyL-RmFCxxpzkuYiX357h94NYPsNpnyw/http://pbs.twimg.com/profile_images/902461903460585473/eytgeU_Y_normal.jpg\",\n \"languages\": [\n \"en\"\n ],\n \"group_name\": \"Docs\",\n \"author\": \"Mediatoolkit\",\n \"full_mention\": \"https://www.mediatoolkit.com/blog/how-can-mediatoolkit-help-you-create-content/\\n\\nInterested in making your content better and more relevant? Use media monitoring! 😃\\nFind out how in the article below!💪\",\n \"influence_score\": 2,\n \"url\": \"https://www.twitter.com/mediatoolkit/status/1115893274768740355\",\n \"in_zeed\": false,\n \"followers_count\": 1997,\n \"tag_feed_locations\": [],\n \"interaction\": 0,\n \"locations\": [\n \"US\"\n ],\n \"keyword_names\": [\n \"mediatoolkit\"\n ],\n \"similar_mentions\": [],\n \"twitter_profile_id\": \"mediatoolkit\"\n }\n ]\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"cab0aaa6-e870-473c-9d09-7027cda432b0"},{"name":"Get single mention","id":"fbabb685-4d41-4bb0-b46e-28cd8838640c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/mentions/MENTION_TYPE/MENTION_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method returns data for single mention by type and ID.

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","mentions","MENTION_TYPE","MENTION_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[],"_postman_id":"fbabb685-4d41-4bb0-b46e-28cd8838640c"},{"name":"Set mention meta","id":"be0d4846-0814-46b9-bf55-00afc27d3e8a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"selected_mention_ids\": [\n\t\t{\n\t\t\t\"source_type\": \"instagram\",\n\t\t\t\"mention_id\": 3452284869\n\t\t},\n\t\t{\n\t\t\t\"source_type\": \"web\",\n\t\t\t\"mention_id\": 6583047235\n\t\t}\n\t],\n\t\"sentiment\": \"neutral\"\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/mentions/meta?access_token=YOUR_ACCESS_TOKEN","description":"

Set sentiment of a mention, tag mention, mark mention as irrelevant.

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
sentiment	string	Optional. Allowed values: positive, negative, neutral
irrelevant	boolean	Optional. Mark mention as irrelevant and it is removed from feed.
keyword_id	long	Optional. Set mention meta only for this keyword. Mention can be found in multiple feeds.
category_id	long	Optional. Set tag category for this mention.
tag_id	long	Optional. Set tag for this mention
selected_mention_ids	array	JSONArray of JSONObjects. Mentions you wish to set meta for.

select_mention_ids single object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
source_type	string	Type of mention. Accepted values: [\"forum\",\"youtube\",\"trip_advisor\",\"twitter\",\"disqus\",\"web\",\"facebook\",\"reddit\",\"vkontakte\",\"comment\",\"instagram\"]
mention_id	long	Mention ID

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have permission to read specified group.
- If keyword is set and does not exist in specified group.
- If user does not have read access to specified organization.
- If user's role in organizatio does not allow updates of mentions in feeds.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","mentions","meta"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"64e4fe71-67c2-4f65-91cd-b3cc44667ab6","name":"Set mention meta","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"selected_mention_ids\": [\n\t\t{\n\t\t\t\"source_type\": \"instagram\",\n\t\t\t\"mention_id\": 3452284869\n\t\t},\n\t\t{\n\t\t\t\"source_type\": \"web\",\n\t\t\t\"mention_id\": 6583047235\n\t\t}\n\t],\n\t\"sentiment\": \"neutral\"\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups/YOUR_GROUP_ID/mentions/meta?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups","YOUR_GROUP_ID","mentions","meta"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 08:32:12 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"194"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 20,\n \"code\": 1,\n \"method\": \"POST /organizations/62709/groups/105421/mentions/meta\",\n \"data\": {\n \"message_code\": \"OK\",\n \"message_params\": {},\n \"message_transformed\": \"ok\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"be0d4846-0814-46b9-bf55-00afc27d3e8a"}],"id":"9f43a662-9ee2-45e2-997e-019196f9e575","description":"

Methods for mentions.

\n","_postman_id":"9f43a662-9ee2-45e2-997e-019196f9e575"},{"name":"Organizations","item":[{"name":"Get Groups","id":"cbeb5a4e-4a75-454f-83cd-c1dbe81343ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups?access_token=YOUR_ACCESS_TOKEN","description":"

Get organization groups.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","groups"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"ec3499fd-92d6-4741-8396-d4a5134d0315","name":"Get Groups","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/groups?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","groups"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Thu, 11 Apr 2019 09:45:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 92,\n \"code\": 1,\n \"method\": \"GET /organizations/62709/groups\",\n \"data\": {\n \"groups\": [\n {\n \"public\": true,\n \"keywords\": [],\n \"color\": \"#ff3d00\",\n \"name\": \"Docs\",\n \"invited_users_emails\": [],\n \"are_all_keywords_deactivated\": false,\n \"id\": 100526,\n \"members_ids\": []\n }\n ]\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"cbeb5a4e-4a75-454f-83cd-c1dbe81343ba"}],"id":"3985e37c-7190-4b43-aaa4-3fb16c71eec5","description":"

Organization methods.

\n","_postman_id":"3985e37c-7190-4b43-aaa4-3fb16c71eec5"},{"name":"Reports","item":[{"name":"Get Report","id":"dc94eeed-3c25-4859-9d6a-7dc8edf1097e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"access_token\": \"YOUR_ACCESS_TOKEN\",\n\t\"data_request\": {\n\t\t\"source_feeds\": [{\n\t\t\t\"feed_type\": \"keyword\",\n\t\t\t\"keyword_id\": \"YOUR_KEYWORD_ID\"\n\t\t}],\n\t\t\"from_time\": \"FROM_TIMESTAMP\",\n\t\t\"to_time\": \"TO_TIMESTAMP\",\n\t\t\"time_resolution\": \"day\",\n\t\t\"dimension\": {\n\t\t\t\"dimension_type\": \"feed\",\n\t\t\t\"dimension_sort\": {\n\t\t\t\t\"sort_direction\": \"dsc\",\n\t\t\t\t\"sort_by\": \"value\"\n\t\t\t}\n\t\t},\n\t\t\"report_value\": {\n\t\t\t\"value_type\": \"count\",\n\t\t\t\"merge_operator\": \"sum\"\n\t\t}\n\t}\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/reports","description":"

Method gets report data for given request configuration.

Rate limits:
- no rate limit
\n
Errors:
- If specified organization currently has more users and invitations than allowed by plan.
- If current organization plan has expired (plan end date reached).
- If current organization is blocked.
- If plan of specified organization does not allow reports.
- If user does not have permission to read any of provided source feed.
\n

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
access_token	string	Your access token
data_request	object	Report request

data_request [object]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
from_time	int	UNIX Timestamp
to_time	int	UNIX Timestamp
time_resolution	string	Possible values: day, hour
source_feeds	array	Groups or keywords to get the report for.
dimension	object	Main dimension
sub_dimension	object	Sub dimension
report_value	object	Return value

source_feeds [array]

Array of JSON objects.\nExample element params:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
feed_type	string	Possible values: group, keyword
group_id	int	Group ID you wish to get the data for. Optional (depends on feed_type).
keyword_id	int	Group ID you wish to get the data for. Optional (depends on feed_type).

dimension/sub_dimension [object]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
dimension_type	string	Possible values: time, feed, source_type, sentiment, manual_sentiment, effective_sentiment, language, location, influencer, tag, word
dimension_sort	object	Sorting options object. Optional.
trim_options	array	Trim options array of JSON objects. Optional.

dimension_sort [object]

Sort dimension values.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
sort_by	string	Possible values: key, value
sort_direction	string	Possible values: asc, dsc

trim_options [array]

Trim dimension values.\nArray of JSON objects.\nExample object:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
trim_type	string	Possible values: top_n, non_zero, allowed, rejected, merge_other
trim_limit	int	Limit results. Optional.
trim_allowed	array	Only allow specified dimension elements. Optional.
trim_rejected	array	Reject specified dimension elements. Optional.
merge_other_options	object	Merge below rank or percentage. Optional.

merge_other_options [object]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
below_percentage	double	Merge all results below specified percentage. Optional.
after_rank	int	Merge all results below specified rank. Optional.

report_value [object]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
value_type	string	Allowed values: count, reach, virality, influence_score, interactions
merge_operator	string	Allowed values: sum, min, max, avg

","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","reports"],"host":["https://api.mediatoolkit.com"],"query":[],"variable":[]}},"response":[{"id":"823e8646-08bd-430f-91e6-798890c3517c","name":"Get Report","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"access_token\": \"YOUR_ACCESS_TOKEN\",\n\t\"data_request\": {\n\t\t\"source_feeds\": [{\n\t\t\t\"feed_type\": \"keyword\",\n\t\t\t\"keyword_id\": \"YOUR_KEYWORD_ID\"\n\t\t}],\n\t\t\"from_time\": \"FROM_TIMESTAMP\",\n\t\t\"to_time\": \"TO_TIMESTAMP\",\n\t\t\"time_resolution\": \"day\",\n\t\t\"dimension\": {\n\t\t\t\"dimension_type\": \"feed\",\n\t\t\t\"dimension_sort\": {\n\t\t\t\t\"sort_direction\": \"dsc\",\n\t\t\t\t\"sort_by\": \"value\"\n\t\t\t}\n\t\t},\n\t\t\"report_value\": {\n\t\t\t\"value_type\": \"count\",\n\t\t\t\"merge_operator\": \"sum\"\n\t\t}\n\t}\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/reports"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"1591"},{"key":"Date","value":"Tue, 30 Apr 2019 07:49:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 36,\n \"code\": 1,\n \"method\": \"POST /organizations/62709/reports\",\n \"data\": {\n \"total_value\": 101,\n \"entries\": [\n {\n \"key_type\": \"normal\",\n \"value\": 101,\n \"key\": {\n \"keyword_id\": 6308741,\n \"feed_type\": \"keyword\"\n }\n }\n ],\n \"progress\": {\n \"total\": 100,\n \"calculating_feed\": 100,\n \"done\": true,\n \"feed_done\": true,\n \"collecting_mentions\": 100,\n \"analysing_partial_slots\": 100\n },\n \"feed_slot_infos\": [\n {\n \"source_feed\": {\n \"keyword_id\": 6308741,\n \"feed_type\": \"keyword\"\n },\n \"slot_infos\": [\n {\n \"state\": \"OK\",\n \"timestamp\": 1554069600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554156000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554242400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554328800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554415200\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554501600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554588000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554674400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554760800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554847200\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1554933600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555020000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555106400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555192800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555279200\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555365600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555452000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555538400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555624800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555711200\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555797600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555884000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1555970400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556056800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556143200\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556229600\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556316000\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556402400\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556488800\n },\n {\n \"state\": \"OK\",\n \"timestamp\": 1556575200\n }\n ]\n }\n ]\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"dc94eeed-3c25-4859-9d6a-7dc8edf1097e"}],"id":"dcd52f4f-9e05-4099-aea5-d595f119a756","description":"

Reports methods.

\n","event":[{"listen":"prerequest","script":{"id":"0283c8c5-5eba-4429-9c99-cfcba1f96cfe","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"6b9ea4fc-4f08-4854-8715-81732b07e7d4","type":"text/javascript","exec":[""]}}],"_postman_id":"dcd52f4f-9e05-4099-aea5-d595f119a756"},{"name":"Tags","item":[{"name":"Get by ID","id":"3bef3ec6-4a5d-4529-8523-ffff43274fd3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method gets tag.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If tag does not exits in specified category.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"3ef088fb-6a57-46ef-9a22-019154dc1f7a","name":"Get by ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 08:02:42 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"175"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 21,\n \"code\": 1,\n \"method\": \"GET /organizations/51849/categories/1068/tags/3761\",\n \"data\": {\n \"category_id\": 1068,\n \"name\": \"New Tag Name\",\n \"id\": 3761\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"3bef3ec6-4a5d-4529-8523-ffff43274fd3"},{"name":"Create tag","id":"e5677515-1ef6-4ab6-9e92-33cbb5460cb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"Tag Name\"\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags?access_token=YOUR_ACCESS_TOKEN","description":"

Method creates new tag in category.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
- If category is not in specified organization.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"18b9fc04-492c-4632-873f-78a6dd392acb","name":"Create tag","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"Tag Name\"\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 08:00:51 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"168"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 134,\n \"code\": 1,\n \"method\": \"POST /organizations/51849/categories/1068/tags\",\n \"data\": {\n \"category_id\": 1068,\n \"name\": \"Tag Name\",\n \"id\": 3761\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"e5677515-1ef6-4ab6-9e92-33cbb5460cb1"},{"name":"Update tag","id":"433c182f-0917-4613-a43e-3455a3b80454","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"New Tag Name\"\n}"},"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method updates tag

Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name	Type	Description
name	string	Name of your tag

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
- If category is not in specified organization.
- If tag does not exist.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"description":{"content":"

Your access token.

\n","type":"text/plain"},"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"0aad312b-e3cb-4b1e-8a31-45dc43490fbf","name":"Update tag","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"name\": \"New Tag Name\"\n}"},"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN","description":"Your access token."}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 08:02:07 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"177"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 159,\n \"code\": 1,\n \"method\": \"POST /organizations/51849/categories/1068/tags/3761\",\n \"data\": {\n \"category_id\": 1068,\n \"name\": \"New Tag Name\",\n \"id\": 3761\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"433c182f-0917-4613-a43e-3455a3b80454"},{"name":"Delete tag","id":"868c6b52-ba25-4290-ad11-e14b90cab20c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","description":"

Method deletes tag.

Rate limits:
\n
- 10 requests in 1 second
- 100 requests in 60 seconds
\n
Errors:
\n
- If user does not have read access to specified organization.
- If user is not admin in specified organization.
- If category is not in specified organization.
- If tag does not exist.
\n

\n","urlObject":{"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"host":["https://api.mediatoolkit.com"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}],"variable":[]}},"response":[{"id":"fe759702-a2c2-41ce-bbd7-c855181870ee","name":"Delete tag","originalRequest":{"method":"DELETE","header":[],"url":{"raw":"https://api.mediatoolkit.com/organizations/YOUR_ORGANIZATION_ID/categories/YOUR_CATEGORY_ID/tags/YOUR_TAG_ID?access_token=YOUR_ACCESS_TOKEN","host":["https://api.mediatoolkit.com"],"path":["organizations","YOUR_ORGANIZATION_ID","categories","YOUR_CATEGORY_ID","tags","YOUR_TAG_ID"],"query":[{"key":"access_token","value":"YOUR_ACCESS_TOKEN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 31 May 2019 08:03:48 GMT"},{"key":"Content-Type","value":"application/json;charset=utf-8"},{"key":"Content-Length","value":"218"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"duration\": 53,\n \"code\": 1,\n \"method\": \"DELETE /organizations/51849/categories/1068/tags/3761\",\n \"data\": {\n \"message_code\": \"TAG_IS_REMOVED\",\n \"message_params\": {},\n \"message_transformed\": \"tag is removed\"\n },\n \"message\": \"OK\",\n \"type\": \"json\"\n}"}],"_postman_id":"868c6b52-ba25-4290-ad11-e14b90cab20c"}],"id":"3556387a-9db1-4a27-baf9-2ab8c06e45d8","_postman_id":"3556387a-9db1-4a27-baf9-2ab8c06e45d8","description":""}],"event":[{"listen":"prerequest","script":{"id":"978b7cd0-8458-413d-884a-d07086ffbc73","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c90f1e96-d766-4ccf-b9ee-a96c7a9c1f7e","type":"text/javascript","exec":[""]}}],"variable":[{"key":"api_url","value":"https://api.mediatoolkit.com"},{"key":"access_token","value":"YOUR_ACCESS_TOKEN"},{"key":"organization_id","value":"YOUR_ORGANIZATION_ID"},{"key":"group_id","value":"YOUR_GROUP_ID"},{"key":"keyword_id","value":"YOUR_KEYWORD_ID"},{"key":"mention_type","value":"MENTION_TYPE"},{"key":"mention_id","value":"MENTION_ID"},{"key":"from_time","value":"FROM_TIMESTAMP"},{"key":"to_time","value":"TO_TIMESTAMP"},{"key":"category_id","value":"YOUR_CATEGORY_ID"},{"key":"tag_id","value":"YOUR_TAG_ID"}]}