The Local Post Ideas API from Synup — 41 operation(s) for local 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-local-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 Local 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: Local Post Ideas
paths:
/local-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 post-idea generation. Optionally pass a `category` hint to focus the analysis.
</span>'
operationId: analyzeReferenceImage
tags:
- Local 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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052170-run
/local-post-ideas/archive-idea:
post:
summary: Archive local idea
deprecated: false
description: '<span style="font-size: 14px;">
Archives a post idea so it no longer appears in active idea listings.
</span>'
operationId: archiveLocalIdea
tags:
- Local 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/ArchiveLocalIdeaRequest'
example:
ideaId: 91b2...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
archiveLocalIdea:
$ref: '#/components/schemas/LocalMutationResponse'
x-apidog-orders:
- archiveLocalIdea
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052176-run
/local-post-ideas/archive-series:
post:
summary: Archive local series
deprecated: false
description: '<span style="font-size: 14px;">
Archives a content series so it no longer appears in active series listings.
</span>'
operationId: archiveLocalSeries
tags:
- Local 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/ArchiveLocalSeriesRequest'
example:
seriesId: 3a1f...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
archiveLocalSeries:
$ref: '#/components/schemas/LocalMutationResponse'
x-apidog-orders:
- archiveLocalSeries
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052177-run
/local-post-ideas/branch-chat-session:
post:
summary: Branch local chat session
deprecated: false
description: '<span style="font-size: 14px;">
Creates a new chat session branched from an existing one (`parentSessionId`), optionally anchored to a subject (`subjectType`/`subjectId`). Use this to explore an alternative direction without losing the original conversation.
</span>'
operationId: branchLocalChatSession
tags:
- Local 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/BranchLocalChatSessionRequest'
example:
parentSessionId: 7f3c1a2e-...
subjectType: idea
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
branchLocalChatSession:
$ref: '#/components/schemas/LocalChatSessionResponse'
x-apidog-orders:
- branchLocalChatSession
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052178-run
/local-post-ideas/close-chat-session:
post:
summary: Close local 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 location.
</span>'
operationId: closeLocalChatSession
tags:
- Local 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/CloseLocalChatSessionRequest'
example:
sessionId: 7f3c1a2e-...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
closeLocalChatSession:
$ref: '#/components/schemas/LocalMutationResponse'
x-apidog-orders:
- closeLocalChatSession
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052180-run
/local-post-ideas/generate-all-series-posts:
post:
summary: Generate all local series posts
deprecated: false
description: '<span style="font-size: 14px;">
Generates all remaining posts for a content series in one call. Returns the generated ideas and a count.
</span>'
operationId: generateAllLocalSeriesPosts
tags:
- Local 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/GenerateAllLocalSeriesPostsRequest'
example:
locationId: TG9jYXRpb246MQ==
seriesId: 3a1f...
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
generateAllLocalSeriesPosts:
$ref: '#/components/schemas/LocalGenerateIdeasResponse'
x-apidog-orders:
- generateAllLocalSeriesPosts
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052188-run
/local-post-ideas/generate-holiday-idea-variant:
post:
summary: Generate local holiday idea variant
deprecated: false
description: '<span style="font-size: 14px;">
Generates a new post-idea variant for a given observance/holiday at a location. Optionally steer with an `observanceDate` and `topic`.
</span>'
operationId: generateLocalHolidayIdeaVariant
tags:
- Local 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/GenerateLocalHolidayIdeaVariantRequest'
example:
locationId: TG9jYXRpb246MQ==
observanceName: Mother's Day
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
generateLocalHolidayIdeaVariant:
$ref: '#/components/schemas/LocalRegenerateResponse'
x-apidog-orders:
- generateLocalHolidayIdeaVariant
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052189-run
/local-post-ideas/generate-series-post:
post:
summary: Generate local series post
deprecated: false
description: '<span style="font-size: 14px;">
Generates a single post for a content series at the given slot index.
</span>'
operationId: generateLocalSeriesPost
tags:
- Local 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/GenerateLocalSeriesPostRequest'
example:
seriesId: 3a1f...
slotIndex: '0'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
generateLocalSeriesPost:
$ref: '#/components/schemas/LocalRegenerateResponse'
x-apidog-orders:
- generateLocalSeriesPost
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052190-run
/local-post-ideas/active-chat-session:
get:
summary: Local active chat session
deprecated: false
description: '<span style="font-size: 14px;">
Returns the currently active AI post-idea chat session for a location, if one exists. Use this to resume an in-progress conversation. Set `excludeSeries` to skip sessions that belong to a content series.
</span>'
operationId: localActiveChatSession
tags:
- Local Post Ideas
parameters:
- name: locationId
in: query
description: Relay-encoded location ID.
required: true
example: TG9jYXRpb246MQ==
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:
localActiveChatSession:
$ref: '#/components/schemas/LocalChatSession'
x-apidog-orders:
- localActiveChatSession
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052193-run
/local-post-ideas/calendar:
get:
summary: Local calendar
deprecated: false
description: '<span style="font-size: 14px;">
Returns the content calendar for a location — each day with its scheduled/suggested post ideas.
</span>'
operationId: localCalendar
tags:
- Local Post Ideas
parameters:
- name: locationId
in: query
description: Relay-encoded location ID.
required: true
example: TG9jYXRpb246MQ==
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:
localCalendar:
type: array
items:
$ref: '#/components/schemas/LocalCalendarDay'
x-apidog-orders:
- localCalendar
x--orders:
- localCalendar
x--ignore-properties: []
x-apidog-orders:
- data
x--orders:
- data
x--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--orders: []
x--ignore-properties: []
headers: {}
x-apidog-name: ''
security: []
x-apidog-folder: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052194-run
/local-post-ideas/chat-history:
get:
summary: Local 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: localChatHistory
tags:
- Local 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:
localChatHistory:
type: array
items:
$ref: '#/components/schemas/LocalChatMessage'
x-apidog-orders:
- localChatHistory
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052196-run
/local-post-ideas/chat-sessions:
get:
summary: Local chat sessions
deprecated: false
description: '<span style="font-size: 14px;">
Returns the AI post-idea chat sessions for a location, most recent first. Use `limit` to cap the number of sessions returned.
</span>'
operationId: localChatSessions
tags:
- Local Post Ideas
parameters:
- name: locationId
in: query
description: Relay-encoded location ID.
required: true
example: TG9jYXRpb246MQ==
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:
localChatSessions:
type: array
items:
$ref: '#/components/schemas/LocalChatSession'
x-apidog-orders:
- localChatSessions
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052241-run
/local-post-ideas/content-series-detail:
get:
summary: Local 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: localContentSeriesDetail
tags:
- Local 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:
localContentSeriesDetail:
$ref: '#/components/schemas/LocalContentSeries'
x-apidog-orders:
- localContentSeriesDetail
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: Local Post Ideas
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-40052244-run
/local-post-ideas/content-series-list:
get:
summary: Local content series list
deprecated: false
description: '<span style="font-size: 14px;">
Returns the content series for a location — multi-post campaigns with a shared theme, including post counts and status.
</span>'
operationId: localContentSeriesList
tags:
- Local Post Ideas
parameters:
- name: locationId
in: query
description: Relay-encoded location ID.
required: true
example: TG9jYXRpb246MQ==
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:
localContentSeriesList:
# --- truncated at 32 KB (121 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/openapi/synup-local-post-ideas-api-openapi.yml