Citedy SEO Agent

Generate an SEO-optimized article. By default publishes immediately; set auto_publish=false to create as draft. May take 30-90 seconds.

Poll a queued article job by id. Use the id returned by article.generate to get the current status or the final generated article result.

List previously generated articles for the current workspace.

Publish a draft article. Use after generating with auto_publish=false to trigger the publish pipeline.

Unpublish an article (revert to draft status). The article remains accessible for editing but is removed from the public blog.

Permanently delete an article and its associated storage files.

Start lead magnet generation (checklist/swipe/framework) and return polling instructions.

Fetch lead magnet status/result by ID.

Publish a lead magnet by ID.

Archive a lead magnet by ID.

Run X/Twitter scout analysis. Returns processing status — poll scout.x.result for results.

Get X scout run status and results by run ID.

Run Reddit scout analysis. Returns processing status — poll scout.reddit.result for results.

Get Reddit scout run status and results by run ID.

Generate SEO/GEO content gap opportunities.

Generate social adaptations for an article.

Create an ingestion job from a source URL.

Get ingestion job status/result by ID.

Fetch extracted content payload for a completed ingestion job.

Create and start an autopilot session.

Publish, schedule, cancel, or direct-publish (as-is, no AI adaptation) social content.

List upcoming article/post/social schedule timeline.

List schedule gaps for upcoming days.

Create ingestion jobs in batch mode for multiple URLs.

Discover competitors by keyword set.

Analyze a competitor domain.

Register webhook endpoint for agent events.

List webhook delivery attempts.

Delete a webhook endpoint by ID.

Upload product knowledge document.

Delete product knowledge document by ID.

Search product knowledge documents.

Analyze meta tags for a target page URL.

Analyze heading hierarchy (H1-H6) for a page.

Analyze internal/external links and link attributes.

Plan internal linking opportunities from source URL and target URLs/sitemap.

Extract Open Graph and Twitter card preview metadata.

Validate JSON-LD schema markup for a page.

Check robots.txt availability and parsed directives.

Check sitemap availability and robots sitemap hints.

Generate an Open Graph image artifact and return hosted URL for brand assets.

Run AI brand visibility scan across major LLM providers (async, poll with brand.scan.get).

Get brand scan status and final result payload by scan ID.

Generate shorts video and return poll instructions until final video URL is ready.

Get shorts generation status/result by ID.

Generate short-form video script text (hook/educational/cta styles).

Generate an AI avatar image for shorts and return hosted avatar URL.

Merge 2-4 short clips, apply subtitle phrases, and return final video URL.

Get Google Search Console performance report: clicks, impressions, CTR, avg position, top queries, top pages, position movers, content opportunities, and article suggestions. Returns connect URL if GSC is not linked. Free (0 credits).