API access requires the Agency plan ($199/mo) or the API add-on. After upgrading, generate your API key at Account Settings. Full endpoint documentation, code samples, and SDKs are available to API subscribers.
The Idea2Post API is a RESTful JSON API. All requests require an Authorization: Bearer YOUR_API_KEY header. Responses are JSON. Credits are deducted per call, same rates as the dashboard.
Base URL: https://api.idea2post.mycoach.ing/v1
curl https://api.idea2post.mycoach.ing/v1/hooks \
-H "Authorization: Bearer i2p_sk_live_abc123..." \
-H "Content-Type: application/json" \
-d '{"idea": "5 mistakes coaches make on landing pages"}'
| Plan | Requests/min | Requests/day |
|---|---|---|
| Agency | 60 | 5,000 |
| API add-on | 30 | 2,000 |
Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset.
Generate 10-20 viral hooks from an idea. Costs 1 credit.
| Parameter | Type | Description | |
|---|---|---|---|
idea | string | required | The raw idea or topic to generate hooks for |
count | integer | optional | Number of hooks (default: 10, max: 20) |
styles | array | optional | Hook styles: viral, curiosity, story, expert, sales |
tone | string | optional | Content tone (default: expert) |
Example response:
{
"hooks": [
{
"style": "viral",
"hook": "I pasted 1 YouTube link into AI and got 20 posts in 2 minutes.",
"score": 92
},
{
"style": "curiosity",
"hook": "90% of coaches make this exact landing page mistake...",
"score": 88
}
],
"credits_used": 1,
"credits_remaining": 2847
}
Generate multi-format content from an idea. Cost depends on formats selected.
| Parameter | Type | Description | |
|---|---|---|---|
idea | string | required | Source text, idea, or transcript |
formats | array | required | Output formats: blog (3c), facebook (1c), twitter (1c), linkedin (1c), email (1c), script (2c), instagram (1c), thread (1c), cta (1c), faq (1c) |
tone | string | optional | expert, story, friendly, authority, sales, bold |
audience | string | optional | Target audience description |
language | string | optional | en (default) or vi |
preset_id | integer | optional | Writing preset ID |
project_id | integer | optional | Project/workspace ID |
Example response:
{
"items": [
{
"format": "blog",
"title": "Why 73% of Landing Pages Fail in the First 3 Seconds",
"body": "Your landing page has one job: stop the scroll...",
"cta": "Download our free landing page audit checklist.",
"viral_score": 87,
"hook_strength": "strong",
"seo_ready": true,
"badges": ["Viral 87%", "Hook Strong", "SEO Ready"]
},
{
"format": "facebook",
"title": "...",
"body": "...",
"..."
}
],
"credits_used": 4,
"credits_remaining": 2843
}
The following endpoints are documented in full for API subscribers:
Extract YouTube transcript and generate content. 8 credits.
Generate a DALL-E 3 cover image for a content piece. 5 credits.
Retrieve a generated content piece by ID.
List your generated content with pagination and filters.
Schedule a content piece for publishing to a connected account. 1 credit.
List your connected publishing accounts.
List publish queue with status tracking.
Run an AI Visibility scan for your brand. 5 credits.
Check your current credit balance (monthly + shared).
List available writing presets (system + custom).
Delete a generated content piece.
The API is functional and stable, but we may make breaking changes during the beta period. We'll notify all API users via email before any breaking change. Subscribe to our changelog for updates.
Coming soon:
npm install idea2post)pip install idea2post)API questions? Reach out at helpdesk.mycoach.ing or check the FAQ.