{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","description":"# AppStruct Social — read-only REST starter\n\nInspect connected channels, list draft posts, read one selected post and optionally read available analytics. These are REST GET requests. They do not exercise MCP transport or create, edit, schedule, publish, upload or delete anything.\n\n## Before the first workspace read\n\n1. Import or fork this collection into a **private workspace you control**. The public copy contains no account credentials, workspace IDs, post IDs or saved account responses.\n2. Sign in to AppStruct Social, select the intended workspace and open [API connection settings](https://appstruct.ai/dashboard/social/api/connect). An AppStruct account with Social access is required.\n3. Use a short-lived key with **social:read** for channels and posts. The optional analytics folder needs **social:analytics:read** as well. No write or publishing scope is needed for this collection. Read access includes unpublished posts in the selected workspace.\n4. In your private client environment, set **appstruct_social_api_key** to your own key. Keep it out of public collection variables, shared environment values, URLs, screenshots and examples. We do not ask you to send it to us.\n5. Use Postman desktop or an appropriate agent for this server-to-server API. Direct browser-Origin requests are rejected by AppStruct. Do not weaken the API's access settings to work around a client error.\n\n## Read requests in order\n\nThe metadata request is public. A successful metadata response does **not** verify an authenticated workspace read.\n\nRun List channels, compare its names and platforms with your intended Social workspace, then List drafts. An empty list can be correct; it does not establish that you chose the intended workspace. To read a particular draft, choose its ID from your own response and put it in **post_id** in your private environment. The collection never auto-selects a post or saves returned account data into variables.\n\nThe cursor query is disabled initially. If a response provides next_cursor, copy it into your private environment as **next_cursor**, enable the cursor query and keep the state filter unchanged. A null cursor ends the list. Use requests individually: Read one selected post needs your post_id, and analytics needs its separate scope.\n\n## Interpret the result\n\n- 401: check key resolution, expiry, revocation and workspace membership.\n- 403: inspect required scope and client transport; adding a publishing permission is unnecessary.\n- 404 on one post: check the selected ID and workspace.\n- 429: respect Retry-After rather than repeatedly sending the request.\n- Null analytics values mean unavailable, not zero. Channel totals do not measure website registrations or revenue.\n\nDo not publish your real responses or execution history as collection examples. A 200 status and a response-shape check are separate from confirming the expected resource and account.\n\n[Connection guide and draft-review exercise](https://blog.appstruct.ai/blog/social-media-mcp-server?utm_source=postman&utm_medium=referral&utm_campaign=social_mcp_launch_20261114&utm_content=rest_starter_01#try-a-read-only-rest-request-in-postman)\n\n[AppStruct Social](https://appstruct.ai/social?utm_source=postman&utm_medium=referral&utm_campaign=social_mcp_launch_20261114&utm_content=rest_starter_product)\n\nPrepared from AppStruct's public Social OpenAPI document on 17 November 2026. The JSON structure and declared GET paths were checked. No authenticated account-read run is claimed for this starter. AppStruct maintains this collection; Postman does not endorse the service.\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"2939209","team":16783959,"collectionId":"ed550539-2edd-4718-a206-80e5f9598079","publishedId":"2sBYHbrbki","public":true,"publicUrl":"https://documenter-api.postman.tech/view/2939209/2sBYHbrbki","privateUrl":"https://go.postman.co/documentation/2939209-ed550539-2edd-4718-a206-80e5f9598079","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Read connected channels, draft posts and available analytics in AppStruct Social. Five REST GET requests, scoped-key setup and response checks."},{"name":"title","value":"AppStruct Social API — Read-only Postman Starter"}],"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.12.12","publishDate":"2026-11-17T17:26:20.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"AppStruct Social API — Read-only Postman Starter","description":"Read connected channels, draft posts and available analytics in AppStruct Social. Five REST GET requests, scoped-key setup and response checks."},"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://postman-image-service.postman.com/api/cloudinary-proxy/postman/image/upload/t_team_logo_pubdoc/v1/team/eb4ef584ec236e6bb3aa36161ac9ac760c1e25b3dbdc02748e09c9d7f4eb48d8","favicon":""},"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://documenter.gw.postman.com/view/metadata/2sBYHbrbki"}