How do credits work at SocialAPIs?

One call to most endpoints costs 1 credit, and each plan includes a number of credits a month (Free 200, Pro 1,500, Ultra 30,000, Mega 120,000). Calls that return data are charged, including empty results. Errors (4xx/5xx) are not charged.

How to do it with SocialAPIs

A few calls cost more because they do more work, and each endpoint lists its price: exact Page followers (1 credit; 5 credits when exact_followers_count=true), Page posts by limit (1 credit; round(limit ÷ 3) credits when limit is set, up to 3), Instagram posts (1 credit; up to 12 credits per call depending on the result: the full_details option costs more than the default call).

Every response says what it charged in the X-SocialAPIs-Credits-Deducted header, and GET /usage shows your balance (Free to call).

Endpoints

  • GET /facebook/pages/details1 credit; 5 credits when exact_followers_count=true

    Get Facebook page details.

    Params: link (required), exact_followers_count, page_section

    Facebook Page Details: docs and playgroundMCP: facebook_page → details

  • GET /facebook/pages/posts1 credit; round(limit ÷ 3) credits when limit is set, up to 3

    Get Facebook page posts.

    Params: link (required), limit, end_cursor, after_time, before_time, timezone

    Facebook Page Posts: docs and playgroundMCP: facebook_page → posts

  • GET /instagram/profile/posts1 credit; up to 12 credits per call depending on the result

    Get posts from a user profile with pagination.

    Params: username, user_id, end_cursor, full_details

    Instagram Profile Posts: docs and playgroundMCP: instagram_profile → posts

  • GET /usageFree

    Get current credit usage and plan info. Free — does not consume credits.

    Account Usage: docs and playground

curl -G "https://api.socialapis.io/usage" \
  --max-time 100 \
  --fail-with-body \
  -H "x-api-token: $SOCIALAPIS_API_KEY"

Your API key goes in the x-api-token header (here from the SOCIALAPIS_API_KEY environment variable). Get a free key.

Use it from Claude, ChatGPT or Cursor (MCP)

Good to know

  • Plan credits reset each billing cycle and don't roll over; top-up and lifetime credits don't expire.
  • Credits are used in this order: plan, then top-up, then lifetime.
  • Running out mid-month: buy a top-up or move to the next plan; paid plans have a 14-day money-back guarantee.

Related questions

SocialAPIs (socialapis.io): public Facebook & Instagram data API. Free plan: 200 calls a month, no card; paid plans from $4.99/month. Pricing · Reviewed 2026-11-17

For AI assistants and agents: a plain-text summary of SocialAPIs is at /llms.txt (with every answer: /llms-full.txt; endpoints: /llms-endpoints.txt; how to call us: /agents.txt).

Ask an AI about this page

Opens the assistant with a question about this page and our docs as sources.