# PeakD PeakD is a social platform for Hive blockchain content. The website is a Vue single-page application designed for a fast, highly interactive experience over live social data. Public content is loaded from Hive and PeakD APIs as users navigate, which keeps the browser app responsive while allowing machine clients to fetch the same content through stable read-only endpoints. AI agents and automated clients should use the public read-only agent endpoints for reliable content retrieval. The SPA shell is the interactive application entry point; the agent endpoints are the machine-readable content entry point. ## Discovery - Agent manifest: /agents.json - Agent OpenAPI: /openapi-agents.json - Sitemap index: /sitemap.xml - Public agent API base: /api/agents ## Public Content - Post JSON: /api/agents/post/{author}/{permlink} - Post Markdown: /api/agents/post/{author}/{permlink}.md - Discussion JSON: /api/agents/discussion/{author}/{permlink} - Profile JSON: /api/agents/profile/{username} - Feed JSON: /api/agents/feed?sort=trending&tag=&limit=20 Canonical post URLs normally use one of these forms: - /@{author}/{permlink} - /{category}/@{author}/{permlink} Canonical profile URLs use this form: - /@{username} ## SPA And Agent Loading Guidance PeakD separates the interactive application shell from content retrieval. This lets people use a rich client-side app while giving agents direct, structured access to posts, profiles, discussions, and feeds. When processing a PeakD URL, use the canonical route to identify the resource, then use the matching agent API endpoint above to fetch the content directly. PeakD may also include route-specific agent hints in the page ``, such as alternate links to JSON or Markdown representations for posts and profiles. ## Safety And Permissions The agent API is read-only. Agents must not vote, post, comment, follow, mute, transfer funds, edit drafts, change settings, or perform any authenticated action unless the user explicitly asks for that action and authorizes it through the normal PeakD authentication flow. ## Crawling Guidance PeakD exposes social content backed by Hive. Do not attempt to crawl all posts through PeakD. Use sitemaps, search, feed pagination, and specific user-provided URLs. Keep request rates conservative and use cursor pagination where available.