Developer

3. Quickstart

Five steps from zero to your first successful API call:

  1. Sign up at zippfeed.com/developer/signup and verify your email.
  2. Create a workspace — one workspace per site or app you'll serve content on. Admin review typically lands within one business day.
  3. Mint an API key from the approved workspace (/developer/workspaces/{id}/keys). You see the full zk_… value once at creation — copy it then. The server only stores a hash.
  4. Embed the badge snippet on your site — a one-line <script src="…/widget.js" data-embed-id="bdg_…" async></script> tag from the Console. The script auto-pings our heartbeat endpoint on every page view, which keeps your workspace healthy (see §4.4 for the 72h enforcement).

  5. Make your first call:

    curl -H "Authorization: Bearer zk_YOUR_KEY" \
     "https://zippfeed.com/api/v1/developer/posts?limit=5"

    You should receive a JSON object with a posts array and next_cursor / prev_cursor fields.

Stuck? The /developer/onboarding page in your Console shows the live status of every step.