Name: Flypost Protocol
Author: Flypost

01 / Product Surfaces

Flypost Ask

Public, read-only discovery of real estate events via geographic search. Human interface at ask.goflypost.com — API calls go to api.goflypost.com.

Auth: None (Public)
API Base: api.goflypost.com
OpenAPI: /.well-known/openapi.yaml
LLM Manifest: /.well-known/llm.txt

Flypost Post

Authenticated ingest for publishing structured events via natural language.

Auth: Firebase (browser) or x-flypost-write-token (server)
API Base: api.goflypost.com
Rate: 500 req / 15 min

02 / Quickstart

Find Events Near Santa Monica

                curl -X GET "https://api.goflypost.com/v1/events/near?lat=34.0195&lng=-118.4912&radius=5"
            

Publish an Open House

curl -X POST "https://api.goflypost.com/api/parse-and-publish" \
  -H "Content-Type: application/json" \
  -H "x-flypost-write-token: YOUR_TOKEN" \
  -d '{
    "naturalLanguageInput": "Open house at 810 Franklin St, Santa Monica, CA on Jan 15 from 1-4pm. https://example.com/listing/810"
  }'

Write tokens are issued per agent or integration. Sign in at post.goflypost.com with your email to generate one.

The response includes a shareUrl — a fully rendered page ready to send immediately via text, email, or social.

See a Live Share Page

goflypost.com/e/open-house-at-2530-beverley-ave-santa-monica/evt_o2tdxj3yj_1773082280508_fpid

Every published event gets a share page with GPS-gated check-in, calendar download, and directions.

03 / Authentication

Publishing requires a write token. There are two ways to authenticate — both start with your email.

Human Agents

Sign in at post.goflypost.com with your email. A magic link lands in your inbox — click it and you're in. Publish events via natural language from the browser.

AI Agents & Integrations

Sign in once at post.goflypost.com to generate a static write token. Use it in any agent or server integration via the x-flypost-write-token header.

curl -X POST "https://api.goflypost.com/api/parse-and-publish" \
  -H "x-flypost-write-token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"naturalLanguageInput": "Open house at 123 Main St, Santa Monica on Mar 15 from 1-4pm."}'

04 / Publishing Best Practices

Recommended Fields

For best results, include: event type (open house), full address, date, start/end time window, and an https:// listing URL when available. List price is optional; never invent prices or details.

Presence Integrity

Each stored event includes a SHA-256 hash (event.hash) for integrity verification. Discovery responses may also expose a hash field (e.g., dataHash) depending on surface/version.

Documentation