Public REST/JSON reference

Blog Splitter API

Submit a blog URL or RSS feed and get back a clean structured representation (key points, statistics, quotes), then split that post into platform-shaped social threads — one for X, one for LinkedIn, one for Bluesky — with hooks, body posts, character counts, and CTAs ready to schedule. Regenerate any thread with new instructions until the voice fits. Part of the Logic Igniter Content & Marketing bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/blogsplitter.json

Operations rendered

Response models rendered

GET/api/v1/blogsplitter/health

Service liveness

Liveness probe — returns 200 if the service is reachable.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/blogsplitter/health" \
  -H "Accept: application/json"

Responses

200

Service healthy

POST/api/v1/blogsplitter/blogs/fetch

Fetch and parse a blog post

Submit a blog URL. The service fetches it, extracts title/author/body, and returns a structured representation including key_points (with their headings, summaries, statistics, and quotes) suitable as input to /threads/split.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: FetchBlogRequest

Sample JSON payload for evaluation.

{
  "url": "https://example.com/blog/why-saas-churns"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/blogsplitter/blogs/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/blog/why-saas-churns"}'

Responses

201BlogPost

Blog post fetched and parsed

400Error

Missing or unfetchable URL

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers 3 fetches per month and 1 thread bundle per post; paid plans unlock unlimited fetches, RSS auto-ingest, and regeneration.

POST/api/v1/blogsplitter/feeds

Subscribe to an RSS/Atom feed

New posts in the feed are fetched and parsed automatically as the feed updates. Useful for company blogs you want to syndicate continuously.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: AddFeedRequest

Sample JSON payload for evaluation.

{
  "feed_url": "https://example.com/blog/feed.rss",
  "blog_name": "Example Blog"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/blogsplitter/feeds" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"feed_url":"https://example.com/blog/feed.rss","blog_name":"Example Blog"}'

Responses

201Feed

Feed registered

400Error

Invalid or unreachable feed URL

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers 3 fetches per month and 1 thread bundle per post; paid plans unlock unlimited fetches, RSS auto-ingest, and regeneration.

GET/api/v1/blogsplitter/posts

List fetched blog posts

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/blogsplitter/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200PostsResponse

Page of posts

401Error

Missing or invalid API key.

POST/api/v1/blogsplitter/threads/split

Split a post into per-platform threads

Generate a bundle of social threads — typically one per supported platform (X, LinkedIn, Bluesky) — each with a hook, multiple posts respecting the platform's character limit, a CTA at the end, and a DRAFT status until you publish.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: SplitRequest

Sample JSON payload for evaluation.

{
  "post_id": "11111111-1111-1111-1111-111111111111"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/blogsplitter/threads/split" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"post_id":"11111111-1111-1111-1111-111111111111"}'

Responses

201ThreadBundle

Bundle of threads

400Error

Missing post_id

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers 3 fetches per month and 1 thread bundle per post; paid plans unlock unlimited fetches, RSS auto-ingest, and regeneration.

404Error

Post not found

GET/api/v1/blogsplitter/threads/{id}

Get a single thread

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/blogsplitter/threads/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200SocialThread

Thread

401Error

Missing or invalid API key.

404Error

Thread not found

POST/api/v1/blogsplitter/threads/{id}/regenerate

Regenerate a thread

Replace a thread with a fresh render that follows custom instructions (e.g. "more punchy hook", "include a one-liner from the founder", "open with a question"). Status stays DRAFT.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request body (required)

Schema: RegenerateRequest

Sample JSON payload for evaluation.

{
  "instructions": "Lead with a one-liner from the data; close with a CTA to read the full post."
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/blogsplitter/threads/:id/regenerate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"instructions":"Lead with a one-liner from the data; close with a CTA to read the full post."}'

Responses

200SocialThread

Regenerated thread

400Error

Empty instructions

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. Free tier covers 3 fetches per month and 1 thread bundle per post; paid plans unlock unlimited fetches, RSS auto-ingest, and regeneration.

404Error

Thread not found

GET/api/v1/blogsplitter/threads

List threads, optionally filtered to a single post

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type
`post_id`	query	string (uuid)
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/blogsplitter/threads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200ThreadsResponse

Page of threads

401Error

Missing or invalid API key.

Data models

Error

Field	Type	Notes
`error`required	string

ThreadStatus

FetchBlogRequest

Field	Type	Notes
`url`required	string (uri)

KeyPoint

Field	Type	Notes
`id`	string (uuid)
`heading`	string
`summary`	string
`statistics`	array<string>
`quotes`	array<string>

BlogPost

Field	Type	Notes
`id`	string (uuid)
`url`	string (uri)
`title`	string
`author`	string
`word_count`	integer
`key_points`	array<KeyPoint>
`fetched_at`	string (date-time)

AddFeedRequest

Field	Type	Notes
`feed_url`required	string (uri)
`blog_name`	string

Feed

Field	Type	Notes
`id`	string (uuid)
`feed_url`	string (uri)
`blog_name`	string

PostsResponse

Field	Type	Notes
`items`	array<BlogPost>
`next_page_token`	string
`total_count`	integer

SplitRequest

Field	Type	Notes
`post_id`required	string (uuid)

ThreadPost

Field	Type	Notes
`position`	integer
`content`	string
`char_count`	integer

SocialThread

Field	Type	Notes
`id`	string (uuid)
`post_id`	string (uuid)
`platform`	string
`hook`	string
`cta`	string
`posts`	array<ThreadPost>
`status`	ThreadStatus

ThreadBundle

Field	Type	Notes
`id`	string (uuid)
`post_id`	string (uuid)
`threads`	array<SocialThread>

RegenerateRequest

Field	Type	Notes
`instructions`required	string

ThreadsResponse

Field	Type	Notes
`items`	array<SocialThread>
`next_page_token`	string
`total_count`	integer