Resources

Changelog

Track every change to the Outfame API. We follow semantic versioning and publish updates here as they ship. Subscribe to the status page for real-time notifications.

Versioning policy — The API uses URL-based versioning (/v1/). Non-breaking additions (new fields, new endpoints) are shipped without a version bump. Breaking changes will be introduced in /v2/ with a 12-month migration window.

February 2026

v1.4.0 — February 1, 2026

New features

  • TikTok growth analytics — The Analytics API now returns TikTok-specific metrics including video views, shares, duets, and stitches in the engagement breakdown. Available on all endpoints for accounts with platform: "tiktok".
  • Audience demographics endpoint — New GET /v1/analytics/audience endpoint returns detailed demographic data including age, gender, country, city distribution, quality score, and bot percentage.
  • Audience quality score — Every account now has a quality_score (0-100) that reflects the overall quality of the follower base. Accessible via both the Accounts and Analytics APIs.

Improvements

  • Analytics growth endpoint now supports granularity: "monthly" for long-term trend analysis.
  • Webhook delivery latency reduced by 40% (median 180ms, down from 300ms).
  • Python SDK 1.8.0 released with full audience analytics support.

Bug fixes

  • Fixed engagement_rate_change returning null for accounts less than 48 hours old.
  • Fixed pagination cursor not working correctly when filtering by status on the accounts list endpoint.

January 2026

v1.3.2 — January 15, 2026

New features

  • Location radius targeting — Locations now accept a radius_km parameter (1-200km) for precise geographic targeting. Previously, locations targeted the entire metro area.
  • AI targeting accuracy improvement — The ML model was retrained with 23% more interaction data, resulting in a measurable improvement in follow-back rate prediction accuracy (AUC increased from 0.862 to 0.891).

Improvements

  • AI suggestions endpoint now returns estimated_impact with percentage estimates for growth rate, engagement rate, and audience quality changes.
  • POST /v1/targeting/suggestions response time improved by 35% (avg 1.2s, down from 1.8s).
  • Node.js SDK 2.4.0 released with auto-pagination support.

Bug fixes

  • Fixed rare case where account.growth_milestone webhook fired twice for the same milestone.
  • Fixed min_engagement_rate filter not being applied correctly when combined with activity_level: "very_high".

December 2025

v1.3.0 — December 20, 2025

New features

  • Webhook retry improvements — Retry policy updated from 2 retries to 3 retries with exponential backoff (1m, 5m, 30m). Failed delivery details are now visible in the dashboard.
  • engagement.daily_summary event — New webhook event that fires daily at 23:55 UTC with a full summary of all engagement actions, follower changes, and performance metrics for each active account.
  • account.status_changed event — New webhook event for tracking account status transitions (setup → active, active → paused, etc.).

Improvements

  • Webhook signature now includes a timestamp to prevent replay attacks. New header: X-Outfame-Timestamp.
  • All API error responses now include a doc_url field linking to relevant documentation.
  • DELETE /v1/accounts/:id now returns { id, deleted: true } instead of 204 No Content for easier confirmation handling.

Deprecations

  • The X-Outfame-Signature-V1 header is deprecated in favor of X-Outfame-Signature. The V1 header will be removed on March 20, 2026.

November 2025

v1.2.0 — November 10, 2025

New features

  • Python SDK async support — The outfame Python package now includes AsyncClient with full async/await support via httpx. All methods mirror the synchronous client.
  • PHP SDK Laravel integration — The PHP SDK now ships with a Laravel service provider, automatic container binding, and php artisan vendor:publish support.
  • Custom audience segments — Turbo plan accounts can now create named audience segments with independent targeting configurations and weight-based action allocation.

Improvements

  • Node.js SDK now exports all TypeScript types from the package root.
  • PHP SDK updated to support PHP 8.3.
  • API response times improved by 15% across all analytics endpoints through query optimization.

October 2025

v1.1.0 — October 1, 2025

New features

  • A/B testing for targeting — New documentation and SDK helpers for running controlled experiments with different targeting configurations across multiple accounts.
  • AI optimization modes — The ai_optimization config now accepts a mode field: conservative, balanced, or aggressive, giving you control over how actively the AI adjusts targeting.
  • quality_threshold parameter — Set a minimum quality score for targeted users. Higher thresholds yield better audience quality at the cost of slower growth.

Improvements

  • Engagement activity logs now include a source field indicating which targeting input (competitor, hashtag, or location) produced each action.
  • Rate limit headers are now included on 429 responses (previously only on successful responses).
  • Sandbox environment now simulates realistic analytics data for testing dashboards.

Bug fixes

  • Fixed PATCH /v1/accounts/:id not accepting partial daily_limits updates (previously required all fields).
  • Fixed OAuth refresh token rotation not invalidating the previous refresh token.

September 2025

v1.0.0 — September 1, 2025

Initial release

  • Full REST API for account management, targeting, engagement, and analytics.
  • OAuth 2.0 authentication with authorization code flow.
  • API key authentication with granular scopes.
  • Webhook subscriptions with HMAC-SHA256 signature verification.
  • Official SDKs for Node.js (v2.0.0), Python (v1.0.0), and PHP (v1.0.0).
  • Sandbox environment for development and testing.
  • AI-powered targeting suggestions endpoint.
  • Rate limiting with plan-based tiers.

This was the initial public release of the Outfame API. If you are migrating from the legacy dashboard-only workflow, see the Quick Start guide for integration steps.