Social Fetch
Get API key
All use cases

Social data API for agencies

Profiles, posts, ad library creative, and metrics across client networks — one schema, prepaid credits per account.

Try in playgroundView pricing

What usually breaks first

Common failure modes after a DIY scraper or marketplace API hits production — schema drift, billing surprises, and pagination quirks.

Agency reporting fails on procurement: multiple vendors, JSON shapes, and invoices per network. A new platform mid-retainer means another integration before the monthly report ships.

Prepaid credits (no expiry) fit bursty QBR work. One envelope keeps Looker models and client portals stable when upstream fields rename.

6 routes for this job

Routes used in live agencies integrations (Instagram, TikTok, YouTube, linkedin, and Facebook). Paths and params match OpenAPI; documented fields ship in responses.

  • GET /v1/instagram/profiles/{handle}/posts

    Paginated posts for client content calendars and monthly engagement snapshots.

  • GET /v1/tiktok/profiles/{handle}/videos

    Recent TikTok videos with view and engagement counts for campaign wrap-ups.

  • GET /v1/youtube/channel

    YouTube channel stats from a URL or handle when clients expand beyond short-form.

  • GET /v1/linkedin/companies

    LinkedIn company profile for B2B client audits and employer-brand reports.

  • GET /v1/facebook/ad-library/ads/search

    Live Meta ad creative and copy for competitive audits and new-business pitches.

  • GET /v1/instagram/profiles/{handle}

    Follower counts, bio, and verification status when onboarding new client handles.

OpenAPI reference →

How teams wire this

Typical order starts with “pull competitors for the pitch.” Adjust cadence, schema, and thresholds to your stack.

  1. 1

    Pull competitors for the pitch

    Before the new-business meeting, search the Meta Ad Library and pull recent posts from the prospect's rivals. Same API key, same response envelope. Your pitch deck template does not fork per platform.

  2. 2

    Onboard handles into your client database

    When the SOW is signed, store each client's social accounts with a client_id foreign key. Profile endpoints return lookupStatus so you can flag typos or renamed handles before the first live report runs.

  3. 3

    Map report templates to endpoints once

    Your monthly PDF, client portal tile, and Looker dashboard all read from normalized JSON. Instagram posts and TikTok videos land in the same engagement table because field names stay consistent even when platforms change upstream.

  4. 4

    Batch refresh on your cadence

    Run weekly cron jobs for active clients and monthly jobs for retainers. No published rate cap beyond your credit balance. Burst hard the night before a QBR without calling sales to bump a subscription tier.

  5. 5

    Allocate credits per client for margin

    Tag each request with a client identifier in your own logging layer. Pay-as-you-go credits are prepaid and never expire, so you can bill clients a flat reporting fee and keep the spread between your API cost and the retainer line item.

  6. 6

    Ship white-label deliverables

    Drop JSON into Google Slides automation, a custom portal, or a CSV export for account managers who still work in Sheets. Your brand stays on the cover; the data layer stays boring underneath.

Example: competitive ad audit before a pitch

Swap YOUR_API_KEY for a dashboard key. The playground pre-fills auth for the same path.

Request
Example: competitive ad audit before a pitch

Why agencies standardize on Social Fetch

  • 21 platforms on one key means fewer vendor reviews and one line item in your agency P&L.
  • Prepaid credits with no expiry: allocate spend per client instead of paying a flat subscription while dormant accounts sit idle.
  • No per-seat API tax. Interns, freelancers, and overnight cron jobs share the same key without seat math.
  • Same data envelope on Instagram, TikTok, YouTube, LinkedIn, and the rest. Your ETL code does not fork per network.
  • Schema stability as an operational promise: when Meta renames a field, your client dashboards keep working.
  • Completed lookups charge credits; infrastructure failures (lookup_failed, 503) do not. Predictable cost for margin planning.
  • Social Freak Ltd is a registered UK company when procurement asks who operates the API and how data is handled.

Run a agencies lookup on free credits

100 credits on signup — run the curl above, inspect lookupStatus and meta.creditsCharged, then buy a pack when ready. Balances do not expire.

Open playgroundSee pricing