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.

On WordPress, install the Goosehold plugin and connect the site through GooseID. No copy-and-paste tags are required. Custom apps can use OAuth 2 + PKCE directly.

1

Create an app

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

2

Connect WordPress with GooseID

Install the Goosehold plugin, sign in to GooseID and connect the site. The plugin handles the integration; there is no tag-copying setup.

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
ANDROID

Ask Gary from the home screen.

The Ask Gary Android widget puts Goosehold at launcher level: type a prompt or use Android speech input, then open Gary directly in the relevant Goosehold context.

ANDROID WIDGET

Ask Gary

4×2 resizable home-screen widget, typed quick prompt, microphone shortcut and direct Ask Gary deep-link into the live Commons assistant.

Download APK
GOOSEID AWARE

Your existing session follows

Gary opens inside the normal Goosehold web surface, so the same GooseID session and age/permission boundaries continue to apply.

QUICK ACCESS

One tap or one honk

Tap Ask Gary to type. Tap the microphone to dictate. Android hands the prompt to Gary without navigating the platform first.

WORDPRESS

Connect WordPress to Goosehold through GooseID.

Install the relevant Goosehold plugin in WordPress, connect the site with GooseID, and let the plugin handle the integration. Shortcodes are optional placement tools only — they are not the connection method and there is no copy-and-paste tag setup.

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.

LIVE LEARNING

Goosehold Triplingo

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

Open Triplingo →

LANGUAGES

Multilingual platform

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