v1Recursos/Post Ideas/getListar ideas de publicación

Listar ideas de publicación

Devuelve ideas de publicación en uno de tres modos: indique locationId para la cuadrícula de una sola ubicación (paginada); indique clientId con scope=locations para el resumen de ideas a nivel de ubicación en todas las ubicaciones de un cliente; o indique clientId con scope=brand para las ideas a nivel de marca de ese cliente.

get/api/v1/post-ideas

ideas:read

Parámetros de consulta

locationIdstringopcional

Lista las ideas de esta ubicación (modo paginado).

clientIdstringopcional

Lista las ideas de este cliente. Requiere scope.

scopestring (locations | brand)opcional

Qué conjunto de ideas a nivel de cliente devolver: locations (resumen en todas las ubicaciones del cliente) o brand (ideas a nivel de marca).

bucketstring (idea | holiday | calendar | series)opcional

Restringe los resultados a un solo bucket (solo en modo locationId).

statusstringopcional

Restringe los resultados a un estado, o "archived" para listar las ideas archivadas en su lugar (solo en modo locationId).

seriesIdstringopcional

Restringe los resultados a ideas de esta serie de contenido (solo en modo locationId).

searchstringopcional

Coincidencia sin distinción de mayúsculas con el título de la idea (solo en modo locationId).

pageintegeropcional

Número de página, empezando en 1. El valor predeterminado es 1 (solo en modo locationId).

perPageintegeropcional

Resultados por página, hasta 50. El valor predeterminado es 20 (solo en modo locationId).

includeRejectedbooleanopcional

Incluye las ideas rechazadas durante la aprobación. El valor predeterminado es false (solo en modos clientId).

Respuesta

dataobjectopcional

Errores

400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.

401La clave de API falta, es inválida, expiró o fue revocada.

403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.

429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.

get/api/v1/post-ideas

Su clave de API

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
        }
      }
    ]
  }
}