The Social Post Ideas API from Synup — 47 operation(s) for social post ideas.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/synup-social-post-ideas-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Synup Social Post Ideas API
version: '4'
description: 'REST API v4 for the Synup local marketing platform: business locations, listing syndication to 80+ directories, review/interaction aggregation and response, review campaigns, local rank tracking and grid-rank heatmaps, local and social posts, AI post ideas, menus, connected accounts, users and profile analytics.
ASSEMBLED BY API EVANGELIST from the per-endpoint OpenAPI documents Synup publishes on its own documentation host (developer.synup.com, Apidog project 797384). Every operation, parameter, response, example and schema below is verbatim provider content; only the merge into a single document is ours. Source index: https://developer.synup.com/llms.txt'
contact:
name: Synup Developer Documentation
url: https://developer.synup.com/
x-assembled-by: api-evangelist enrichment pipeline (local-v1)
x-assembled-from: 506 per-endpoint OpenAPI fragments published at https://developer.synup.com/<slug>.md
x-assembled-date: '2026-08-13'
servers:
- url: https://api.synup.com/api/v4
description: Base ENV (as published in every Synup doc fragment). Tenant workspace domains (https://<workspace>.synup.com/api/v4) also serve the same API.
tags:
- name: Social Post Ideas
paths:
/social-post-ideas/active-chat-session:
get:
summary: Active chat session
deprecated: false
description: '<span style="font-size: 14px;">
Returns the currently active AI post-idea chat session for a brand (social profile), if one exists. Set `excludeSeries` to skip sessions that belong to a content series.
</span>'
operationId: activeChatSession
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: excludeSeries
in: query
description: Exclude sessions that belong to a content series.
required: false
example: ''
schema:
type: boolean
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
activeChatSession:
$ref: '#/components/schemas/ChatSession'
x-apidog-orders:
- activeChatSession
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055529-run
/social-post-ideas/analyze-reference-image:
get:
summary: Analyze reference image
deprecated: false
description: '<span style="font-size: 14px;">
Analyzes a reference image at the given URL and returns a textual description that can be used to ground social post-idea generation. Optionally pass a `category` hint to focus the analysis.
</span>'
operationId: analyzeReferenceImage
tags:
- Social Post Ideas
parameters:
- name: imageUrl
in: query
description: URL of the image to analyze.
required: true
example: https://cdn.example.com/photo.jpg
schema:
type: string
- name: category
in: query
description: Optional category hint to focus the analysis.
required: false
example: ''
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
analyzeReferenceImage:
$ref: '#/components/schemas/ReferenceImageAnalysis'
x-apidog-orders:
- analyzeReferenceImage
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055530-run
/social-post-ideas/archive-idea:
post:
summary: Archive idea
deprecated: false
description: '<span style="font-size: 14px;">
Archives a social post idea so it no longer appears in active idea listings.
</span>'
operationId: archiveIdea
tags:
- Social Post Ideas
parameters:
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ArchiveIdeaRequest'
example:
ideaId: 91b2...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
archiveIdea:
$ref: '#/components/schemas/MutationResponse'
x-apidog-orders:
- archiveIdea
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055531-run
/social-post-ideas/archive-series:
post:
summary: Archive series
deprecated: false
description: '<span style="font-size: 14px;">
Archives a content series so it no longer appears in active series listings.
</span>'
operationId: archiveSeries
tags:
- Social Post Ideas
parameters:
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ArchiveSeriesRequest'
example:
seriesId: 3a1f...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
archiveSeries:
$ref: '#/components/schemas/MutationResponse'
x-apidog-orders:
- archiveSeries
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055564-run
/social-post-ideas/branch-chat-session:
post:
summary: Branch chat session
deprecated: false
description: '<span style="font-size: 14px;">
Creates a new chat session branched from an existing one (`parentSessionId`), anchored to a subject (`subjectType` required, `subjectId` optional). Use this to explore an alternative direction without losing the original conversation.
</span>'
operationId: branchChatSession
tags:
- Social Post Ideas
parameters:
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BranchChatSessionRequest'
example:
parentSessionId: 7f3c1a2e-...
subjectType: idea
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
branchChatSession:
$ref: '#/components/schemas/ChatSessionResponse'
x-apidog-orders:
- branchChatSession
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055575-run
/social-post-ideas/brand-info:
get:
summary: Brand info
deprecated: false
description: '<span style="font-size: 14px;">
Returns the basic brand profile for a social profile — name, site URL, categories, and country — used to ground social post-idea generation.
</span>'
operationId: brandInfo
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
brandInfo:
$ref: '#/components/schemas/BrandInfo'
x-apidog-orders:
- brandInfo
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055576-run
/social-post-ideas/calendar:
get:
summary: Calendar
deprecated: false
description: '<span style="font-size: 14px;">
Returns the content calendar for a brand (social profile) — each day with its scheduled/suggested post ideas.
</span>'
operationId: calendar
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
calendar:
type: array
items:
$ref: '#/components/schemas/CalendarDay'
x-apidog-orders:
- calendar
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055577-run
/social-post-ideas/chat-history:
get:
summary: Chat history
deprecated: false
description: '<span style="font-size: 14px;">
Returns the messages for a given AI post-idea chat session, in sequence. Use `limit` to cap the number of messages returned.
</span>'
operationId: chatHistory
tags:
- Social Post Ideas
parameters:
- name: sessionId
in: query
description: Chat session ID.
required: true
example: 7f3c1a2e-...
schema:
type: string
- name: limit
in: query
description: Maximum number of messages to return.
required: false
example: 50
schema:
type: integer
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
chatHistory:
type: array
items:
$ref: '#/components/schemas/ChatMessage'
x-apidog-orders:
- chatHistory
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055578-run
/social-post-ideas/chat-sessions:
get:
summary: Chat sessions
deprecated: false
description: '<span style="font-size: 14px;">
Returns the AI post-idea chat sessions for a brand (social profile), most recent first. Use `limit` to cap the number of sessions returned.
</span>'
operationId: chatSessions
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: limit
in: query
description: Maximum number of sessions to return.
required: false
example: 20
schema:
type: integer
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
chatSessions:
type: array
items:
$ref: '#/components/schemas/ChatSession'
x-apidog-orders:
- chatSessions
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055580-run
/social-post-ideas/close-chat-session:
post:
summary: Close chat session
deprecated: false
description: '<span style="font-size: 14px;">
Closes an active AI post-idea chat session. Once closed, the session is no longer returned as the active session for the brand.
</span>'
operationId: closeChatSession
tags:
- Social Post Ideas
parameters:
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CloseChatSessionRequest'
example:
sessionId: 7f3c1a2e-...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
closeChatSession:
$ref: '#/components/schemas/MutationResponse'
x-apidog-orders:
- closeChatSession
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055581-run
/social-post-ideas/content-series-detail:
get:
summary: Content series detail
deprecated: false
description: '<span style="font-size: 14px;">
Returns a single content series by ID, including its posts, theme, status, and post counts.
</span>'
operationId: contentSeriesDetail
tags:
- Social Post Ideas
parameters:
- name: seriesId
in: query
description: ID of the content series.
required: true
example: 3a1f...
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
contentSeriesDetail:
$ref: '#/components/schemas/ContentSeries'
x-apidog-orders:
- contentSeriesDetail
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055584-run
/social-post-ideas/content-series-list:
get:
summary: Content series list
deprecated: false
description: '<span style="font-size: 14px;">
Returns the content series for a brand (social profile) — multi-post campaigns with a shared theme, including post counts and status.
</span>'
operationId: contentSeriesList
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
contentSeriesList:
type: array
items:
$ref: '#/components/schemas/ContentSeries'
x-apidog-orders:
- contentSeriesList
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055587-run
/social-post-ideas/create-content-series:
post:
summary: Create content series
deprecated: false
description: '<span style="font-size: 14px;">
Creates a new content series for a brand (social profile) with a name and optional theme, optionally seeded from existing post ideas (`postIdeaIds`). Returns the chat session that drives the series.
</span>'
operationId: createContentSeries
tags:
- Social Post Ideas
parameters:
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateContentSeriesRequest'
example:
socialProfileId: 6f1c2a90-...
name: Summer Series
theme: seasonal
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
createContentSeries:
$ref: '#/components/schemas/ChatSessionResponse'
x-apidog-orders:
- createContentSeries
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Social Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40055588-run
/social-post-ideas/extended-brand-config:
get:
summary: Extended brand config
deprecated: false
description: '<span style="font-size: 14px;">
Returns the extended generation config for a social profile — brand tone, target customers, contact/address, brand colors and logos, and the services/products/content-rules used to ground social post-idea generation.
</span>'
operationId: extendedBrandConfig
tags:
- Social Post Ideas
parameters:
- name: socialProfileId
in: query
description: Social profile ID.
required: true
example: 6f1c2a90-...
schema:
type: string
- name: Synup-Version
in: header
description: API version date (YYYY-MM-DD).
required: true
example: '2026-04-17'
schema:
type: string
- name: Authorization
in: header
description: API key for authentication.
required: true
example: API T9V35W3xxxxxxxxxxx
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
extendedBrandConfig:
$ref: '#/components/schemas/ExtendedBrandConfig'
x-apidog-orders:
- extendedBrandConfig
x-apidog-ignore-properties: []
x-apidog-orders:
- data
x-apidog-ignore-properties: []
headers: {}
x-apidog-name: ''
'401':
descr
# --- truncated at 32 KB (137 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/openapi/synup-social-post-ideas-api-openapi.yml