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-ai-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 Ai 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: Ai Api Service
paths:
  /v2/integrations/ai/languages:
    get:
      tags:
      - Ai Api Service
      summary: Get list of available AI languages
      operationId: getAvailableAILanguages
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseLanguageInfo'
  /v2/integrations/ai/posts:
    put:
      tags:
      - Ai Api Service
      summary: Generate another AI post copy with or without context
      operationId: generateAnotherAIPostCopy_1
      parameters:
      - name: thread-id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VariantMessageRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseAssistantMessageResponse'
    post:
      tags:
      - Ai Api Service
      summary: Create AI new post copy
      operationId: createAIPostCopy
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssistantMessageRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseAssistantMessageResponse'
  /v2/integrations/ai/posts/{thread-id}:
    put:
      tags:
      - Ai Api Service
      summary: Generate another AI post copy with or without context
      operationId: generateAnotherAIPostCopy
      parameters:
      - name: thread-id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VariantMessageRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseAssistantMessageResponse'
  /v2/integrations/ai/quick-actions/{quick-action}:
    post:
      tags:
      - Ai Api Service
      summary: Process AI quick action
      operationId: getQuickActionResponse
      parameters:
      - name: quick-action
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssistantMessageRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseAssistantMessageResponse'
  /v2/integrations/ai/text-completion:
    get:
      tags:
      - Ai Api Service
      summary: This method is deprecated
      operationId: getTextCompletion
      parameters:
      - name: prompt
        in: query
        description: input user prompt
        required: true
        schema:
          minLength: 1
          type: string
      - name: tone
        in: query
        description: tone of the copies to generate
        required: true
        schema:
          minLength: 1
          type: string
      - name: max_tokens
        in: query
        description: deprecated replaced by size
        required: false
        schema:
          type: integer
          format: int32
      - name: size
        in: query
        description: length of copies requested (short, medium, long)
        required: false
        schema:
          type: string
      - name: target
        in: query
        description: type of AI assistant requested (scheduler, autolist)
        required: false
        schema:
          type: string
      - name: numPosts
        in: query
        description: number of posts to create an autolist (only with autolist)
        required: false
        schema:
          type: integer
          format: int32
      - name: locale
        in: query
        description: language of the return list
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkListResponseString'
  /v2/integrations/ai/{blogId}/system-prompts:
    get:
      tags:
      - Ai Api Service
      summary: Get list of social media system prompts for a blog
      operationId: getSocialMediaSystemPrompts
      parameters:
      - name: blogId
        in: path
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseSocialMediaSystemPromptResponse'
    delete:
      tags:
      - Ai Api Service
      summary: Delete personalized system prompts for a blog
      operationId: deleteSystemPromptsForBlog
      parameters:
      - name: blogId
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: promptType
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseSystemPromptResponse'
    patch:
      tags:
      - Ai Api Service
      summary: Customize system prompts for a blog
      operationId: customizeSystemPromptsForBlog
      parameters:
      - name: blogId
        in: path
        required: true
        schema:
          type: integer
          format: int32
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SocialMediaSystemPromptRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseSystemPromptResponse'
  /v2/integrations/ai/{blogId}/system-prompts/generate:
    post:
      tags:
      - Ai Api Service
      summary: Generate AI custom instructions for every connected, publishable network
      operationId: generateAllNetworkInstructions
      parameters:
      - name: blogId
        in: path
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseVoid'
  /v2/integrations/ai/{blogId}/system-prompts/generate/{network}:
    post:
      tags:
      - Ai Api Service
      summary: Generate AI custom instructions for one network
      operationId: generateNetworkInstructions
      parameters:
      - name: blogId
        in: path
        required: true
        schema:
          type: integer
          format: int32
      - name: network
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonOkResponseVoid'
components:
  schemas:
    AssistantMessageResponse:
      type: object
      properties:
        threadId:
          type: string
        content:
          type: string
        contentList:
          type: array
          items:
            type: string
        spentCredits:
          type: number
          format: double
        userPrompt:
          type: string
    JsonOkResponseSystemPromptResponse:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/SystemPromptResponse'
    JsonOkListResponseLanguageInfo:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            $ref: '#/components/schemas/LanguageInfo'
    JsonOkResponseAssistantMessageResponse:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/AssistantMessageResponse'
    AssistantMessageRequest:
      required:
      - prompt
      type: object
      properties:
        prompt:
          minLength: 1
          type: string
        imageUrl:
          type: boolean
        tone:
          type: string
        language:
          type: string
        network:
          type: string
        instructions:
          type: string
    SocialMediaSystemPromptResponse:
      type: object
      properties:
        blogId:
          type: integer
          description: Brand the prompts belong to
          format: int32
        prompts:
          type: object
          additionalProperties:
            type: string
            description: Prompt text by prompt type, falling back to the default prompt
          description: Prompt text by prompt type, falling back to the default prompt
        customizedPrompts:
          type: array
          description: Prompt types the brand customized instead of using the default
          items:
            type: string
            description: Prompt types the brand customized instead of using the default
        aiGeneratedPrompts:
          type: array
          description: Customized prompt types written by AI; the rest were typed by a user
          items:
            type: string
            description: Customized prompt types written by AI; the rest were typed by a user
        generationStatuses:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/NetworkInstructionsGenerationStatusResponse'
          description: 'Generation state by network: RUNNING or FAILED. Absent when idle'
      description: AI system prompts of a brand, one per prompt type
    JsonOkResponseVoid:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: object
    JsonPaging:
      type: object
      properties:
        next:
          type: string
    SocialMediaSystemPromptRequest:
      type: object
      properties:
        promptType:
          type: string
        promptText:
          type: string
    LanguageInfo:
      required:
      - language
      - locale
      type: object
      properties:
        locale:
          type: string
        language:
          type: string
    VariantMessageRequest:
      type: object
      properties:
        userPost:
          type: string
        lastPost:
          type: string
        extraInstructions:
          type: string
    SystemPromptResponse:
      type: object
      properties:
        blogId:
          type: integer
          format: int32
        type:
          type: string
        prompt:
          type: string
    JsonOkListResponseString:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          type: array
          items:
            type: string
    NetworkInstructionsGenerationStatusResponse:
      type: object
      properties:
        status:
          type: string
          description: RUNNING or FAILED
          example: FAILED
        errorCode:
          type: string
          description: 'Reason of a FAILED generation: NOT_ENOUGH_POSTS, AI_SERVICE_ERROR or GENERIC_ERROR. Absent while RUNNING'
          example: NOT_ENOUGH_POSTS
      description: State of an in-flight or failed AI instructions generation for one network
    JsonOkResponseSocialMediaSystemPromptResponse:
      type: object
      properties:
        metadata:
          type: object
        page:
          $ref: '#/components/schemas/JsonPaging'
        data:
          $ref: '#/components/schemas/SocialMediaSystemPromptResponse'