Insights & ROI
Sosyabot looks at how your own posts have performed and turns that into plain advice — the best time and format to post, a short weekly summary with next steps, fresh content ideas, and ranked caption options — then links real sales and sign-ups back to the posts that earned them.
Who it's for
- Marketers who want to know what actually works for their account, not generic web averages.
- Small teams that don't have a data analyst and need clear next steps, not raw numbers.
- Anyone who has to prove results — showing which posts led to real sales or sign-ups.
What you can do
- See the best day, time, and post format for your audience, based on your own past results.
- Get a short weekly summary that explains what happened and gives you three things to do next.
- Ask for fresh, ready-to-post content ideas for any topic, each with a suggested caption and format.
- Get several caption options for a post, ranked so the strongest one is at the top.
- Track conversions so a sale or sign-up is tied back to the exact post or campaign that earned it — even when it came from email, your CRM, or offline.
Getting started
Connect accounts and post for a while
Sosyabot learns from your own history, so the advice gets sharper the more you publish. Start from the Composer and keep your accounts connected.
Open your dashboard to see the advice
Your best posting times, weekly summary, and recovered sales all appear on the Analytics dashboard.
Ask for ideas and caption options
When you write a post, request fresh content ideas or ranked caption options and pick the one you like best.
Connect your sales to your posts
Set up conversion tracking so a purchase or sign-up is matched back to the post that drove it — then you can prove the results.
TIP
The advice is built from your account — your best times, your top captions, your brand voice — not generic web averages. The more you publish, the better it gets.
For developers
All endpoints are mounted under the API prefix (/api/v1 by default).
Best-Format Oracle
Predicts when to post, on which network, and at what caption length, from your own PostStats history (not generic guesses).
GET /api/v1/analytics/format-recommendation (auth)The response combines your most active posting slot with the network that has the highest average engagement rate across your top posts, plus a median caption length:
| Field | Meaning |
|---|---|
bestWeekday | Most active weekday (e.g. Tue) |
bestHour | Best hour of day (0–23) |
bestNetwork | Network with highest avg engagement rate |
captionLengthHint | Median length of your top captions |
style | short-punchy (≤140 chars) or detailed |
basis | How many top posts / historical slots informed it |
Insight Narrator
An autonomous weekly digest: a short AI-written narrative plus three concrete next actions, grounded in your own analytics aggregates (last 14 days of engagement trend, top 5 posts, most active slot).
GET /api/v1/analytics/insight-digest?lang=tr|en (auth)Returns { narrative, actions[], generatedAt }. lang defaults to tr. Returns 503 if the AI gateway is not configured.
Trend Radar
Niche-aware, ready-to-post content ideas for a topic — each with a trend angle, a caption, and a suggested format. Grounded in your top posts and brand voice.
POST /api/v1/ai/trend-radar (auth + workspace + active plan, costs 2 AI credits)| Body field | Type | Notes |
|---|---|---|
topic | string | Required — the niche/topic |
count | number | 3–10, default 6 |
language | tr | en | Output language |
Returns { ideas: [{ angle, caption, format }] } where format is single / carousel / reel / story.
Variant Forge
Generates N distinct caption variants and ranks them by predicted engagement lift. The predictor is grounded in your past top-performing captions, so it learns what actually works in your account.
POST /api/v1/ai/variants/captions (auth + workspace + active plan, costs 2 AI credits)topic is required; count is clamped 2–6 (default 4); language is tr/en. Returns { variants: [{ text, score }], best }, sorted by score (0–100) descending.
Performance Feedback Loop
Generative surfaces learn from first-party results. Autonomous agents inject your own analytics into every run — the Best-Format Oracle style/length hint, your best network, and your top past captions to emulate (never copied verbatim). Trend Radar and Variant Forge pull the same top-post grounding plus brand voice. Each run improves on what actually worked. Analytics is best-effort: if it is unavailable, generation still proceeds.
Publish-to-Proof Attribution
A CAPI-style, server-side conversion loop. Conversions are ingested with a scoped API token, de-duplicated, and attributed to the post or campaign that drove them — even from pixel-blind sources (CRM, offline, server, webhook).
POST /api/v1/conversions/ingest (Bearer API token, scope: conversions:write)
GET /api/v1/conversions/summary (auth + workspace)
GET /api/v1/conversions (auth + workspace)Ingest body:
| Field | Notes |
|---|---|
eventName | Defaults to purchase |
value, currency | Currency defaults to TRY |
postId, campaignId | Explicit attribution targets |
utmContent | Resolved as a post id |
utmCampaign | Resolved by campaign name |
source | e.g. capi, crm, offline, webhook |
dedupKey | Idempotency key |
Attribution order: explicit postId → utm_content as post id → explicit campaignId → utmCampaign by name → campaign inherited from the attributed post. A duplicate dedupKey returns 200 (deduped); a new event returns 201.
GET /conversions/summary?fromDays=90 returns total and attributed conversions/value, the recoveredConversions count (attributed by Sosyabot from pixel-blind sources), and top posts/campaigns by value. The Attribution page visualizes this ROI, including the conversions that pixels alone would have missed.