{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"242b15fb-220a-45bf-8e23-0affe24dc5fd","name":"Vista Social API","description":"Vista Social API provides an externally accessible API for you to access your owned social profile data so you can use that data to power dashboards and automate your reporting.\n\nBy developing or accessing these endpoints, you are acknowledging that you have read and agreed to the [developer terms](https://vistasocial.com/api-terms-of-service/).\n\nAvailable data overview\n\n✅ Vista Social API includes:\n\n- ✅ **Owned Profile Data** - This matches the data available in Vista Social's Social Media Performance report.\n    \n- ✅ **Post Data** - This matches the data available in Vista Social's Post Performance Report.\n    \n- ✅ **Comment Data** - Get detailed information, including metadata, about your post comments.\n    \n- ✅ **Schedule Posts** - Schedule posts to profiles connected to your Vista Social account.\n    \n\n🚫 Vista Social API does not currently include:\n\n- 🚫 Paid (Ad Account) data\n    \n- 🚫 Data from X\n    \n\nBefore accessing the API, **your account must be provisioned for API use by your Vista Social account representative**.\n\n## Authentication\n\nVista Social API supports 2 forms of authentication:\n\n- API Key (api key can be generated from in Settings > Integrations)\n    \n- OAuth 2.0 (please contact support to setup your oauth 2.0 client)\n    \n\n#### API Key Authentication\n\nPass \"api-key\" header on every request\n\nOAuth 2.0 Authentication\n\n- Authorize: [https://vistasocial.com/api/oauth/authorize](https://vistasocial.com/api/oauth/authorize)\n    \n- Token: [https://vistasocial.com/api/oauth/token](https://vistasocial.com/api/oauth/token)\n    \n- Who am I (debug): [https://vistasocial.com/api/oauth/me](https://vistasocial.com/api/oauth/me)\n    \n\n**Authorization Code Flow (PKCE S256)**\n\n**1) Redirect user to authorize**\n\nGET [https://vistasocial.com/api/oauth/authorize](https://vistasocial.com/api/oauth/authorize)\n\nQuery params\n\n- response_type: code\n    \n- client_id: your OAuth client id\n    \n- redirect_uri: must match one of the client’s allowed redirect URIs\n    \n- scope: space-delimited scopes (optional)\n    \n- state: opaque value returned back unchanged (recommended)\n    \n- code_challenge: PKCE challenge (required by many clients)\n    \n- code_challenge_method: must be S256\n    \n- resource: optional resource indicator (e.g. your MCP server URL)\n    \n\n**2) Authorization redirect response**\n\nAfter the user signs in and approves, Vista Social redirects back to redirect_uri with:\n\n- code\n    \n- state (if provided)\n    \n\n**3) Exchange code for tokens (PKCE)**\n\nPOST [https://vistasocial.com/api/oauth/token](https://vistasocial.com/api/oauth/tokenHeaders)\n\nHeaders\n\n- Content-Type: application/x-www-form-urlencoded\n    \n- Client authentication: either Basic Auth or client_id/client_secret in body\n    \n\nBody (x-www-form-urlencoded)\n\n- grant_type: authorization_code\n    \n- code: authorization code from step 2\n    \n- redirect_uri: must match what you used in step 1\n    \n- code_verifier: PKCE verifier (required when PKCE was used)\n    \n- resource: optional; if provided must match what was authorized\n    \n\n**Refresh Token\n\n**POST [https://vistasocial.com/api/oauth/token](https://vistasocial.com/api/oauth/token)\n\nBody\n\n- grant_type: refresh_token\n    \n- refresh_token: refresh token previously issued\n    \n\n**Notes**\n\n- Tokens are opaque strings (not JWTs). Access tokens are prefixed with tk_ and refresh tokens with rt_.\n    \n- PKCE S256 is supported and enforced when code_challenge is used during authorization.\n    \n- state is returned back unchanged and should be used to prevent CSRF and to correlate requests.\n    \n- redirect_uri must match the client’s allowed redirect URIs.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"8001366","team":1029699,"collectionId":"242b15fb-220a-45bf-8e23-0affe24dc5fd","publishedId":"2sAYkKKJk6","public":true,"publicUrl":"https://apidocs.vistasocial.com","privateUrl":"https://go.postman.co/documentation/8001366-242b15fb-220a-45bf-8e23-0affe24dc5fd","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.11.4","publishDate":"2025-12-22T15:00:46.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"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/f25994144d637b5b258a272789be3473a4f18916b945792e772cbb83761a1c4e","favicon":"https://vistasocial.com/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://apidocs.vistasocial.com/view/metadata/2sAYkKKJk6"}