Get your YouTube content into FoundOnArdy automatically.

What is the Creator API?

Instead of manually adding each video, a creator or their software can tell FoundOnArdy when content is published. FoundOnArdy does not re-upload the video. It indexes submitted metadata and links users to the original YouTube content.

Who is it for?

YouTube is the only supported publishing source today.

How it works

1. 1Create or sign in
2. 2Verify your YouTube channel
3. 3Create your API key
4. 4Submit published videos
5. 5FoundOnArdy reviews or publishes them

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. Approved history can allow future valid submissions to be added automatically. FoundOnArdy can return a creator to review or suspend API access if needed.

Quick start

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"}'

Language-specific examples are prepared for publication. Until that public repo is published, use this quick start or contact FoundOnArdy for setup help.

What can I send?

YouTube URL / video ID

Required. Send video_url or url as a supported YouTube URL. You may also include video_id or external_content_id as the 11-character YouTube video ID.

title

Required. Up to 240 characters.

description

Optional. Up to 5,000 characters.

transcript

Optional. Up to 200,000 characters. Transcript text is not shown publicly by default.

publication_timestamp

Optional ISO timestamp.

duration_seconds

Optional number from 0 to 86,400.

language

Optional language value.

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