← Market

Functions · Posts

Recent social posts for creators in the CIMS database: post URL, format, publish time, caption, thumbnail and media, with likes, comments, views, shares, saves and engagements. Best for reviewing a creator's content, sponsored posts and recent performance before outreach. Filter by date and post type, sort by date or engagements, page with skip and limit. Paid calls read public feeds by creatorIds; campaign scopes need CIMS authentication. Errors: 400, 401, 403.

GET https://data.getcims.com/functions/v1/mcp/v1/creator/posts

0.05 USDC on Base · payTo 0xe260BB188b03832df1eBB062096089070a479ba0

Status: verified · payable

Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.

Settlement: direct to the seller's payTo — 0% HIVE402 take

Payment routes

Base · 0.05 USDC · payTo 0xe260BB188b03832df1eBB062096089070a479ba0 · via cdp · settles direct
{
  "creatorIds": "12345",
  "limit": 10,
  "sort": "-engagements"
}
{
  "creatorIds": [
    12345
  ],
  "limit": 10,
  "posts": [
    {
      "caption": "Tempo run in the new trainers",
      "creatorId": 12345,
      "id": "f3a9c2e1",
      "image": "https://example.com/thumbnail.jpg",
      "mediaUrls": [
        "https://example.com/thumbnail.jpg"
      ],
      "metrics": {
        "bookmarks": 455,
        "comments": 214,
        "engagements": 9099,
        "likes": 8120,
        "shares": 310,
        "views": 96500
      },
      "publishedAt": "2026-10-28T17:42:00.000Z",
      "type": "instagramReel",
      "url": "https://www.instagram.com/p/C7xYz12AbCd/"
    }
  ],
  "returned": 1,
  "skip": 0,
  "total": 128
}

Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact

SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans

Agent intel trust badge

Trust score63 / 100 · breakdown
Probe uptime (30d)100.0% over 1 probes · daily
Avg 402 latency860 ms
Paid calls (30d, on-chain)0 calls · 0 buyers
Facilitator-reported (30d)2 calls · 1 payers (CDP Bazaar)

How to call

GET https://data.getcims.com/functions/v1/mcp/v1/creator/posts · input in query · spec from live-challenge

Input schema
{
  "type": "object",
  "properties": {
    "creatorIds": {
      "type": "string",
      "description": "Comma-separated or repeated positive creator IDs; required for paid public feeds."
    },
    "campaignIds": {
      "type": "string",
      "description": "Comma-separated or repeated positive IDs. Requires CIMS authentication and authorized campaign/activation access."
    },
    "listIds": {
      "type": "string",
      "description": "Comma-separated or repeated positive IDs. Requires CIMS authentication and authorized campaign/activation access."
    },
    "participantIds": {
      "type": "string",
      "description": "Comma-separated or repeated positive IDs. Requires CIMS authentication and authorized campaign/activation access."
    },
    "activationIds": {
      "type": "string",
      "description": "Comma-separated or repeated positive IDs. Requires CIMS authentication and authorized campaign/activation access."
    },
    "ids": {
      "type": "string",
      "description": "Comma-separated or repeated stored post IDs."
    },
    "corporateId": {
      "type": "string",
      "description": "Must belong to authenticated CIMS account. Explicit campaign/list/participant/activation IDs take precedence; otherwise required for multi-corporate campaign scopes."
    },
    "monitored": {
      "type": "boolean",
      "description": "Include monitored activations; CIMS authentication required. At least one supplied category must be true."
    },
    "scheduled": {
      "type": "boolean",
      "description": "Include scheduled activations; CIMS authentication required. At least one supplied category must be true."
    },
    "attention": {
      "type": "string",
      "enum": [
        "todo",
        "approved",
        "all"
      ],
      "description": "Readable activation attention status; CIMS authentication required."
    },
    "sort": {
      "type": "string",
      "description": "Comma-separated/repeated any, date, -date, impressions, -impressions, engagements, -engagements. Last non-any wins; default -date."
    },
    "from": {
      "type": "string",
      "description": "Optional ISO date or datetime. Omit unless filtering to posts published on or after this date."
    },
    "to": {
      "type": "string",
      "description": "Optional ISO date or datetime. Omit unless filtering to posts published on or before this date."
    },
    "postTypes": {
      "type": "string",
      "description": "Optional comma-separated content type filter (e.g. instagramPost,instagramReel,tikTokVideo,youTubeShorts). Omit for all post types."
    },
    "skip": {
      "type": "integer",
      "minimum": 0,
      "description": "Optional integer pagination offset (0–2147483647). Omit for the first page."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Optional page size. Defaults to 30; values outside 1–100 are rejected."
    }
  }
}
Output schema
{
  "type": "object",
  "properties": {
    "creatorId": {
      "type": "number"
    },
    "total": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "skip": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "posts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Stored post ID, not an activation ID."
          },
          "url": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ],
            "description": "Public platform post URL, or null when absent. Never a CIMS navigation URL."
          },
          "type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "instagramPost",
                  "instagramStory",
                  "instagramReel",
                  "tikTokStory",
                  "tikTokPost",
                  "tikTokVideo",
                  "tikTokLive",
                  "youTubeVideo",
                  "youTubeLive",
                  "snapchatStory",
                  "snapchatSpotlight",
                  "youTubeShorts",
                  "xPost",
                  "twitchVideo",
                  "linkedInPost",
                  "pinterestPin",
                  "facebookPost",
                  "facebookReel",
                  "twitchClip"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual post format using existing content type labels; null when unavailable."
          },
          "publishedAt": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
              },
              {
                "type": "null"
              }
            ],
            "description": "Actual social post timestamp (ISO), or null. Never a planned activation date."
          },
          "image": {
            "description": "Post thumbnail, otherwise first available post media URL; null when absent.",
            "type": [
              "string",
              "null"
            ]
          },
          "mediaUrls": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Deduplicated post media URLs, including the thumbnail. Empty when unavailable; excludes activation drafts."
          },
          "links": {
            "description": "Resolvable CIMS navigation destinations, separate from the public post URL.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rel": {
                  "type": "string",
                  "enum": [
                    "view",
                    "parent"
                  ]
                },
                "label": {
                  "type": "string",
                  "minLength": 1
                },
                "url": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "required": [
                "rel",
                "label",
                "url"
              ],
              "additionalProperties": false
            }
          },
          "creatorId": {
            "type": "number"
          },
          "metrics": {
            "type": "object",
            "properties": {
              "likes": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "comments": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "views": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "shares": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "bookmarks": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "engagements": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "availability": {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable"
                      ]
                    },
                    "reason": {
                      "type": "string",
                      "enum": [
                        "not_available",
                        "not_supported",
                        "refresh_pending",
                        "no_matching_posts",
                        "partial_data",
                        "zero_denominator"
                      ]
                    },
                    "observed": {
                      "type": "number"
                    },
                    "total": {
                      "type": "number"
                    },
                    "undatedRecords": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "status"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "likes",
              "comments",
              "views",
              "shares",
              "bookmarks",
              "engagements"
            ],
            "additionalProperties": false
          },
          "campaignIds": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "listIds": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "attentionStatus": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "url",
          "type",
          "publishedAt",
          "image",
          "mediaUrls",
          "creatorId",
          "metrics"
        ],
        "additionalProperties": {}
      }
    },
    "creatorIds": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "matchingActivationCount": {
      "type": "number"
    }
  },
  "required": [
    "total",
    "returned",
    "skip",
    "limit",
    "posts"
  ],
  "additionalProperties": false
}
curl -i -X GET 'https://data.getcims.com/functions/v1/mcp/v1/creator/posts?creatorIds=12345&limit=10&sort=-engagements'

Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs

Try it (your wallet signs; HIVE402 never holds funds)