---
title: "Local post ideas"
method: GET
path: "/local-post-ideas/post-ideas"
tags: ["Local Post Ideas"]
---

# Local post ideas

`GET /local-post-ideas/post-ideas`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/local-post-ideas/post-ideas`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/local-post-ideas/post-ideas/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the AI post ideas for a location. Filter by `bucket` (e.g. idea, calendar, series) and `filter` (e.g. ai vs mine), and page with `limit`/`offset`.

## Query parameters

- `locationId` string, required
- `bucket` string
- `filter` string
- `limit` integer
- `offset` integer

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `localPostIdeas` LocalPostIdea[]
      - `id` string
      - `locationId` integer
      - `title` string
      - `content` string
      - `imagePrompt` string
      - `imageUrl` string
      - `type` string
      - `status` string
      - `platforms` string[]
      - `bucket` string
      - `calendarDay` integer
      - `scheduledDate` string
      - `scheduledTime` string
      - `ctaText` string
      - `ctaUrl` string
      - `note` string
      - `seriesId` string
      - `localPostId` string
      - `isRecurring` boolean
      - `isUserGenerated` boolean
      - `observanceName` string
      - `observanceDate` string
      - `language` string
      - `generationBatchId` string
      - `createdAt` string
      - `updatedAt` string
      - `referenceImageOptions` ReferenceImageOption[]
        - `url` string
        - `category` string
      - `generationState` string
      - `relevanceScore` number
      - `theme` string
      - `isRelevant` boolean
      - `generationJobId` string

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)