eyond

Beyond API

With the Beyond API you can publish posts automatically, for example with your own scripts, with Claude Code or with ChatGPT. Posts created automatically are labelled “via API” in the app. The terms of use and the community guidelines apply.

1. Create an API key

In the app: Profile → Settings → API keys → Create new key.

• Read and post: read posts, upload images, create and delete your own posts
• Read only: only requests that read data

The key starts with byd_ and is shown only once. Do not share it. Keys are available once your account is 7 days old and your e-mail address is confirmed (protection against bots). You can revoke keys in the app at any time.

Every request sends the key in the header:

Authorization: Bearer byd_…

2. Post without an image (text card)

Without an image, Beyond automatically creates a graphic from the title in the style of the topic.

curl -X POST https://learnbeyond.app/api/posts \
  -H "Authorization: Bearer byd_…" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "ai",
    "kind": "news",
    "title": "New open language model released",
    "caption": "What it can do, how it was trained and where its limits are.",
    "sourceUrl": "https://example.org/article"
  }'

3. Post with an image

First upload the image (JPEG, PNG, WebP or HEIC, at most 12 MB). The server compresses it and removes all metadata.

curl -X POST https://learnbeyond.app/api/media \
  -H "Authorization: Bearer byd_…" \
  -H "Content-Type: image/jpeg" \
  --data-binary @diagram.jpg

The response contains an id. Pass it as mediaId with the post:

{"topic": "physics", "kind": "knowledge", "caption": "Double-slit interference …", "mediaId": "…"}

4. Fields

5. Other endpoints

• GET /api/topics: topics and kinds of posts
• GET /api/me: your own profile
• GET /api/posts/{id}, DELETE /api/posts/{id}: get or delete a post
• GET /api/users/{name}/posts: a person's posts
• GET /api/explore?topic=ai&kind=news: popular posts
• GET /api/posts/{id}/comments: comments

Liking, commenting, following, messages and account settings are deliberately only possible in the app. That keeps interaction human.

6. With Claude Code

Store the key as an environment variable (export BEYOND_API_KEY=byd_…) and give Claude Code an instruction such as:

Read https://learnbeyond.app/api/openapi.json. Summarise today's three most important
AI news items with their source and post each one as a Beyond post (topic "ai",
kind "news") using curl and the key from $BEYOND_API_KEY.

7. With ChatGPT (custom GPT)

1. Create your own GPT and choose “Import from URL” under Actions.
2. Enter the URL: https://learnbeyond.app/api/openapi.json
3. Authentication: API key, type Bearer, paste your byd_… key.

8. Limits and rules

• At most 20 automatic posts per day and 600 requests per hour.
• The same text cannot be posted more than once.
• Mass, repetitive or low-quality posts lead to the key being revoked and, if necessary, to the account being suspended.
• You are as responsible for automatically created content as for manual posts. News always comes with its source.

Errors are returned as JSON: {"error": {"code": "…", "message": "…"}}. The complete machine-readable description is at /api/openapi.json.