Skip to content
SynupAPI
Get an API key
GETapi.synup.com/api/v4/local-post-ideas/post-idea

Local post idea

Returns a single AI post idea by its ID, including its content, image, scheduling, call-to-action, and generation metadata.

Requires an API key. Send it as Authorization: API <your-key> — see Getting started.

Parameters

Query

NameTypeRequiredDescription
ideaIdstringrequiredID of the post idea.

Headers

NameTypeRequiredDescription
Synup-VersionstringrequiredAPI version date (YYYY-MM-DD).

Request

Request
curl -X GET 'https://api.synup.com/api/v4/local-post-ideas/post-idea?ideaId=' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Responses

StatusDescription
200Successful response
401Unauthorized - Invalid or missing API key
Example response (generated from the schema)
{
  "data": {
    "localPostIdea": {
      "id": "string",
      "locationId": 0,
      "title": "string",
      "content": "string",
      "imagePrompt": "string",
      "imageUrl": "string",
      "type": "string",
      "status": "string",
      "platforms": [
        "string"
      ],
      "bucket": "string",
      "calendarDay": 0,
      "scheduledDate": "string",
      "scheduledTime": "string",
      "ctaText": "string",
      "ctaUrl": "string",
      "note": "string",
      "seriesId": "string",
      "localPostId": "string",
      "isRecurring": true,
      "isUserGenerated": true,
      "observanceName": "string",
      "observanceDate": "string",
      "language": "string",
      "generationBatchId": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "referenceImageOptions": [
        {
          "url": "string",
          "category": "string"
        }
      ],
      "generationState": "string",
      "relevanceScore": 0,
      "theme": "string",
      "isRelevant": true,
      "generationJobId": "string"
    }
  }
}

Response body

NameTypeRequiredDescription
dataobjectoptional
data.localPostIdeaobjectoptional
data.localPostIdea.idstringoptional
data.localPostIdea.locationIdintegeroptional
data.localPostIdea.titlestringoptional
data.localPostIdea.contentstringoptional
data.localPostIdea.imagePromptstringoptional
data.localPostIdea.imageUrlstringoptional
data.localPostIdea.typestringoptional
data.localPostIdea.statusstringoptional
data.localPostIdea.platformsarray of stringoptional
data.localPostIdea.bucketstringoptional
data.localPostIdea.calendarDayintegeroptional
data.localPostIdea.scheduledDatestringoptional
data.localPostIdea.scheduledTimestringoptional
data.localPostIdea.ctaTextstringoptional
data.localPostIdea.ctaUrlstringoptional
data.localPostIdea.notestringoptional
data.localPostIdea.seriesIdstringoptional
data.localPostIdea.localPostIdstringoptional
data.localPostIdea.isRecurringbooleanoptional
data.localPostIdea.isUserGeneratedbooleanoptional
data.localPostIdea.observanceNamestringoptional
data.localPostIdea.observanceDatestringoptional
data.localPostIdea.languagestringoptional
data.localPostIdea.generationBatchIdstringoptional
data.localPostIdea.createdAtstringoptional
data.localPostIdea.updatedAtstringoptional
data.localPostIdea.referenceImageOptionsarray of objectoptional
data.localPostIdea.referenceImageOptions[].urlstringoptional
data.localPostIdea.referenceImageOptions[].categorystringoptional
data.localPostIdea.generationStatestringoptional
data.localPostIdea.relevanceScorenumberoptional
data.localPostIdea.themestringoptional
data.localPostIdea.isRelevantbooleanoptional
data.localPostIdea.generationJobIdstringoptional