Metricool

Metricool Flow Content Api Service API

The Flow Content Api Service API from Metricool — 3 operation(s) for flow content api service.

GitHub OpenAPI

Operations 3

GET /v2/flows/posts/published List published content for flow trigger selection #
GET /v2/flows/posts/published/latest List latest published content (analytics + live network API) #
GET /v2/flows/posts/scheduled List scheduled content for flow trigger selection #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/metricool/openapi/metricool-flow-content-api-service-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-public-blog-schema.json
📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-scheduled-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-ad-campaign-schema.json
📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-connected-application-dto-schema.json
📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-planner-list-schema.json
📊
JSONSchema
https://artifacts.apis.io/metricool/json-schema/metricool-tweet-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/metricool:metricool-flow-content-api-service-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

metricool-flow-content-api-service-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Metricool Flow Content Api Service API
  description: 'Metricool API


    The base URL for all endpoints is: https://app.metricool.com/api


    All endpoints require authentication.'
  version: 2.0.0
servers:
- url: https://app.metricool.com/api
tags:
- name: Flow Content Api Service
paths:
  /v2/flows/posts/published:
    get:
      tags:
      - Flow Content Api Service
      summary: List published content for flow trigger selection
      description: 'Returns published content that can be selected as flow triggers. The network is derived from the flow type: Instagram posts and reels for COMMENT_WITH_KEYWORD, TikTok videos for TK_COMMENT_WITH_KEYWORD and TK_HIDE_WITH_KEYWORD, tweets for X_COMMENT_TO_DM. X_REPOST_UNPOST returns an empty list for published content (only scheduled tweets are selectable for that flow type). This endpoint reads analytics only, so every item reports ''contentSource'' as ANALYTICS; use /published/latest to also get content that is still only on the social network.'
      operationId: getPublishedPosts
      parameters:
      - name: flowType
        in: query
        description: Flow type (COMMENT_WITH_KEYWORD, STORY_WITH_KEYWORD, TK_COMMENT_WITH_KEYWORD, TK_HIDE_WITH_KEYWORD, X_REPOST_UNPOST, X_COMMENT_TO_DM)
        required: true
        schema:
          type: string
      - name: from
        in: query
        description: Start date (yyyy-MM-dd)
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: End date (yyyy-MM-dd)
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: Timezone (e.g. Europe/Madrid)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Published content retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseFlowPostDto'
        '400':
          description: Invalid or unsupported flow type
        '401':
          description: User not authenticated
        '403':
          description: Insufficient permissions
  /v2/flows/posts/published/latest:
    get:
      tags:
      - Flow Content Api Service
      summary: List latest published content (analytics + live network API)
      description: Returns published content merged from analytics (Cassandra) and the social network API. Use this endpoint when the user needs to see recently published content that may not yet be in analytics. Each item reports where it was actually read from in 'contentSource' — do not infer the origin from the fact that this endpoint was called, most items still come from analytics.
      operationId: getLatestPublishedPosts
      parameters:
      - name: flowType
        in: query
        description: Flow type (COMMENT_WITH_KEYWORD, STORY_WITH_KEYWORD, TK_COMMENT_WITH_KEYWORD, TK_HIDE_WITH_KEYWORD, X_REPOST_UNPOST, X_COMMENT_TO_DM)
        required: true
        schema:
          type: string
      - name: from
        in: query
        description: Start date (yyyy-MM-dd)
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: End date (yyyy-MM-dd)
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: Timezone (e.g. Europe/Madrid)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Latest published content retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseFlowPostDto'
        '400':
          description: Invalid or unsupported flow type
        '401':
          description: User not authenticated
        '403':
          description: Insufficient permissions
  /v2/flows/posts/scheduled:
    get:
      tags:
      - Flow Content Api Service
      summary: List scheduled content for flow trigger selection
      description: 'Returns scheduled content for the given flow type. The network is derived from the flow type: Instagram posts and reels for COMMENT_WITH_KEYWORD, stories for STORY_WITH_KEYWORD, TikTok videos for TK_COMMENT_WITH_KEYWORD and TK_HIDE_WITH_KEYWORD, and scheduled tweets for X_REPOST_UNPOST and X_COMMENT_TO_DM. Items here carry no ''contentSource'': scheduled content has not been published yet, so it comes neither from analytics nor from the social network.'
      operationId: getScheduledPosts
      parameters:
      - name: flowType
        in: query
        description: Flow type (COMMENT_WITH_KEYWORD, STORY_WITH_KEYWORD, TK_COMMENT_WITH_KEYWORD, TK_HIDE_WITH_KEYWORD, X_REPOST_UNPOST, X_COMMENT_TO_DM)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Scheduled content retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseFlowScheduledPostDto'
        '400':
          description: Invalid or unsupported flow type
        '401':
          description: User not authenticated
        '403':
          description: Insufficient permissions
components:
  schemas:
    FlowScheduledPostDto:
      type: object
      properties:
        postId:
          type: string
          description: Scheduler post UUID
        thumbnail:
          type: string
          description: Thumbnail URL
        description:
          type: string
          description: Post caption/description
        scheduledDate:
          type: string
          description: Scheduled publication date (ISO format)
        postType:
          type: string
          description: Post type (IMAGE, REEL, CAROUSEL, STORY)
        isAssignedToActiveFlow:
          type: boolean
      description: Scheduled post available for flow trigger selection
    JsonOkListResponseFlowPostDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/FlowPostDto'
    JsonPaging:
      type: object
      properties:
        next:
          type: string
    JsonOkListResponseFlowScheduledPostDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/FlowScheduledPostDto'
    FlowPostDto:
      required:
      - contentSource
      type: object
      properties:
        postId:
          type: string
          description: Post ID on Instagram
        thumbnail:
          type: string
          description: Thumbnail URL
        description:
          type: string
          description: Post caption/description
        publicationDate:
          type: string
          description: Publication date (ISO format)
        postType:
          type: string
          description: Post type (IMAGE, REEL, CAROUSEL, STORY)
        contentSource:
          type: string
          description: Where this item was actually read from. Only /published/latest can return NETWORK.
          enum:
          - ANALYTICS
          - NETWORK
        isAssignedToActiveFlow:
          type: boolean
      description: Published post available for flow trigger selection