Blog2Social Account API

The Account API from Blog2Social — 1 operation(s) for account.

Operations 1

POST /account/overview Get Account Usage Overview #

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/blog2social-com:blog2social-com-account-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.

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

OpenAPI Specification

blog2social-com-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: 'Get API Key


    ## Blog2Social API

    ### One API 25+ Social Platforms


    Connect, manage and publish content across 25+ social media, blogging and community platforms through a single integration. Instead of building and maintaining separate integrations for every platform, Blog2Social provides one centralized API for publishing text, links, images and videos at scale. Whether you are building a SaaS platform, CMS, marketing automation solution, agency dashboard, e-commerce platform or enterprise application, Blog2Social helps you automate social media publishing while reducing development effort and maintenance costs. ### Key Benefits


    - One integration for 25+ social media and publishing platforms

    - Publish content across multiple networks simultaneously

    - Connect profiles, pages and groups through one API

    - Support for text, links, images and videos

    - Retrieve social media insights and performance metrics

    - Automate publishing workflows and content distribution

    - Scale from a single user to thousands of connected accounts


    ## Supported Platforms


    Schedule, publish and manage content across social media, blogging, business and community platforms through a single API. Connect accounts, publish content, upload media, retrieve insights and automate social media distribution from one centralized interface. | Platform | Post Types | Media |

    |-----------|-----------|-----------|

    | Facebook | Posts, Reels | Links, Images, Videos |

    | X | Posts | Links, Images, Videos |

    | LinkedIn | Posts | Links, Images, Videos |

    | Instagram | Posts | Images, Videos |

    | Pinterest | Pins, Boards | Images, Videos |

    | Reddit | Posts, Subreddits | Links, Images |

    | Tumblr | Posts | Links, Images, Videos |

    | Medium | Articles | Images |

    | Telegram | Messages | Links, Images |

    | TikTok | Posts | Images, Videos |

    | YouTube | Videos, Shorts, Playlists | Videos |

    | Vimeo | Videos | Videos |

    | Bluesky | Posts | Links, Images |

    | Threads | Posts | Links, Images, Videos |

    | Mastodon | Posts | Links, Images, Videos |

    | Discord | Messages | Images, Videos |

    | Google Business Profile | Business Posts | Images |

    | VK (VKontakte) | Posts | Links, Images |

    | Xing | Posts | Links, Images |

    | Blogger | Articles | Images |

    | DEV.to | Articles | Images, Videos |

    | Flickr | Media Posts | Images, Videos |

    | Diigo | Bookmarks | Links |

    | Bloglovin | Blog Posts | Images |

    | Torial | Articles | Images |

    | Ravelry | Posts | Images |

    | Instapaper | Saved Content | Links |

    | Band | Posts | Images |

    | HumHub | Posts | Images |


    The Blog2Social API provides a unified interface for publishing content across social media networks, blogging platforms, business networks, video platforms and community platforms. ---


    ### Platform Features


    - Multi-network publishing

    - Link, image and video publishing

    - Profiles, pages and groups

    - Boards, playlists and categories

    - Post insights and analytics

    - Video upload support

    - Automated publishing workflows


    ---


    # Quick Start Guide

    Get your first social media post published in less than 5 minutes. ## Authentication Model

    The API uses a two-layer authentication model:


    service_token = your application

    access_token = your user


    Think of the service_token as your app key and the access_token as the user''s session token. Most API requests require both tokens. ## Prerequisites

    - A free Blog2Social API account to get started. ## Step 1: Get Your API Key

    Navigate to the My Apps section in your Blog2Social API Console and click Create App. Once the application has been created, copy the generated service_token and store it securely. The service_token uniquely identifies your application and is required for all API requests. ## Step 2: Authenticate User

    POST /user/auth


    Request:


    ```json

    {

    "service_token": "YOUR_SERVICE_TOKEN"

    }

    ```


    Response:


    ```json

    {

    "access_token": "USER_ACCESS_TOKEN",

    "refresh_token": "REFRESH_TOKEN"

    }

    ```


    Save the access_token for all future API requests.'
  version: 1.0.0
  title: Blog2Social Account API
  x-logo:
    url: assets/image/b2slogo.png
    backgroundColor: '#FFFFFF'
    altText: Blog2Social API
servers:
- url: https://api.blog2social.com/rest/v1.0
tags:
- name: Account
paths:
  /account/overview:
    post:
      tags:
      - Account
      summary: Get Account Usage Overview
      description: Returns the current available credit balance and credit usage for each day, grouped by API endpoint and network. This endpoint requires a service_token but does not require an access_token. The optional days parameter accepts values from 1 to 30 and defaults to 1 day.
      operationId: account_overview
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                service_token:
                  type: string
                  description: The token for your service.
                days:
                  type: integer
                  minimum: 1
                  maximum: 30
                  default: 1
                  description: Number of calendar days to include, from 1 to 30. Defaults to 1 day.
              required:
              - service_token
            example:
              service_token: YOUR_SERVICE_TOKEN
              days: 30
      x-codeSamples:
      - lang: cURL
        source: "curl -X POST https://api.blog2social.com/rest/v1.0/account/overview \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"service_token\": \"YOUR_SERVICE_TOKEN\",\n  \"days\": 30\n}'"
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  credit_usage_total:
                    type: integer
                    description: Total credits used during the requested period.
                  credit_open_balance:
                    type: number
                    description: Current available credit balance.
                  days:
                    type: array
                    items:
                      type: object
                      properties:
                        day:
                          type: string
                          format: date
                          example: '2026-10-07'
                        day_total:
                          type: integer
                          description: Total credits used on this day.
                        endpoints:
                          type: array
                          items:
                            type: object
                            properties:
                              endpoint:
                                type: string
                                description: API endpoint recorded for this usage.
                              endpoint_total:
                                type: integer
                                description: Total credits used by this endpoint on this day.
                              networks:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    network_id:
                                      type: integer
                                    credits_used:
                                      type: integer
                                  required:
                                  - network_id
                                  - credits_used
                            required:
                            - endpoint
                            - endpoint_total
                            - networks
                      required:
                      - day
                      - day_total
                      - endpoints
                required:
                - credit_usage_total
                - credit_open_balance
                - days
              example:
                credit_usage_total: 4
                credit_open_balance: 96
                days:
                - day: '2026-10-07'
                  day_total: 4
                  endpoints:
                  - endpoint: network/post/create
                    endpoint_total: 4
                    networks:
                    - network_id: 1
                      credits_used: 4
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_1002'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/error_401'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_500'
components:
  schemas:
    error_1002:
      type: object
      properties:
        error_code:
          type: integer
          example: 1002
        error_message:
          type: string
          example: required parameter missing {PARAMETER}
    error_500:
      description: Internal Server Error
      type: object
      properties:
        error_code:
          type: integer
          example: 500
        error_message:
          type: string
          example: interal server error
    error_401:
      description: Unauthorized
      type: object
      properties:
        error_code:
          type: integer
          example: 401
        error_message:
          type: string
          example: unauthorized