// FOR AGENTS · §08
Built for autonomous agents.
REST + x402. Designed to be discovered, called, and paid for by software — not humans clicking dashboards.
// BENEFITS
No accounts or API keys
Pay per call with x402. Agents authenticate via payment, not long-lived secrets they have to rotate.
Machine-readable output
Stable JSON: default VideoAnalysis (transcript, scenes, visuals) or 24 workflow formats via optional format on submit. Typed fields per template — recipes, briefs, screening, and more.
Instant cache hits
Previously analyzed videos return immediately for the same URL and format. Generic and workflow caches are separate — switching format is a new paid run.
Free polling
Submit once (paid), then poll GET /v1/jobs/{jobId} at no cost until status: success.
Integration flow
Find entit.ai on agentic.market or in the x402 directory.
Build an x402 'exact' payment for POST https://api.entit.ai/v1/jobs ($0.10 USDC on Base or Solana mainnet). Pick Base or Solana from the 402 accept list.
POST {"url":"...","format":"creator-brief"} (format optional) with X-Payment. Server returns 202 + jobId, or 200 + typed result on a cache hit.
GET /v1/jobs/{jobId} every 5+ seconds, honoring Retry-After. Stop on success / failed / 410.
Parse result: VideoAnalysis when format is omitted, or workflow JSON (hooks, screening, recipe) when format is set. Echo format on every response.
Workflow formats (24)
Add "format": "<slug>" to POST /v1/jobs. Responses echo format and return workflow-specific JSON instead of VideoAnalysis. Map user questions to a slug — e.g. cooking Short → recipe.
content-screeningBrand safety, UGC compliance, ad-placement suitabilitycreator-briefHooks, angle, key moments, influencer vettingrecipeIngredients and steps from cooking clipstutorial-guideHow-to videos → written guide / FAQquote-highlightsShareable quotes and highlight momentsproduct-taggingProducts shown with search queriesshop-the-lookFashion items and outfit search queriesreview-summaryPros/cons from product review videosworkout-planExercises with sets, reps, resthealth-claimsMedical claims flagged for fact-checkingflashcardsStudy flashcards from educational contentcurriculum-tagsSubject, difficulty, learning objectiveslanguage-learningPhrases, vocabulary, grammar patternsugc-verificationScene/location hints for citizen journalism checksbreaking-news-signalNewsworthiness signal from one clipeyewitness-timelineStructured timeline of factual claimssong-contextBackground music / performance for licensinglyric-hookLip-sync, hooks, rights notessound-trendAudio description and viral potentialtechnique-analysisCoaching cues for technique clipshighlight-reelAction-dense clip timestampsscouting-reportAthlete performance notes for coachesdestination-guideItinerary, tips, costs from travel vlogsrestaurant-discoveryDishes, prices, atmosphere from food reviewsLimitations
Set expectations on every agent surface. Mirrored verbatim in /llms.txt.
Single video per call
Each job analyses one short-form video. Feed-scale monitoring across many clips is achieved by orchestrating many jobs.
E-commerce returns queries, not links
product-tagging, shop-the-look, and review-summary return searchQuery strings — not buyable URLs or affiliate links.
Claims are flagged, not verified
Health, news, and ugc-verification formats surface claims for human review. They do not assert that any claim is true.
Every format has a published schema
All 24 formats have JSON Schemas on /docs/response-schema, auto-generated from the Gemini contract in internal/gemini/formats. 3 (content-screening, creator-brief, recipe) also ship with hand-curated Go structs and field tables; the rest are typed by JSON Schema only. OpenAPI still references WorkflowFormatResult as a fallback while typed schemas are promoted into openapi.json.
Natural language → format
When users ask in plain language, pick the closest slug. Also listed in /llms.txt.
- convert a cooking YouTube Short or TikTok to a text recipe
recipe - turn a how-to Reel into written steps or documentation
tutorial-guide - extract pull quotes from a short-form video for social posts
quote-highlights - brand safety check before reposting UGC
content-screening - influencer vetting brief with hooks and key moments
creator-brief - find products shown in a shopping haul video
product-tagging - shop the outfit from a fashion Reel
shop-the-look - summarize pros and cons from a product review Short
review-summary - build a workout from a fitness TikTok
workout-plan - flag medical or wellness claims in a health video
health-claims - make flashcards from an educational Short
flashcards - tag curriculum subject and difficulty from a lesson clip
curriculum-tags - extract vocabulary from a language-learning video
language-learning - verify citizen journalism footage location and scene
ugc-verification - is this clip breaking news
breaking-news-signal - timeline of eyewitness claims from one clip
eyewitness-timeline - identify background music for licensing
song-context - lip-sync hook and rights notes from a music Short
lyric-hook - describe audio and viral trend potential
sound-trend - coaching cues from a sports technique video
technique-analysis - timestamps for highlight reel moments
highlight-reel - scouting report from game footage
scouting-report - itinerary and tips from a travel vlog Short
destination-guide - restaurant dishes and prices from a food review Reel
restaurant-discovery
// MCP NOTE
This is the REST x402 API. MCP registry listings on agenticmarket.dev are separate from x402 REST services on agentic.market.