SocialNeuronSocialNeuronSocialNeuron
  • Docs
  • REST API
  • MCP Tools API
Product
  • Dashboard
  • Pricing
  • What's New
Developers
  • REST API
  • MCP Tools API
  • CLI Reference
  • npm Package
  • GitHub
Support
  • Help & Support
  • FAQ
  • Email Support
Community
  • X / Twitter
  • GitHub
  • Privacy Policy
  • Terms of Service
Other endpoints
    Generate AI contentpostSchedule a post to social platformspostFetch content analyticsgetFetch trending topicsgetGenerate a video with AIpostGenerate an image with AIpostCheck async job statusgetGet brand profilegetGet credit balancegetAI content brain analysispost
Social Neuron API

​Other endpoints

Endpoint:https://api.socialneuron.com/api/v1

​Generate AI content

POST
https://api.socialneuron.com/api/v1
/content/generate

Generate text content using AI. Supports multiple models and content types. Use for captions, scripts, blog posts, social media copy, and more.

​Generate AI content › Request Body

  • promptstring · required

    The content generation prompt

    Example: Write a TikTok caption about sustainable fashion for Gen Z
  • modelstring · enum

    AI model to use

    Enum values:
    gemini-2.5-flash
    gemini-2.5-pro
    gemini-3-flash-preview
    claude-sonnet-4-20250514
    gpt-4.1-nano
    gpt-4.1-mini
    Default: gemini-2.5-flash
  • contentTypestring

    Type of content to generate

    Default: generation
  • configobject

​Generate AI content › Responses

    • textstring

      The generated content

    • credits_usedinteger

      Credits consumed

POST /content/generate

​Schedule a post to social platforms

POST
https://api.socialneuron.com/api/v1
/posts/schedule

Schedule content to one or more connected social media platforms. Supports YouTube, TikTok, Instagram, and LinkedIn.

​Schedule a post to social platforms › Request Body

  • platformsstring[] · required

    Target platforms

    Enum values:
    youtube
    tiktok
    instagram
    linkedin
  • captionstring

    Post caption or description

  • mediaUrlstring · uri

    URL of the media to post (video or image)

  • scheduledAtstring · date-time

    When to publish (ISO 8601). If omitted, posts immediately.

  • projectIdstring · uuid

    Project ID to associate the post with

​Schedule a post to social platforms › Responses

    • successboolean
    • jobIdstring

      Async job ID for tracking

    • scheduledAtstring · date-time
POST /posts/schedule

​Fetch content analytics

GET
https://api.socialneuron.com/api/v1
/analytics

Retrieve performance analytics for your published content. Returns engagement metrics including views, likes, shares, comments, and saves.

​Fetch content analytics › query Parameters

  • platformstring · enum

    Filter by platform

    Enum values:
    youtube
    tiktok
    instagram
    linkedin
  • projectIdstring · uuid

    Filter by project

  • daysinteger

    Number of days to look back

    Default: 7

​Fetch content analytics › Responses

    • successboolean
    • postsProcessedinteger
    • resultsobject[]
GET /analytics

​Fetch trending topics

GET
https://api.socialneuron.com/api/v1
/trends

Research trending content from YouTube, Google Trends, and RSS feeds. Use to inform content planning and ideation.

​Fetch trending topics › query Parameters

  • sourcestring · enum · required

    Trend data source

    Enum values:
    youtube
    google_trends
    rss
    url
  • categorystring · enum

    Content category

    Enum values:
    general
    entertainment
    education
    howto
    science
    tech
    people
    news
    Default: general
  • nichestring

    Filter by niche keywords

  • urlstring · uri

    RSS feed or page URL (required for rss/url sources)

​Fetch trending topics › Responses

    • trendsobject[]
    • sourcestring
    • countinteger
    • cachedboolean
GET /trends

​Generate a video with AI

POST
https://api.socialneuron.com/api/v1
/media/video

Create AI-generated videos using multiple providers (Veo 3, Sora 2, Runway, Kling). Returns a job ID for async tracking via /media/status.

​Generate a video with AI › Request Body

  • promptstring · required

    Video generation prompt

    Example: A 30-second product showcase of eco-friendly sneakers
  • modelstring · enum

    Video generation model

    Enum values:
    veo3
    sora2
    runway
    kling
  • durationinteger

    Video duration in seconds

    Default: 10
  • aspectRatiostring · enum
    Enum values:
    16:9
    9:16
    1:1
    Default: 9:16

​Generate a video with AI › Responses

    • successboolean
    • jobIdstring

      Job ID for status polling

    • estimatedTimeinteger

      Estimated completion time in seconds

POST /media/video

​Generate an image with AI

POST
https://api.socialneuron.com/api/v1
/media/image

Create AI-generated images for social media posts, thumbnails, and marketing materials.

​Generate an image with AI › Request Body

  • promptstring · required

    Image generation prompt

    Example: Minimalist flat-lay of sustainable fashion accessories
  • aspectRatiostring · enum
    Enum values:
    16:9
    9:16
    1:1
    4:5
    Default: 1:1
  • stylestring

    Visual style guidance

​Generate an image with AI › Responses

    • successboolean
    • jobIdstring
POST /media/image

​Check async job status

GET
https://api.socialneuron.com/api/v1
/media/status

Poll the status of an async media generation job (video, image, voiceover). Returns the result URL when complete.

​Check async job status › query Parameters

  • taskIdstring · required

    The job/task ID returned from a generation endpoint

​Check async job status › Responses

    • statusstring · enum
      Enum values:
      pending
      processing
      completed
      failed
    • resultUrlstring · uri

      URL of the generated media (when completed)

    • progressnumber

      Progress percentage (0-100)

    • errorstring

      Error message (when failed)

GET /media/status

​Get brand profile

GET
https://api.socialneuron.com/api/v1
/brand/profile

Retrieve the brand profile for a project, including brand voice, messaging pillars, target audience, and platform-specific voice adaptations.

​Get brand profile › query Parameters

  • projectIdstring · uuid · required

    Project ID

​Get brand profile › Responses

    • namestring
    • voicestring
    • industrystring
    • pillarsstring[]
    • targetAudiencestring
    • platformVoicesobject
GET /brand/profile

​Get credit balance

GET
https://api.socialneuron.com/api/v1
/credits/balance

Check your current credit balance, monthly allocation, and usage.

​Get credit balance › Responses

    • balanceinteger

      Current credit balance

    • monthlyAllocationinteger

      Credits allocated per month

    • usedinteger

      Credits used this billing period

    • resetsAtstring · date-time

      When credits reset

GET /credits/balance

​AI content brain analysis

POST
https://api.socialneuron.com/api/v1
/content/brain

Get AI-powered analysis and recommendations for your content strategy. Combines brand profile, analytics, and trends to provide actionable insights.

​AI content brain analysis › Request Body

  • querystring

    What you want to analyze or get recommendations for

    Example: What content should I create next week?
  • projectIdstring · uuid

    Project context

​AI content brain analysis › Responses

    • analysisstring
    • recommendationsstring[]
    • confidencenumber
POST /content/brain