Friendbuy

Friendbuy is a referral and loyalty marketing platform for ecommerce and direct-to-consumer brands. Merchants launch referral, loyalty, and reward campaigns through on-site widgets and a no-code dashboard, and integrate server-to-server through the Friendbuy Merchant API (base https://mapi.fbot.me/v1). The Merchant API lets merchants sync customer records, generate personal referral links, track purchase / sign-up / custom conversion events, pull campaign and reward analytics, and manage loyalty ledger balances, adjustments, redemptions, and coupons. Authentication is a key/secret exchange at POST /authorization that returns a short-lived Bearer JWT. Access to the API and to production credentials is gated behind a paid, contact-sales plan.

Friendbuy publishes 7 APIs on the APIs.io network, including Analytics API, Authorization API, Customers API, and 4 more. Tagged areas include Referral Marketing, Loyalty, Rewards, E-Commerce, and Marketing.

The Friendbuy catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Friendbuy’s developer surface includes authentication, documentation, engineering blog, changelog, API reference, getting-started guide, support, and 24 more developer resources.

🌐 Visit website 📡 Source on GitHub

60.0/100 strong ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-24 · rubric v0.13.0

AccessPaidSelf serve

7 APIs

Referral Marketing Loyalty Rewards E-Commerce Marketing Advocacy

Kin Score

Kin Score How this is scored →
scored 2026-08-24 · rubric v0.13.0

Composite quality — 60.0/100 · strong

Contract Quality 16.1 / 25

Developer Ergonomics 10.8 / 20

Access Clarity 13.4 / 20

Operational Transparency 9.6 / 13

Contract Governance 2.0 / 12

Discoverability 8.2 / 10

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/friendbuy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Friendbuy Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

Login

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

AgentSkill

AgentSkill

LLMsTxt

LLMsTxt

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

Lifecycle

Conformance

Webhooks

DataModel

Components

Scroll for all 7

Build 3

SDKs, sample code, and the tooling you integrate with

Packages

Packages

SDKs

SDKs

GitHubOrganization

GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 4

Status, limits, changes, and where to get help

RateLimits

StatusPage

ChangeLog

Support

Commercial 4

Pricing, plans, and the legal terms of use

Plans

FinOps

TermsOfService

PrivacyPolicy

Company 3

The organization behind the API

LinkedIn

Website

Website

Blog

Blog

Source (apis.yml)

aid: friendbuy
url: https://raw.githubusercontent.com/api-evangelist/friendbuy/refs/heads/main/apis.yml
name: Friendbuy
kind: company
description: Friendbuy is a referral and loyalty marketing platform for ecommerce and direct-to-consumer brands. Merchants
  launch referral, loyalty, and reward campaigns through on-site widgets and a no-code dashboard, and integrate server-to-server
  through the Friendbuy Merchant API (base https://mapi.fbot.me/v1). The Merchant API lets merchants sync customer records,
  generate personal referral links, track purchase / sign-up / custom conversion events, pull campaign and reward analytics,
  and manage loyalty ledger balances, adjustments, redemptions, and coupons. Authentication is a key/secret exchange at POST
  /authorization that returns a short-lived Bearer JWT. Access to the API and to production credentials is gated behind a
  paid, contact-sales plan.
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/friendbuy.png
tags:
- Referral Marketing
- Loyalty
- Rewards
- E-Commerce
- Marketing
- Advocacy
tags_raw:
- Referral Marketing
- Loyalty
- Rewards
- Ecommerce
- Marketing
- Advocacy
created: '2026-07-10'
modified: '2026-08-13'
specificationVersion: '0.23'
apis:
- aid: friendbuy:friendbuy-analytics-api
  name: Friendbuy Analytics API
  description: Pull campaign, share, click, conversion, and reward analytics.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Analytics
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-analytics-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-analytics-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-authorization-api
  name: Friendbuy Authorization API
  description: Exchange account key and secret for a Bearer token.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-authorization-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-authorization-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-customers-api
  name: Friendbuy Customers API
  description: Create and retrieve customer records and manage customer data requests.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-customers-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-customers-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-events-api
  name: Friendbuy Events API
  description: Track purchase, sign-up, and custom conversion events.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-events-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-events-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-management-api
  name: Friendbuy Management API
  description: Block users from campaigns.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Management
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-management-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-management-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-referrals-api
  name: Friendbuy Referrals API
  description: Generate personal referral links and check referral status.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Referrals
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-referrals-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-referrals-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
- aid: friendbuy:friendbuy-rewards-loyalty-api
  name: Friendbuy Rewards & Loyalty API
  description: Manage loyalty ledger balances, adjustments, redemptions, and coupons.
  humanURL: https://developers.friendbuy.com
  baseURL: https://mapi.fbot.me/v1
  tags:
  - Rewards & Loyalty
  properties:
  - type: OpenAPI
    url: openapi/friendbuy-rewards-loyalty-api-openapi.yml
  - type: Overlay
    url: overlays/friendbuy-rewards-loyalty-overlay.yaml
  - type: Documentation
    url: https://developers.friendbuy.com
  - type: APIReference
    url: https://developers.friendbuy.com
  - type: PostmanCollection
    url: collections/friendbuy.postman_collection.json
  - type: OpenCollection
    url: collections/friendbuy.opencollection.json
common:
- type: AgenticAccess
  url: agentic-access/friendbuy-agentic-access.yml
- type: DomainSecurity
  url: security/friendbuy-domain-security.yml
- type: Authentication
  url: authentication/friendbuy-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/friendbuy
- type: Website
  url: https://friendbuy.com
- type: Documentation
  url: https://developers.friendbuy.com
- type: Plans
  url: plans/friendbuy-plans-pricing.yml
- type: RateLimits
  url: rate-limits/friendbuy-rate-limits.yml
- type: FinOps
  url: finops/friendbuy-finops.yml
- url: https://friendbuy.com/blog
  type: Blog
- type: Packages
  url: packages/friendbuy-packages.yml
- type: SDKs
  url: packages/friendbuy-packages.yml
- type: Conventions
  url: conventions/friendbuy-conventions.yml
- type: ErrorCatalog
  url: errors/friendbuy-problem-types.yml
- type: Lifecycle
  url: lifecycle/friendbuy-lifecycle.yml
- type: StatusPage
  url: https://friendbuy.statuspage.io
- type: Conformance
  url: conformance/friendbuy-conformance.yml
- type: Webhooks
  url: asyncapi/friendbuy-webhooks.yml
- type: DataModel
  url: data-model/friendbuy-data-model.yml
- type: Components
  url: components/friendbuy-components.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/friendbuy-llms.txt
- type: ChangeLog
  url: https://www.friendbuy.com/product-updates
- type: DeveloperPortal
  url: https://developers.friendbuy.com
- type: APIReference
  url: https://developers.friendbuy.com
- type: GettingStarted
  url: https://developers.friendbuy.com#integration-setup
- type: Support
  url: https://support.friendbuy.com
- type: GitHubOrganization
  url: https://github.com/friendbuy
- type: Login
  url: https://retailer.fbot.me
- type: TermsOfService
  url: https://friendbuy.com/terms-of-service
- type: PrivacyPolicy
  url: https://friendbuy.com/privacy
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
x-enrichment:
  date: '2026-08-13'
  status: enriched
  artifacts_added: 24
  pass: local-v1

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/friendbuy"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/friendbuy/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/friendbuy/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.