Synup

Synup Social API

The Social API from Synup — 3 operation(s) for social.

GitHub OpenAPI

Operations 3

PUT /social/brands/{brandId} Assign a user to a single brand
PUT /api/v4/social/brands/{brandId1},{brandId2},{brandId3} Assign multiple brands
POST /social/brands Create a brand

Documentation

📖
Documentation
https://developer.synup.com/
📖
APIReference
https://developer.synup.com/
📖
GettingStarted
https://developer.synup.com/synup-local-seo-api-getting-started-doc-824500

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/openapi/synup-social-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/json-schema/synup-schemas.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/examples/synup-examples.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/synup/refs/heads/main/openapi/synup-webhooks-openapi.yml

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/synup-social-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

synup-social-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Synup Social API
  version: '4'
  description: 'REST API v4 for the Synup local marketing platform: business locations, listing syndication to 80+ directories, review/interaction aggregation and response, review campaigns, local rank tracking and grid-rank heatmaps, local and social posts, AI post ideas, menus, connected accounts, users and profile analytics.


    ASSEMBLED BY API EVANGELIST from the per-endpoint OpenAPI documents Synup publishes on its own documentation host (developer.synup.com, Apidog project 797384). Every operation, parameter, response, example and schema below is verbatim provider content; only the merge into a single document is ours. Source index: https://developer.synup.com/llms.txt'
  contact:
    name: Synup Developer Documentation
    url: https://developer.synup.com/
  x-assembled-by: api-evangelist enrichment pipeline (local-v1)
  x-assembled-from: 506 per-endpoint OpenAPI fragments published at https://developer.synup.com/<slug>.md
  x-assembled-date: '2026-08-13'
servers:
- url: https://api.synup.com/api/v4
  description: Base ENV (as published in every Synup doc fragment). Tenant workspace domains (https://<workspace>.synup.com/api/v4) also serve the same API.
tags:
- name: Social
paths:
  /social/brands/{brandId}:
    put:
      summary: Assign a user to a single brand
      deprecated: false
      description: ''
      tags:
      - Social
      parameters:
      - name: brandId
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    userId:
                      type: string
                  required:
                  - userId
              required:
              - input
            example:
              input:
                userId: '{userId}'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Social
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169859-run
  /api/v4/social/brands/{brandId1},{brandId2},{brandId3}:
    put:
      summary: Assign multiple brands
      deprecated: false
      description: ''
      tags:
      - Social
      parameters:
      - name: brandId1
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: brandId2
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: brandId3
        in: path
        description: ''
        required: true
        example: ''
        schema:
          type: string
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    userId:
                      type: string
                  required:
                  - userId
              required:
              - input
            example:
              input:
                userId: '{userId}'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Social
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169860-run
  /social/brands:
    post:
      summary: Create a brand
      deprecated: false
      description: ''
      tags:
      - Social
      parameters:
      - name: Content-Type
        in: header
        description: ''
        required: true
        example: application/json
        schema:
          type: string
      - name: Authorization
        in: header
        description: ''
        required: true
        example: API VGLYvxxxxxxxxxxxxxxxxxxxxx
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    name:
                      type: string
                    businessIntent:
                      type: string
                    categories:
                      type: array
                      items:
                        type: string
                    website:
                      type: string
                    phone:
                      type: string
                    description:
                      type: string
                  required:
                  - name
                  - businessIntent
                  - categories
                  - website
                  - phone
                  - description
              required:
              - input
            example:
              input:
                name: Acme Coffee Co.
                businessIntent: LOCAL_BUSINESS
                categories:
                - FOOD_AND_BEVERAGE
                - CAFE
                website: https://acmecoffee.com
                phone: +1-555-000-1234
                description: Specialty coffee roasters since 2010
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Social
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797384/apis/api-33169855-run