Get your YouTube, Medium, or Substack content into FoundOnArdy automatically.

What is the Creator API?

Instead of manually adding each item, you or your software can tell FoundOnArdy when a YouTube video, Medium article, or Substack post is published. FoundOnArdy indexes submitted metadata and optional private searchable text, then links users to the original content.

Who is it for?

Supported API sources: YouTube, Medium, and Substack.

How it works

1. 1Create or sign in
2. 2Verify YouTube only if you submit YouTube
3. 3Create your API key
4. 4Submit YouTube, Medium, or Substack content
5. 5FoundOnArdy reviews it before publishing when required

Why verify YouTube?

Verification proves the user controls the channel they claim. It uses official Google/YouTube authorization with YouTube readonly access. It does not allow FoundOnArdy to upload, edit, or delete YouTube videos. The temporary Google access token is used for verification and is not stored as a reusable YouTube token.

Review and trust model

New creator submissions normally enter a review queue first. Trusted status is source-aware: eligible YouTube submissions may later be added automatically, but YouTube history does not auto-publish Medium or Substack posts. Medium and Substack remain admin-review controlled.

Quick start

curl -X POST https://www.foundonardy.com/api/creator/submissions \
  -H "Authorization: Bearer ***" \
  -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"}'

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

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

Medium and Substack hosted or custom-domain URLs stay pending for admin review. YouTube requires channel verification before submission.

The public developer documentation includes the OpenAPI spec plus curl, Python, JavaScript, and Java examples.

View GitHub docs and examples

What can I send?

source_platform

Required. Use youtube, medium, or substack.

url

Required. Send the original YouTube, Medium, Substack, or creator custom-domain URL. YouTube may also use video_url.

video_id / external_content_id

Optional for YouTube only. You may provide the 11-character video ID.

title

Required. Up to 240 characters.

description / summary

Optional. Up to 5,000 characters.

article_text / content_text

Optional for Medium and Substack only. Up to 200,000 characters. Do not send a YouTube transcript; FoundOnArdy retrieves available transcript text through its private ingestion workflow.

publication_timestamp

Optional ISO timestamp.

duration_seconds

Optional number from 0 to 86,400.

language

Optional language value.

author_name / creator_name

Optional for Medium and Substack.

idempotency_key

Optional retry key up to 120 characters.

Payloads over 512 KB are rejected before parsing.

What happens after a submission?

Public statuses include pending_review, accepted, already_exists, already_submitted, idempotent_replay, invalid, quota_exceeded, rate_limited, unauthorized, and forbidden.

FAQ

Help