GooseholdDevelopers
BUILD ON GOOSEHOLD

One login.
One graph.
Very little faff.

GooseID Connect, age-aware identity, trust, commerce, messaging, share previews and simple APIs for Goosehold and external business websites.

Start in 5 minutesUse WordPress
● ● ●
<button onclick="Goosehold.signIn()">
  Continue with Goosehold
</button>

<meta property="goosehold:title"
      content="My brilliant page">
<meta property="goosehold:entity"
      content="business:my-business">
QUICKSTART

For devs and normos.

Create an app, copy two values, use PKCE. WordPress can do almost all of it for you.

1

Create an app

Give Goosehold the name of your site and its callback URL.

2

Add the button

Use the tiny SDK, a WordPress plugin, or normal OAuth requests.

3

Ask only for what you need

Profile, age band, Trust, Shopping, Merchant or Messenger scopes are explicit.

YOUR APPS

Developer apps

Sign in with Goosehold to create and manage apps.

GOOSEID CONNECT

Login with Goosehold

Authorization Code + PKCE. A central GooseID session means a person can move between Goosehold services without entering their password again.

Authorise

GET https://auth.goosehold.io/
 ?client_id=YOUR_CLIENT_ID
 &redirect_uri=YOUR_CALLBACK
 &state=RANDOM_STATE
 &code_challenge=SHA256_PKCE
 &scope=profile email age

Exchange

POST https://api.goosehold.io/v1/oauth/token
{
  "client_id": "…",
  "client_secret": "…",
  "code": "…",
  "code_verifier": "…",
  "redirect_uri": "…"
}
Age without birthdays. Third-party apps receive an age band / adult flag when the age scope is approved. Exact date of birth is not sent through GooseID Connect.
GOOSEHOLDGRAPH + GOOSEHOLDCARD

A website can be more than a URL.

GooseholdGraph gives people, businesses, products, events and other things durable identities. GooseholdCard controls how a public URL presents when it is shared.

HTML metadata

<meta property="goosehold:title" content="Page title">
<meta property="goosehold:description" content="Useful summary">
<meta property="goosehold:image" content="https://…/image.jpg">
<meta property="goosehold:type" content="product">
<meta property="goosehold:entity" content="business:my-shop">
<meta property="goosehold:age_min" content="0">

Graph + preview APIs

GET /v1/graph/search?q=coffee
GET /v1/graph/entities/my-business
GET /v1/cards/resolve?url=https%3A%2F%2F…
GET /v1/cards/spec

Preview fetching is restricted to public HTTPS destinations. Private/reserved network destinations are blocked.

GOOSEHOLD TRUST

Trust, but explain the bloody number.

The Trust Index is contextual business confidence, split into identity, trading, fulfilment, service, reviews and safety. It is not a universal person-level social-credit score.

GET /trust/business/{slug}Transparent Trust profile
POST /trust/reviewsGooseID-backed reviews
identityVerification evidence
tradingTrading context
fulfilmentDelivery / completion
reviewsReviews + transaction verification
SHOPPING · MARKETPLACE · MESSENGER

Commerce shares the same identity and graph.

Goosehold Shopping is for merchant/new products. Goosehold Marketplace is person-to-person and used/private-sale listings. Goosehold Messenger gives people a persistent conversation with businesses.

SHOPPING

Merchant products

Age-aware product discovery, availability, merchant identity and Goosehold Trust context.

GET /v1/shopping/search
MARKETPLACE

Person-to-person

Adult GooseID at launch, structured listings and transactional seller history rather than a general personality score.

GET /v1/marketplace/search
MESSENGER

Business conversations

One GooseID-backed thread that can begin on a business website and continue inside Goosehold.

POST /v1/messenger/business/thread
PLATFORM API

Age-aware by default.

First-party apps can use richer policy state. External apps start narrow and require explicit capability scopes.

GET /oauth/userinfoSafe profile claims
GET /policy/ageAccount age policy
PUT /watch/currentCross-device watch progress
GET /graph/searchEntity discovery
GET /shopping/searchAge-filtered new products
POST /developer/appsCreate OAuth clients
WORDPRESS

Five plugins. Five “what the fuck is Goosehold?” moments.

Each plugin does one job, can stand alone, and also gives a WordPress.org visitor a legitimate route into discovering the wider Goosehold platform.

ID

Goosehold Connect

“Log in with Goosehold”, PKCE and verified-email WordPress account linking.

Download
↗

Goosehold Card & Share

GooseholdCard metadata, age/audience fields and Share to Goosehold.

Download
✓

Goosehold Trust

Transparent business Trust Index badge and machine-readable Trust profile.

Download
▣

Goosehold Shopping

WooCommerce product feed, age fields and product sharing metadata.

Download
◉

Goosehold Messenger

Add “Message us on Goosehold” to a business website.

Download
WordPress.org-ready packaging. Each package now includes its own plugin readme with a purpose-specific “What is Goosehold?” explanation, so discovery of an individual plugin naturally explains the wider platform without requiring the visitor to already know the brand.
SHARED INFRASTRUCTURE

The next apps do not start from zero.

GooseID, Graph, Trust, Messenger and multilingual account/profile infrastructure become primitives for everything else.

COMING SOON

Goosehold Home

Voice + vision home assistant with explicit microphone/camera state and GooseID age/privacy policy.

LEARNING

Goosehold Triplingo

Practical multilingual language learning attached to the same GooseID learning record.

LANGUAGES

Multilingual platform

Shared locale, translation, speech and content-language primitives for English, Greek, French, Spanish and more.