FoundOnArdy Creator API

Submit published YouTube, Medium, and Substack content to FoundOnArdy.

FoundOnArdy does not re-upload or host your original content. Your video, article, or newsletter stays on its original platform or creator-owned site. FoundOnArdy indexes submitted information and links people back to the original source.

Production endpoint:

POST https://www.foundonardy.com/api/creator/submissions

Want to try FoundOnArdy manually first?

You do not need the API for a first test.

1. Create or sign in to your FoundOnArdy account.
2. Open Add Content.
3. Paste one content link and its details.
4. Submit it.

If you publish regularly and want to automate submissions, use the Creator API.

Creator guide: https://www.foundonardy.com/content-creators/

Supported sources

Source	Creator verification	API behavior
YouTube	Verify your YouTube channel in FoundOnArdy Account settings	New creators are reviewed first. Eligible trusted YouTube creators may later have valid submissions added automatically.
Medium	No platform OAuth in this version	Valid submissions enter admin review. Hosted Medium URLs and creator custom-domain URLs are supported.
Substack	No platform OAuth in this version	Valid submissions enter admin review. Hosted Substack URLs and creator custom-domain URLs are supported.

Medium and Substack submissions do not inherit automatic publishing from a creator's YouTube history.

Requirements

• A FoundOnArdy account.
• Content you own, control, or are authorized to manage.
• A Creator API key from FoundOnArdy Account settings.
• For YouTube submissions only: a verified YouTube channel.

Get API access

1. Sign in at https://www.foundonardy.com/account/
2. Open the Creator Publishing API card.
3. Create an API key.
4. Save the key safely. The full key is shown only once.
5. If you will submit YouTube videos, verify your YouTube channel.

Minimal quickstart

Set your key as an environment variable:

export FOA_API_KEY="YOUR_FOA_API_KEY"

Submit a YouTube video:

curl -X POST https://www.foundonardy.com/api/creator/submissions \
  -H "Authorization: Bearer $FOA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_platform": "youtube",
    "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Example: How I organize useful AI videos"
  }'

Submit a Medium article:

curl -X POST https://www.foundonardy.com/api/creator/submissions \
  -H "Authorization: Bearer $FOA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_platform": "medium",
    "url": "https://medium.com/@example/useful-post",
    "title": "Example Medium article",
    "author_name": "Example Creator"
  }'

Submit a Substack post:

curl -X POST https://www.foundonardy.com/api/creator/submissions \
  -H "Authorization: Bearer $FOA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_platform": "substack",
    "url": "https://example.substack.com/p/useful-post",
    "title": "Example Substack post",
    "author_name": "Example Creator"
  }'

Duplicate protection

FoundOnArdy uses the same canonical identity rules across normal ingestion, manual Add Content, and Creator API submissions.

• YouTube content is identified by its YouTube video ID, so normal watch URLs, Shorts URLs, youtu.be links, and tracking parameters do not create separate copies of the same video.
• Medium and Substack content is identified by a normalized article URL. Common tracking parameters and URL fragments are ignored.
• If the content is already in FoundOnArdy, the API returns already_exists.
• If the same content is already waiting in the Creator API review flow, the API returns already_submitted.
• Manual Add Content also refuses to create another copy when the same canonical content already exists or is already pending through the API.

Examples

• YouTube cURL: examples/curl/submit-video.sh
• Medium cURL: examples/curl/submit-medium.sh
• Substack cURL: examples/curl/submit-substack.sh
• Python: examples/python/submit_content.py
• JavaScript: examples/javascript/submit-content.mjs
• Java: examples/java/SubmitContent.java

The older YouTube-only example filenames are kept for compatibility.

Documentation

• Authentication
• Submissions
• Responses and errors
• Troubleshooting
• OpenAPI reference
• Security guidance

Website

• Content Creators: https://www.foundonardy.com/content-creators/
• Creator API: https://www.foundonardy.com/creator-api/
• API terms: https://www.foundonardy.com/creator-api/terms/

Current status

The Creator API supports YouTube, Medium, and Substack.