{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"f04b56ba-8ea8-41d3-84b8-372ead4cf612","name":"Socialinsider API","description":"The Socialinsider Analytics API can be used to programatically retrieve data from the social profiles added to your Socialinsider account.\n\nThis API is based on JSON-RPC.\n\n# Authentication\n\nTo get your API key please reach out to your Account Manager.\n\nYou'll authenticate the calls to the Socialinsider API by providing your API key in the request header: Authorization: Bearer Never share the API key. Keep it secure.\n\nAlso - make sure to set the \"Content-Type\" header to \"application/json\" Eg: Content-Type: application/json\n\n# Concepts\n\n**Profile** - this is the basic unit in Socialinsider: a social profile.  \nCan be one of a:\n\n- Facebook page (competitor or owned)\n    \n- Instagram business profile (competitor or owned)\n    \n- Twitter profile (competitor or owned)\n    \n- YouTube channel\n    \n- TikTok profile\n    \n- LinkedIn business page.\n    \n\nYou can add profiles to projects to group them - for instance each client of an agency can have a project where all the profiles related to that client reside.\n\nIn the Socialinsider app you can add the profiles by their social url or handle for most of the social networks (eg. [https://www.facebook.com/netflix](https://www.facebook.com/netflix))\n\nA profile contains the following info:\n\n- id - **this is what you will use in API calls to get posts and metrics**\n    \n- name\n    \n- profile_type. Can be one of 'facebook_page', 'facebook_page_own', 'instagram_profile', 'instagram_profile_own', 'twitter_profile', 'twitter_profile_own', 'youtube_channel', 'linkedin_page', 'tiktok_profile'\n    \n- profile_added. The date when the profile was added to Socialinsider.\n    \n\nThe ids are on different platforms:\n\n- Facebook: the name is the page id that the Facebook API returns ex: 1427239247394\n    \n- Instagram: the name is the instagram username ex: netflix\n    \n- Twitter: the name is the id_str field that the Twitter API returns ex: 584372\n    \n- LinkedIn: the name is the business page id returned by the LinkedIn API\n    \n- YouTube: the name is the channel id\n    \n- TikTok: the name is the username of the profile ex: washingtonpost\n    \n\nThe names are on different platforms:\n\n- Facebook: the name is either the field name or username or global_brand_page_name\n    \n- Instagram: the name is the Instagram username ex: netflix\n    \n- Twitter: the name is the name of the profile returned by the Twitter ex: netflix\n    \n- LinkedIn: the name is the business page name returned by the LinkedIn API\n    \n- YouTube: the name is the channel title\n    \n- TikTok: the name is the username of the profile ex: washingtonpost\n    \n\n**Project** - a logical way of grouping related profiles.\n\n**Post** - these are the social posts that a profile publishes and that we retrieve.\n\n**Campaign** (tag) - You can assign to each post one (or more) campaigns or tags.  \nThis way you can group several logically related posts ie. 'black friday' posts and report on their performance.\n\n**Brand** - another way of grouping social profiles that belong to the same company, within a project.\n\nFor instance, if your client is Netflix and you add the client's 5 social profiles (facebook, instagram, twitter, youtube and tiktok) to a project with the name 'Streaming services'.  \nThen you can add some of its competitors like Hulu and HBO and their social profiles and group them into their respective brands.\n\nThe project structure will look like this:\n\n```\nProject: \n{\n    \"projectname\": \"Streaming services\"\n    \"profiles\": [\n    {\n        \"id\": \"134983140934\",\n        \"name\": 'netflix',\n        ...\n    },\n    {\n        \"name\": \"hulu\",\n        ...\n    }\n    ...\n    ],\n    \"brands\": [\n        {\n            \"brandname\": \"netflix\",\n            \"profiles\": [] \n        }\n        ...\n    ]\n}\n\n ```\n\nThe date object has the fields:\n\n```\n{\n    start: [timestamp milliseconds],\n    end: [timestamp milliseconds],\n    timezone: [IANA Timezone]\n}\n\n ```\n\nThe dates (start and end) should be sent as a unix timestamp - in **milliseconds** (Eg: 1524830695000)\n\nThe timezones should be sent in IANA format  \n`console.log(Intl.DateTimeFormat().resolvedOptions().timeZone)`\n\nMore info on timezones:\n\n- [IANA website](https://www.iana.org/time-zones)\n    \n- [Mozilla DateTimeFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions)\n    \n\n# Limitations\n\n- Twitter API does not allow to get tweets, only tweet IDS and you need to hydrate the tweets on your end\n    \n- Followers evolution is not available for history periods. Only for Facebook pages that are authorised is this available\n    \n- Instagram limitations: All engagement is organic\n    \n- Instagram limitations: Stories are only available after an Instagram business profile was authorised","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"39513773","team":6536113,"collectionId":"f04b56ba-8ea8-41d3-84b8-372ead4cf612","publishedId":"2sAY4yfM98","public":true,"publicUrl":"https://api-docs.socialinsider.io","privateUrl":"https://go.postman.co/documentation/39513773-f04b56ba-8ea8-41d3-84b8-372ead4cf612","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"Socialinsider API Docs"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/151af42f-acc6-4104-9a2b-939cb4b37d83/bG9nbyAoMSkucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/ae970fc9-fb44-422e-ae15-df82850cd60f/bG9nby5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-12-09T08:30:38.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Socialinsider API Docs","description":""},"logos":{"logoLight":"https://content.pstmn.io/ae970fc9-fb44-422e-ae15-df82850cd60f/bG9nby5wbmc=","logoDark":"https://content.pstmn.io/151af42f-acc6-4104-9a2b-939cb4b37d83/bG9nbyAoMSkucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/d19fca9d11656178e380e192f748f279056828f4fc031915decbe7b1b61bc837","favicon":"https://socialinsider.io/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://api-docs.socialinsider.io/view/metadata/2sAY4yfM98"}