From 101347a5e505b8dbce97e770a62a441104e52603 Mon Sep 17 00:00:00 2001 From: Andrei Radu <37000326+brospresident@users.noreply.github.com> Date: Tue, 31 Oct 2023 15:59:01 +0200 Subject: [PATCH] Socialinsider connector (#3015) * [new] added Socialinsider connector * [fix] readme --- certified-connectors/Socialinsider/README.md | 28 +++ .../Socialinsider/apiDefinition.swagger.json | 227 ++++++++++++++++++ .../Socialinsider/apiProperties.json | 23 ++ 3 files changed, 278 insertions(+) create mode 100644 certified-connectors/Socialinsider/README.md create mode 100644 certified-connectors/Socialinsider/apiDefinition.swagger.json create mode 100644 certified-connectors/Socialinsider/apiProperties.json diff --git a/certified-connectors/Socialinsider/README.md b/certified-connectors/Socialinsider/README.md new file mode 100644 index 0000000000..b4375d7795 --- /dev/null +++ b/certified-connectors/Socialinsider/README.md @@ -0,0 +1,28 @@ +# Socialinsider Analytics + +Socialinsider combines social intelligence, analytics, benchmarking and listening into one single platform. +Optimize your social media strategy. Get advanced analytics and in-depth listening insights. + +## Publisher +Socialinsider + +## Prerequisites +You will need the following to proceed: +- Create an account at https://app.socialinsider.io +- Contact us to get your Power Bi key + +## Supported operations +This connector supports the following operations: +- `Profile time based metrics`: this shows information about a given profile +- `Profiles aggregated metrics`: this shows aggregated information about profiles in a project +- `Posts`: this shows a list of posts from a profile +- `Stories`: this shows the stories of an authorized Instagram account + +## Obtaining credentials +Contact us to get your Power Bi key. Each request you do from Power Bi will ask for a key. You have to type that key. + +## Known issues and limitations +You cannot access campaigns from your Socialinsider projects. + +## Deployment instructions +Deploy the Socialinsider Analytics Connector as a custom connector in Microsoft Power Automate and Power Apps as detailed in [Microsoft Power Platform Connectors CLI](https://docs.microsoft.com/en-us/connectors/custom-connectors/paconn-cli) \ No newline at end of file diff --git a/certified-connectors/Socialinsider/apiDefinition.swagger.json b/certified-connectors/Socialinsider/apiDefinition.swagger.json new file mode 100644 index 0000000000..cd496966ca --- /dev/null +++ b/certified-connectors/Socialinsider/apiDefinition.swagger.json @@ -0,0 +1,227 @@ +{ + "swagger": "2.0", + "info": { + "title": "Socialinsider", + "description": "The Socialinsider Analytics connector makes adding your competitive social metrics to dashboards painless. Start a free trial here: https://app.socialinsider.io/signup/", + "version": "1.0", + "contact": { + "name": "Andrei Serbanoiu", + "email": "andrei@socialinsider.io", + "url": "https://app.socialinsider.io" + } + }, + "host": "app.socialinsider.io", + "basePath": "/powerbi", + "schemes": [ + "https" + ], + "consumes": [ + "application/json" + ], + "produces": [], + "paths": { + "/": {}, + "/profile_time_based_metrics": { + "post": { + "responses": { + "default": { + "description": "default", + "schema": {} + } + }, + "summary": "Profile time based metrics", + "description": "Get profile time based metrics from Socialinsider Analytics", + "operationId": "Profile-time-based-metrics", + "parameters": [ + { + "name": "body", + "in": "body", + "required": false, + "schema": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "key" + }, + "projectname": { + "type": "string", + "description": "projectname" + }, + "platform": { + "type": "string", + "description": "platform" + }, + "profile": { + "type": "array", + "items": { + "type": "string" + }, + "description": "profile" + } + } + } + } + ] + } + }, + "/profiles_aggregated_metrics": { + "post": { + "responses": { + "default": { + "description": "default", + "schema": {} + } + }, + "summary": "Profile aggregated metrics", + "description": "Get profile aggregated metrics", + "operationId": "Profile-aggregated-metrics", + "parameters": [ + { + "name": "body", + "in": "body", + "required": false, + "schema": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "key" + }, + "projectname": { + "type": "string", + "description": "projectname" + }, + "platform": { + "type": "string", + "description": "platform" + }, + "profiles": { + "type": "array", + "items": { + "type": "string" + }, + "description": "profiles" + } + } + } + } + ] + } + }, + "/posts": { + "post": { + "responses": { + "default": { + "description": "default", + "schema": {} + } + }, + "summary": "Posts", + "description": "Get posts with Socialinsider Analytics", + "operationId": "Posts", + "parameters": [ + { + "name": "body", + "in": "body", + "required": false, + "schema": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "key" + }, + "projectname": { + "type": "string", + "description": "projectname" + }, + "platform": { + "type": "string", + "description": "platform" + }, + "profiles": { + "type": "array", + "items": { + "type": "string" + }, + "description": "profiles" + } + } + } + } + ] + } + }, + "/stories": { + "post": { + "responses": { + "default": { + "description": "default", + "schema": {} + } + }, + "summary": "Stories", + "description": "Get instagram stories with Socialinsider Analytics", + "operationId": "Stories", + "parameters": [ + { + "name": "body", + "in": "body", + "required": false, + "schema": { + "type": "object", + "properties": { + "key": { + "type": "string", + "description": "key" + }, + "projectname": { + "type": "string", + "description": "projectname" + }, + "profiles": { + "type": "array", + "items": { + "type": "string" + }, + "description": "profiles" + } + } + } + } + ] + } + } + }, + "definitions": {}, + "parameters": {}, + "responses": {}, + "securityDefinitions": { + "API Key": { + "type": "apiKey", + "in": "query", + "name": "key" + } + }, + "security": [ + { + "API Key": [] + } + ], + "tags": [], + "x-ms-connector-metadata": [ + { + "propertyName": "Website", + "propertyValue": "https://app.socialinsider.io" + }, + { + "propertyName": "Privacy policy", + "propertyValue": "https://www.socialinsider.io/privacy" + }, + { + "propertyName": "Categories", + "propertyValue": "Social media" + } + ] +} \ No newline at end of file diff --git a/certified-connectors/Socialinsider/apiProperties.json b/certified-connectors/Socialinsider/apiProperties.json new file mode 100644 index 0000000000..36f1de0438 --- /dev/null +++ b/certified-connectors/Socialinsider/apiProperties.json @@ -0,0 +1,23 @@ +{ + "properties": { + "connectionParameters": { + "api_key": { + "type": "securestring", + "uiDefinition": { + "displayName": "Your PowerBI key", + "description": "The Your PowerBI key for this api", + "tooltip": "Provide your Your PowerBI key", + "constraints": { + "tabIndex": 2, + "clearText": false, + "required": "true" + } + } + } + }, + "iconBrandColor": "#fbaf3a", + "capabilities": [], + "publisher": "Socialinsider", + "stackOwner": "Socialinsider" + } +} \ No newline at end of file