v1Ressourcen/Post Ideas/getBeitragsideen auflisten

Beitragsideen auflisten

Liefert Beitragsideen in einem von drei Modi: locationId für das Raster eines einzelnen Standorts (paginiert); clientId mit scope=locations für das Rollup standortbezogener Ideen über die Standorte eines Kunden hinweg; oder clientId mit scope=brand für die markenweiten Ideen dieses Kunden.

get/api/v1/post-ideas

ideas:read

Query-Parameter

locationIdstringoptional

Ideen für diesen Standort auflisten (paginierter Modus).

clientIdstringoptional

Ideen für diesen Kunden auflisten. Erfordert scope.

scopestring (locations | brand)optional

Welche kundenweite Ideenmenge zurückgegeben werden soll: locations (Rollup über die Standorte des Kunden) oder brand (markenweite Ideen).

bucketstring (idea | holiday | calendar | series)optional

Ergebnisse auf einen Bucket beschränken (nur im locationId-Modus).

statusstringoptional

Ergebnisse auf einen Status beschränken, oder "archived", um stattdessen archivierte Ideen aufzulisten (nur im locationId-Modus).

seriesIdstringoptional

Ergebnisse auf Ideen in dieser Content-Serie beschränken (nur im locationId-Modus).

searchstringoptional

Abgleich mit dem Titel der Idee, ohne Beachtung der Groß-/Kleinschreibung (nur im locationId-Modus).

pageintegeroptional

Seitenzahl, beginnend bei 1. Standardmäßig 1 (nur im locationId-Modus).

perPageintegeroptional

Ergebnisse pro Seite, bis zu 50. Standardmäßig 20 (nur im locationId-Modus).

includeRejectedbooleanoptional

Während der Genehmigung abgelehnte Ideen einschließen. Standardmäßig false (nur bei clientId-Modi).

Antwort

dataobjectoptional

Fehler

400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.

401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.

403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.

429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.

get/api/v1/post-ideas

Ihr API-Schlüssel

locationId

clientId

scope

bucket

status

seriesId

search

page

perPage

includeRejected

{
  "data": {
    "rows": [
      {
        "id": "cm_idea_abc123",
        "agencyId": "cm_agency_1",
        "locationId": "cm_loc_1",
        "clientLocationId": "cm_loc_1",
        "clientId": null,
        "brandName": null,
        "agentMeta": null,
        "title": "Spotlight our new patient special",
        "content": "Book this month and get 20% off your first cleaning!",
        "imagePrompt": null,
        "imageUrl": null,
        "type": "announcement",
        "status": "draft",
        "bucket": "idea",
        "platforms": [
          "google",
          "facebook"
        ],
        "seriesId": null,
        "scheduledDate": null,
        "scheduledTime": null,
        "observanceName": null,
        "observanceDate": null,
        "generationBatchId": null,
        "generationJobId": null,
        "isUserGenerated": true,
        "source": "os",
        "externalId": "cm_idea_abc123",
        "reviewStatus": null,
        "archived": false,
        "archivedAt": null,
        "createdAt": "2026-01-20T09:00:00.000Z",
        "updatedAt": "2026-01-20T09:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "perPage": 20,
    "counts": [
      {
        "bucket": "idea",
        "_count": {
          "id": 4
        }
      }
    ]
  }
}