Metricool

Metricool Catalogs Api Service API

The Catalogs Api Service API from Metricool — 16 operation(s) for catalogs api service.

Documentation GitHub OpenAPI

Operations 16

GET /v2/scheduler/catalogs/facebook/audio-recommendations Get facebook audio recommendations #

GET /v2/scheduler/catalogs/instagram Get instagram catalogs #

GET /v2/scheduler/catalogs/instagram/audio Get Instagram audio catalog (music and original sounds) #

GET /v2/scheduler/catalogs/instagram/audio/{audioId} Get Instagram audio metadata by audio id #

GET /v2/scheduler/catalogs/instagram/eligibility Get instagram shop product tag eligibility #

GET /v2/scheduler/catalogs/instagram/scopes Verify scopes 3 #

GET /v2/scheduler/catalogs/linkedin/mentions Search LinkedIn persons and organizations that can be mentioned in a post #

GET /v2/scheduler/catalogs/products/instagram Get instagram catalog products #

GET /v2/scheduler/catalogs/threads/geo-gating/eligibility Get threads geo gating eligibility #

GET /v2/scheduler/catalogs/threads/share-as-instagram-story/scopes Verify threads share as instagram story scopes #

GET /v2/scheduler/catalogs/tiktok/creator-info Get tiktok creator info #

GET /v2/scheduler/catalogs/tiktok/privacy-options This method is deprecated #

GET /v2/scheduler/catalogs/tiktok/scopes Verify tiktok scopes #

GET /v2/scheduler/catalogs/tiktok/trending-tracks Get trending tracks from TikTok Business API #

GET /v2/scheduler/catalogs/youtube/categories Get youtube categories #

GET /v2/scheduler/catalogs/youtube/playlists Get YouTube playlists from YouTube #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/metricool/openapi/metricool-catalogs-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-catalogs-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 Catalogs 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: Catalogs Api Service
paths:
  /v2/scheduler/catalogs/facebook/audio-recommendations:
    get:
      tags:
      - Catalogs Api Service
      operationId: getFacebookAudioRecommendations
      parameters:
      - name: type
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseFacebookRecommendedAudio'
      summary: Get facebook audio recommendations
      x-summary-source: derived
  /v2/scheduler/catalogs/instagram:
    get:
      tags:
      - Catalogs Api Service
      operationId: getInstagramCatalogs
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseIGCatalog'
      summary: Get instagram catalogs
      x-summary-source: derived
  /v2/scheduler/catalogs/instagram/audio:
    get:
      tags:
      - Catalogs Api Service
      summary: Get Instagram audio catalog (music and original sounds)
      operationId: getInstagramAudio
      parameters:
      - name: searchQuery
        in: query
        required: false
        schema:
          type: string
      - name: musicCursor
        in: query
        required: false
        schema:
          type: string
      - name: originalSoundCursor
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Audio results returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseInstagramAudioSearchResultDto'
        '403':
          description: No Facebook connection or insufficient permissions
  /v2/scheduler/catalogs/instagram/audio/{audioId}:
    get:
      tags:
      - Catalogs Api Service
      summary: Get Instagram audio metadata by audio id
      operationId: getInstagramAudioById
      parameters:
      - name: audioId
        in: path
        required: true
        schema:
          type: string
      - name: title
        in: query
        description: Optional - audio title used as fallback search when the id lookup fails
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Audio metadata returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseInstagramAudioItemDto'
        '403':
          description: No Facebook connection or insufficient permissions
        '404':
          description: Audio not found
  /v2/scheduler/catalogs/instagram/eligibility:
    get:
      tags:
      - Catalogs Api Service
      operationId: getInstagramShopProductTagEligibility
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseBoolean'
      summary: Get instagram shop product tag eligibility
      x-summary-source: derived
  /v2/scheduler/catalogs/instagram/scopes:
    get:
      tags:
      - Catalogs Api Service
      operationId: verifyScopes_3
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseCollectionString'
      summary: Verify scopes 3
      x-summary-source: derived
  /v2/scheduler/catalogs/linkedin/mentions:
    get:
      tags:
      - Catalogs Api Service
      summary: Search LinkedIn persons and organizations that can be mentioned in a post
      operationId: getLinkedinMentionSuggestions
      parameters:
      - name: q
        in: query
        description: Text entered in the search field
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseLinkedinMentionSuggestionDto'
        '403':
          description: Not authorized
        '500':
          description: Internal server error
  /v2/scheduler/catalogs/products/instagram:
    get:
      tags:
      - Catalogs Api Service
      operationId: getInstagramCatalogProducts
      parameters:
      - name: catalogId
        in: query
        required: true
        schema:
          minLength: 1
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseIGCatalogProduct'
      summary: Get instagram catalog products
      x-summary-source: derived
  /v2/scheduler/catalogs/threads/geo-gating/eligibility:
    get:
      tags:
      - Catalogs Api Service
      operationId: getThreadsGeoGatingEligibility
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseBoolean'
      summary: Get threads geo gating eligibility
      x-summary-source: derived
  /v2/scheduler/catalogs/threads/share-as-instagram-story/scopes:
    get:
      tags:
      - Catalogs Api Service
      operationId: verifyThreadsShareAsInstagramStoryScopes
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseCollectionString'
      summary: Verify threads share as instagram story scopes
      x-summary-source: derived
  /v2/scheduler/catalogs/tiktok/creator-info:
    get:
      tags:
      - Catalogs Api Service
      operationId: getTiktokCreatorInfo
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseTikTokCreatorInfo'
      summary: Get tiktok creator info
      x-summary-source: derived
  /v2/scheduler/catalogs/tiktok/privacy-options:
    get:
      tags:
      - Catalogs Api Service
      summary: This method is deprecated
      description: Deprecated. Use `GET /v2/scheduler/catalogs/tiktok/creator-info` instead.
      operationId: getTiktokPrivacyOptions
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseCollectionString'
      deprecated: true
  /v2/scheduler/catalogs/tiktok/scopes:
    get:
      tags:
      - Catalogs Api Service
      operationId: verifyTiktokScopes
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseCollectionString'
      summary: Verify tiktok scopes
      x-summary-source: derived
  /v2/scheduler/catalogs/tiktok/trending-tracks:
    get:
      tags:
      - Catalogs Api Service
      summary: Get trending tracks from TikTok Business API
      operationId: getTiTokTrendingTracks
      parameters:
      - name: genre
        in: query
        description: 'Optional - Filter by genre (default: ALL)'
        required: false
        schema:
          type: string
      - name: countryCode
        in: query
        description: 'Optional - Filter by country code (default: US)'
        required: false
        schema:
          type: string
      - name: dateRange
        in: query
        description: 'Optional - Filter by date range (default: 7DAY)'
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseTikTokTrendingTrackDto'
        '403':
          description: Not authorized (Business Account required)
        '500':
          description: Internal server error
  /v2/scheduler/catalogs/youtube/categories:
    get:
      tags:
      - Catalogs Api Service
      operationId: getYoutubeCategories
      parameters:
      - name: lang
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseListYoutubeVideoCategory'
      summary: Get youtube categories
      x-summary-source: derived
  /v2/scheduler/catalogs/youtube/playlists:
    get:
      tags:
      - Catalogs Api Service
      summary: Get YouTube playlists from YouTube
      operationId: getYoutubePlaylists
      parameters:
      - name: refresh
        in: query
        description: If true, playlists will be refreshed from YouTube
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseListYoutubePlaylistDto'
        '403':
          description: Not authorized
        '500':
          description: Internal server error
components:
  schemas:
    IGCatalog:
      type: object
      properties:
        catalogId:
          type: string
        catalogName:
          type: string
        shopName:
          type: string
        productCount:
          type: integer
          format: int32
    JsonOkResponseInstagramAudioSearchResultDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/InstagramAudioSearchResultDto'
    InstagramAudioSearchResultDto:
      type: object
      properties:
        music:
          type: array
          items:
            $ref: '#/components/schemas/InstagramAudioItemDto'
        originalSound:
          type: array
          items:
            $ref: '#/components/schemas/InstagramAudioItemDto'
        musicNextCursor:
          type: string
        originalSoundNextCursor:
          type: string
    LinkedinMentionSuggestionDto:
      type: object
      properties:
        id:
          type: string
          description: LinkedIn URN of the entity, e.g. urn:li:person:abc123 or urn:li:organization:123456
        type:
          type: string
          description: Type of the mentioned entity
          enum:
          - PERSON
          - ORGANIZATION
        name:
          type: string
          description: Display name of the person or organization
        picture:
          type: string
          description: Profile picture or logo URL, if available
        url:
          type: string
          description: Website URL, only available for organizations
      description: LinkedIn person or organization that can be mentioned in a post.
    JsonOkResponseListYoutubePlaylistDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/YoutubePlaylistDto'
    YoutubeVideoCategory:
      type: object
      properties:
        key:
          type: string
        label:
          type: string
    JsonOkListResponseTikTokTrendingTrackDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/TikTokTrendingTrackDto'
    JsonOkResponseBoolean:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: boolean
    JsonPaging:
      type: object
      properties:
        next:
          type: string
    JsonOkListResponseIGCatalog:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/IGCatalog'
    FacebookRecommendedAudio:
      type: object
      properties:
        title:
          type: string
        artist:
          type: string
        displayImageUri:
          type: string
    InstagramAudioItemDto:
      type: object
      properties:
        audioId:
          type: string
        audioType:
          type: string
          enum:
          - music
          - original_sound
        title:
          type: string
        durationMs:
          type: integer
          format: int64
        downloadUrl:
          type: string
        coverArtworkUrl:
          type: string
        displayArtist:
          type: string
        igUsername:
          type: string
    JsonOkResponseListYoutubeVideoCategory:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/YoutubeVideoCategory'
    JsonOkListResponseFacebookRecommendedAudio:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/FacebookRecommendedAudio'
    JsonOkResponseCollectionString:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            type: string
    IGCatalogProduct:
      type: object
      properties:
        productId:
          type: string
        merchantId:
          type: string
        productName:
          type: string
        imageUrl:
          type: string
        retailerId:
          type: string
        reviewStatus:
          type: string
        isCheckoutFlow:
          type: boolean
        productVariants:
          type: array
          items:
            $ref: '#/components/schemas/ProductVariant'
    JsonOkListResponseIGCatalogProduct:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/IGCatalogProduct'
    JsonOkListResponseLinkedinMentionSuggestionDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/LinkedinMentionSuggestionDto'
    ProductVariant:
      type: object
      properties:
        productId:
          type: string
        variantName:
          type: string
    JsonOkResponseInstagramAudioItemDto:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/InstagramAudioItemDto'
    YoutubePlaylistDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the playlist
        title:
          type: string
          description: Playlist title (human readable)
      description: Represents a YouTube playlist linked to a channel. Contains the playlist id and its human readable title.
    JsonOkResponseTikTokCreatorInfo:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/TikTokCreatorInfo'
    TikTokCreatorInfo:
      type: object
      properties:
        creatorAvatarUrl:
          type: string
        creatorUsername:
          type: string
        creatorNickname:
          type: string
        privacyLevelOptions:
          type: array
          items:
            type: string
        commentDisabled:
          type: boolean
        duetDisabled:
          type: boolean
        stitchDisabled:
          type: boolean
        maxVideoPostDurationSec:
          type: integer
          format: int32
    TikTokTrendingTrackDto:
      type: object
      properties:
        commercialMusicId:
          type: string
        commercialMusicName:
          type: string
        duration:
          type: integer
          format: int32
        thumbnailUrl:
          type: string
        artist:
          type: string
        previewUrl:
          type: string
        genres:
          type: array
          items:
            type: string
        rankPosition:
          type: string