FireRankings API

    Integrate FireRankings' powerful content generation into your applications

    Email Software@upcode.com to have your API access permitted

    Getting Started

    Authentication and Base URL

    Base URL

    https://wecpvoghtfwgmecnckud.supabase.co/functions/v1/api

    Authentication

    All API requests require an API key. Include your key in the request headers:

    x-api-key: YOUR_API_KEY

    Generate your API key from your dashboard settings.

    Create Universal Content

    POST

    /content

    Create one draft or scheduled item across connected social, blog, and email destinations. Use this for Zapier, Make, n8n, Airtable, Notion, CRMs, or custom apps.

    Request Body

    {
      "mode": "scheduled",
      "title": "How to walk a dog",
      "body": "Full post content in Markdown or plain text.",
      "text": "Short social caption",
      "destinations": ["linkedin", "facebook", "blog", "email"],
      "scheduled_for": "2026-08-01T15:00:00Z",
      "media_urls": ["https://example.com/image.jpg"],
      "link_url": "https://example.com",
      "source": "zapier",
      "blog": {
        "platform": "wordpress",
        "seo_title": "How to walk a dog",
        "seo_description": "A practical dog walking guide."
      },
      "email": {
        "subject": "How to walk a dog"
      }
    }

    Example Request

    curl -X POST 'https://wecpvoghtfwgmecnckud.supabase.co/functions/v1/api/content' \
      -H 'x-api-key: YOUR_API_KEY' \
      -H 'Content-Type: application/json' \
      -d '{
        "mode": "draft",
        "title": "How to walk a dog",
        "body": "Start with a comfortable leash...",
        "destinations": ["linkedin", "blog"],
        "media_urls": ["https://example.com/dog.jpg"],
        "source": "make"
      }'

    Response

    {
      "success": true,
      "campaignId": "uuid",
      "workspaceId": "uuid",
      "mode": "draft",
      "status": "draft",
      "scheduled_for": null,
      "created": {
        "social": { "id": "uuid", "platforms": ["linkedin"] },
        "blog": { "id": "uuid", "platform": "wordpress" }
      }
    }

    The universal endpoint supports draft and scheduled modes. Immediate publishing is handled inside the app so users can review destination-specific settings first.

    Rate Limits & Errors

    Error Responses

    • 401 - Invalid or missing API key
    • 404 - Endpoint not found
    • 400 - Bad request (missing required fields)
    • 500 - Internal server error

    Example Error Response

    {
      "error": "API key required. Include x-api-key header."
    }