Metricool

Metricool Competitors Posts Api Service API

The Competitors Posts Api Service API from Metricool — 14 operation(s) for competitors posts api service.

Documentation GitHub OpenAPI

Business capability

Market Intelligence Management BC-400.30

Operations 14

GET /v2/analytics/competitors/bluesky/posts Get posts of all Bluesky competitors of a brand in CSV #

GET /v2/analytics/competitors/bluesky/{competitorId}/posts Get posts of a brand Bluesky competitor in CSV #

GET /v2/analytics/competitors/facebook/posts Get posts of all facebook competitors of a brand in csv #

GET /v2/analytics/competitors/facebook/{competitorId}/posts Get posts of a FB competitor of a brand as csv #

GET /v2/analytics/competitors/instagram/publications Get publications (POSTS+REELS) of all IG competitors of a brand in csv #

GET /v2/analytics/competitors/instagram/{competitorId}/posts Get posts of a IG competitor of a brand as csv #

GET /v2/analytics/competitors/instagram/{competitorId}/reels Get reels of a IG competitor of a brand #

GET /v2/analytics/competitors/twitch/posts Get videos of all Twitch competitors of a brand as csv #

GET /v2/analytics/competitors/twitch/{competitorId}/clips Get videos of a brand Twitch competitors as csv #

GET /v2/analytics/competitors/twitch/{competitorId}/posts Get videos of a brand Twitch competitors as csv #

GET /v2/analytics/competitors/twitter/posts Get tweets of all twitter competitors of a brand in csv #

GET /v2/analytics/competitors/twitter/{competitorId}/posts Get tweets of all competitors of a brand as csv #

GET /v2/analytics/competitors/youtube/posts Get brand youtube competitors posts #

GET /v2/analytics/competitors/youtube/{competitorId}/posts Get videos of a brand Youtube competitor in CSV #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/metricool/openapi/metricool-competitors-posts-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-competitors-posts-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

openapi: 3.2.0
info:
  title: Metricool Competitors Posts 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: Competitors Posts Api Service
paths:
  /v2/analytics/competitors/bluesky/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get posts of all Bluesky competitors of a brand in CSV
      operationId: downloadBlueskyCompetitorsPosts
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: OK
  /v2/analytics/competitors/bluesky/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get posts of a brand Bluesky competitor in CSV
      operationId: downloadBlueskyCompetitorsPostsByCompetitorId
      parameters:
      - name: competitorId
        in: path
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '200':
          description: OK
  /v2/analytics/competitors/facebook/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get posts of all facebook competitors of a brand in csv
      operationId: downloadBrandFacebookCompetitorPosts
      parameters:
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        description: (Optional) Competitor id list to filter
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/facebook/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get posts of a FB competitor of a brand as csv
      operationId: downloadFacebookCompetitorPosts
      parameters:
      - name: competitorId
        in: path
        description: Competitor identifier
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/instagram/publications:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get publications (POSTS+REELS) of all IG competitors of a brand in csv
      operationId: downloadBrandInstagramCompetitorsPublications
      parameters:
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        description: (Optional) Competitor id list to filter
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/instagram/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get posts of a IG competitor of a brand as csv
      operationId: downloadInstagramCompetitorPosts
      parameters:
      - name: competitorId
        in: path
        description: Competitor identifier
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/instagram/{competitorId}/reels:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get reels of a IG competitor of a brand
      operationId: getInstagramCompetitorReels_1
      parameters:
      - name: competitorId
        in: path
        description: Competitor identifier
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/twitch/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get videos of all Twitch competitors of a brand as csv
      operationId: downloadBrandTwitchCompetitorsPosts
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: OK
  /v2/analytics/competitors/twitch/{competitorId}/clips:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get videos of a brand Twitch competitors as csv
      operationId: downloadTwitchCompetitorClips
      parameters:
      - name: competitorId
        in: path
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '200':
          description: OK
  /v2/analytics/competitors/twitch/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get videos of a brand Twitch competitors as csv
      operationId: downloadTwitchCompetitorPosts
      parameters:
      - name: competitorId
        in: path
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '200':
          description: OK
  /v2/analytics/competitors/twitter/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get tweets of all twitter competitors of a brand in csv
      operationId: downloadBrandTwitterCompetitorsPosts
      parameters:
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: From To
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        description: (Optional) Competitor id list to filter
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/twitter/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get tweets of all competitors of a brand as csv
      operationId: downloadTwitterCompetitorPosts
      parameters:
      - name: competitorId
        in: path
        description: Competitor identifier
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        description: From Date
        required: true
        schema:
          type: string
      - name: to
        in: query
        description: To Date
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        description: timezone
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: number of posts to return (max of 5000 tweets).
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '404':
          description: not found
  /v2/analytics/competitors/youtube/posts:
    get:
      tags:
      - Competitors Posts Api Service
      operationId: getBrandYoutubeCompetitorsPosts
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      - name: competitors[]
        in: query
        required: false
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseYouTubeCompetitorVideo'
      summary: Get brand youtube competitors posts
      x-summary-source: derived
  /v2/analytics/competitors/youtube/{competitorId}/posts:
    get:
      tags:
      - Competitors Posts Api Service
      summary: Get videos of a brand Youtube competitor in CSV
      operationId: downloadYoutubeCompetitorPosts
      parameters:
      - name: competitorId
        in: path
        required: true
        schema:
          minLength: 1
          type: string
      - name: from
        in: query
        required: true
        schema:
          type: string
      - name: to
        in: query
        required: true
        schema:
          type: string
      - name: timezone
        in: query
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '200':
          description: OK
components:
  schemas:
    DateTimeInfo:
      required:
      - dateTime
      type: object
      properties:
        dateTime:
          type: string
          description: 'Local Date-time represented with a certain timezone '
        timezone:
          type: string
          description: Timezone applied to the datetime
    JsonPaging:
      type: object
      properties:
        next:
          type: string
    JsonOkListResponseYouTubeCompetitorVideo:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/YouTubeCompetitorVideo'
    YouTubeCompetitorVideo:
      type: object
      properties:
        videoId:
          type: string
        thumbnailUrl:
          type: string
        title:
          type: string
        description:
          type: string
        publishedAt:
          type: integer
          format: int64
        publishedDate:
          $ref: '#/components/schemas/DateTimeInfo'
        views:
          type: number
          format: double
        watchMinutes:
          type: number
          format: double
        averageViewDuration:
          type: number
          format: double
        likes:
          type: number
          format: double
        dislikes:
          type: number
          format: double
        comments:
          type: number
          format: double
        shares:
          type: number
          format: double
        estimatedRedPartnerRevenue:
          type: number
          format: double
        estimatedAdRevenue:
          type: number
          format: double
        adImpressions:
          type: number
          format: double
        monetizedPlaybacks:
          type: number
          format: double
        ownerScreenName:
          type: string
        ownerDisplayName:
          type: string
        ownerPicture:
          type: string
        channelId:
          type: string
        watchUrl:
          type: string
        hasRevenueData:
          type: boolean
        formattedAvgViewDuration:
          type: string
        formattedWatchTime:
          type: string