Skip to main content

​
Prerequisites

  • A Marky account with at least one business set up
  • An API key (create one here)
  • Your business ID (find it in your dashboard URL: app.mymarky.ai/businesses/{business_id})

​
1. Generate posts

Send your content and we’ll create social posts from it: 
curl -X POST https://api.mymarky.ai/api/beta/posts/generate \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "your-business-uuid",
    "content": "We just launched our new product line featuring sustainable materials sourced from local suppliers. Each piece is handcrafted and comes with a lifetime warranty.",
    "count": 3,
    "platforms": ["instagram", "linkedin"]
  }'
Response: 
{
  "job_id": "abc123-def456",
  "status": "pending"
}

​
2. Poll for results

Generation takes 15-60 seconds. Poll the job endpoint: 
curl https://api.mymarky.ai/api/beta/jobs/abc123-def456 \
  -H "Authorization: Bearer mk_live_your_key_here"
When done: 
{
  "job_id": "abc123-def456",
  "status": "completed",
  "data": [
    {
      "id": "post-uuid-1",
      "caption": "Sustainability isn't just a buzzword for us...",
      "platforms": ["instagram"]
    }
  ]
}

​
3. Review in your dashboard

Generated posts appear as drafts in your Marky post queue. Open your dashboard to review, edit, and schedule them.

​
Other input methods

Instead of raw text, you can also pass:
  • website_url to scrape a webpage for content: 
    { "business_id": "...", "website_url": "https://yourblog.com/latest-post", "count": 5 }
  • custom_idea to skip ideation and use your text directly as the post idea: 
    { "business_id": "...", "custom_idea": "Announce our summer sale: 30% off all plans", "count": 3 }

​
Next steps

List posts

Retrieve posts you’ve generated

API Reference

Full endpoint documentation