{"openapi":"3.1.0","info":{"title":"Social Media Content Intelligence API","version":"1.0.0","description":"Read supplied posts, comments, and analytics exports, calculate engagement from those numbers, and organize the supplied text. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/social-content/post-performance-analyze":{"post":{"operationId":"analyze_post_performance","summary":"Analyze post performance","description":"Calculate engagement and an engagement rate from supplied impressions, likes, comments, shares, and saves. A missing count is left out, and no rate is calculated without impressions. Equal rates keep the caller's input order.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Post: P-1 | instagram | 2026-11-01 | 1000 | 40 | 5 | 2 | 1 | Launch day #launch\nPost: P-2 | instagram | 2026-11-02 | 100 | 4 | 0 | 0 | 0 | Launch day #launch\nPost: P-3 | instagram | 2026-11-03 | | 3 | 1 | 0 | 0 | Office hours\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"date":{"type":"string"},"impressions":{"type":"number"},"impressionsSupplied":{"type":"boolean"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"saves":{"type":"number"},"engagement":{"type":"number"},"engagementSupplied":{"type":"boolean"},"counted":{"type":"string"},"rate":{"type":"number"},"rateCalculated":{"type":"boolean"},"rank":{"type":"number"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"checked","posts":[{"id":"P-1","platform":"instagram","date":"2026-11-01","impressions":1000,"impressionsSupplied":true,"likes":40,"comments":5,"shares":2,"saves":1,"engagement":48,"engagementSupplied":true,"counted":"likes,comments,shares,saves","rate":0.048,"rateCalculated":true,"rank":1},{"id":"P-2","platform":"instagram","date":"2026-11-02","impressions":100,"impressionsSupplied":true,"likes":4,"comments":0,"shares":0,"saves":0,"engagement":4,"engagementSupplied":true,"counted":"likes,comments,shares,saves","rate":0.04,"rateCalculated":true,"rank":2},{"id":"P-3","platform":"instagram","date":"2026-11-03","impressions":0,"impressionsSupplied":false,"likes":3,"comments":1,"shares":0,"saves":0,"engagement":4,"engagementSupplied":true,"counted":"likes,comments,shares,saves","rate":0,"rateCalculated":false,"rank":3}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"missing","code":"impressions_missing","subject":"P-3","detail":"Impressions were not supplied, so no engagement rate was calculated."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/calendar-generate":{"post":{"operationId":"draft_a_content_calendar","summary":"Draft a content calendar","description":"Place supplied posts on a caller-supplied window. Dated posts stay on their date. Undated posts fill empty days in input order. No caption is written and nothing is scheduled.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Platform: instagram\nWindow: 2026-11-03 | 3\nPost: P-1 | instagram | 2026-11-04 | | | | | | Monday note\nPost: P-2 | | | | | | | | Undated note\nPost: P-3 | x | 2026-11-04 | | | | | | Other platform\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"scheduled":{"type":"boolean"},"slots":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"text":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"unplaced":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"reason":{"type":"string"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"drafted","scheduled":false,"slots":[{"date":"2026-11-03","id":"P-2","platform":"","text":"Undated note","source":"undated"},{"date":"2026-11-04","id":"P-1","platform":"instagram","text":"Monday note","source":"dated"}],"unplaced":[{"id":"P-3","reason":"platform_differs"}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"observation","code":"platform_differs","subject":"P-3","detail":"This post names a different platform from the requested target. It was not rewritten."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/repurpose":{"post":{"operationId":"repurpose_content_for_a_platform","summary":"Repurpose content for a platform","description":"Shorten supplied text to a documented character limit only when the caller names a target platform. No words are added and nothing is published.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"platform":"x","posts":[{"id":"P-1","text":"word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word"},{"id":"P-2","text":"Short note"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"scheduled":{"type":"boolean"},"platform":{"type":"string"},"limit":{"type":"number"},"drafts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"limit":{"type":"number"},"truncated":{"type":"boolean"},"adapted":{"type":"boolean"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"drafted","scheduled":false,"platform":"x","limit":280,"drafts":[{"id":"P-1","platform":"x","text":"word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word word","characters":279,"limit":280,"truncated":true,"adapted":true},{"id":"P-2","platform":"x","text":"Short note","characters":10,"limit":280,"truncated":false,"adapted":false}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"observation","code":"text_shortened","subject":"P-1","detail":"The draft was cut to 280 characters for the specified platform. No words were added."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/hashtag-analyze":{"post":{"operationId":"analyze_supplied_hashtags","summary":"Analyze supplied hashtags","description":"Count hashtags in the supplied posts and copy post and impression figures from supplied hashtag rows. The counts stay separate. Current popularity and reach are not estimated.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Post: P-1 | instagram | 2026-11-01 | | | | | | Hello #launch #brand\nPost: P-2 | instagram | 2026-11-02 | | | | | | Again #launch\nHashtag: brand | 10 | 500\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"hashtags":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string"},"postCount":{"type":"number"},"datasetPosts":{"type":"number"},"datasetPostsSupplied":{"type":"boolean"},"impressions":{"type":"number"},"impressionsSupplied":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"checked","hashtags":[{"tag":"#launch","postCount":2,"datasetPosts":0,"datasetPostsSupplied":false,"impressions":0,"impressionsSupplied":false,"interpretation":"stated"},{"tag":"#brand","postCount":1,"datasetPosts":10,"datasetPostsSupplied":true,"impressions":500,"impressionsSupplied":true,"interpretation":"stated"}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/comment-classify":{"post":{"operationId":"classify_supplied_comments","summary":"Classify supplied comments","description":"Match a supplied type to question, praise, complaint, spam, or request. Without a type, a comment is labeled only when one documented keyword rule matches. No moderation action is taken.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Comment: C-1 | P-1 | | Where is the link?\nComment: C-2 | P-1 | | Thanks for this\nComment: C-3 | P-1 | erase | Please remove this\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"moderationAction":{"type":"boolean"},"comments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"postId":{"type":"string"},"category":{"type":"string"},"method":{"type":"string"},"recognized":{"type":"boolean"},"matches":{"type":"string"},"interpretation":{"type":"string"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"classified","moderationAction":false,"comments":[{"id":"C-1","postId":"P-1","category":"question","method":"keyword","recognized":true,"matches":"question","interpretation":"keyword"},{"id":"C-2","postId":"P-1","category":"praise","method":"keyword","recognized":true,"matches":"praise","interpretation":"keyword"},{"id":"C-3","postId":"P-1","category":"","method":"stated","recognized":false,"matches":"","interpretation":"none"}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"observation","code":"type_unrecognized","subject":"C-3","detail":"The comment type is not question, praise, complaint, spam, or request. It was not remapped."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/engagement-anomaly-detect":{"post":{"operationId":"detect_engagement_anomalies","summary":"Detect engagement anomalies","description":"Apply a Tukey 1.5 IQR fence to engagement rates when at least 8 posts have impressions and an engagement count. A point outside the fence is not a confirmed anomaly.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"posts":[{"id":"P-1","text":"Note","impressions":1000,"likes":10},{"id":"P-2","text":"Note","impressions":1000,"likes":12},{"id":"P-3","text":"Note","impressions":1000,"likes":11},{"id":"P-4","text":"Note","impressions":1000,"likes":9},{"id":"P-5","text":"Note","impressions":1000,"likes":10},{"id":"P-6","text":"Note","impressions":1000,"likes":13},{"id":"P-7","text":"Note","impressions":1000,"likes":8},{"id":"P-8","text":"Note","impressions":1000,"likes":400}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"anomalyConfirmed":{"type":"boolean"},"lower":{"type":"number"},"upper":{"type":"number"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rate":{"type":"number"},"outside":{"type":"boolean"},"confirmed":{"type":"boolean"}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"checked","anomalyConfirmed":false,"lower":0.006,"upper":0.016,"posts":[{"id":"P-1","rate":0.01,"outside":false,"confirmed":false},{"id":"P-2","rate":0.012,"outside":false,"confirmed":false},{"id":"P-3","rate":0.011,"outside":false,"confirmed":false},{"id":"P-4","rate":0.009,"outside":false,"confirmed":false},{"id":"P-5","rate":0.01,"outside":false,"confirmed":false},{"id":"P-6","rate":0.013,"outside":false,"confirmed":false},{"id":"P-7","rate":0.008,"outside":false,"confirmed":false},{"id":"P-8","rate":0.4,"outside":true,"confirmed":false}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"observation","code":"possible_anomaly","subject":"P-8","detail":"This engagement rate is outside the Tukey 1.5 IQR fence. It is not a confirmed anomaly."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/duplicate-detect":{"post":{"operationId":"detect_repeated_content","summary":"Detect repeated content","description":"Group posts whose text matches after trimming, and list pairs that share at least 90 percent of their tokens. No post is removed.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Post: P-1 | | | | | | | | Same caption here today\nPost: P-2 | | | | | | | | Same caption here today\nPost: P-3 | | | | | | | | A different caption\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"groups":{"type":"array","items":{"type":"object","properties":{"exact":{"type":"boolean"},"similarity":{"type":"number"},"confirmed":{"type":"boolean"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"checked","groups":[{"exact":true,"similarity":1,"confirmed":true,"posts":[{"id":"P-1"},{"id":"P-2"}]}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"conflict","code":"duplicate_text","subject":"P-1","detail":"These posts use the same text after trimming. No post was removed."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/social-content/account-performance-report":{"post":{"operationId":"report_account_performance","summary":"Report account performance","description":"Combine supplied totals, platform splits, calendar slots, drafts, hashtags, comments, rate fences, and repeated text. The report does not publish content or estimate reach.","tags":["social-content"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"posts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","maxLength":40},"text":{"type":"string","maxLength":4000},"date":{"type":"string","maxLength":40},"impressions":{"type":"integer","minimum":0,"maximum":1000000000},"likes":{"type":"integer","minimum":0,"maximum":1000000000},"comments":{"type":"integer","minimum":0,"maximum":1000000000},"shares":{"type":"integer","minimum":0,"maximum":1000000000},"saves":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"comments":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":80},"postId":{"type":"string","maxLength":80},"text":{"type":"string","maxLength":2000},"type":{"type":"string","maxLength":40}},"additionalProperties":false}},"hashtags":{"maxItems":80,"type":"array","items":{"type":"object","properties":{"tag":{"type":"string","minLength":1,"maxLength":80},"posts":{"type":"integer","minimum":0,"maximum":1000000000},"impressions":{"type":"integer","minimum":0,"maximum":1000000000}},"required":["tag"],"additionalProperties":false}},"window":{"type":"object","properties":{"start":{"type":"string","minLength":1,"maxLength":40},"days":{"type":"integer","minimum":1,"maximum":31}},"required":["start","days"],"additionalProperties":false},"platform":{"type":"string","maxLength":40},"account":{"type":"object","properties":{"name":{"type":"string","maxLength":80},"platform":{"type":"string","maxLength":40},"followers":{"type":"integer","minimum":0,"maximum":1000000000}},"additionalProperties":false}},"additionalProperties":false},"example":{"text":"Platform: instagram\nWindow: 2026-11-03 | 2\nAccount: Example Brand | instagram | 1200\nPost: P-1 | instagram | 2026-11-03 | 1000 | 40 | 5 | 2 | 1 | Hello #launch\nPost: P-2 | instagram | 2026-11-04 | 100 | 4 | 0 | 0 | 0 | Hello #launch\nComment: C-1 | P-1 | | Where is the link?\nHashtag: launch | 4 | 100\n"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"scheduled":{"type":"boolean"},"anomalyConfirmed":{"type":"boolean"},"moderationAction":{"type":"boolean"},"accountName":{"type":"string"},"accountPlatform":{"type":"string"},"followers":{"type":"number"},"followersSupplied":{"type":"boolean"},"postCount":{"type":"number"},"commentCount":{"type":"number"},"impressions":{"type":"number"},"engagement":{"type":"number"},"averageRate":{"type":"number"},"averageCalculated":{"type":"boolean"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"date":{"type":"string"},"impressions":{"type":"number"},"impressionsSupplied":{"type":"boolean"},"likes":{"type":"number"},"comments":{"type":"number"},"shares":{"type":"number"},"saves":{"type":"number"},"engagement":{"type":"number"},"engagementSupplied":{"type":"boolean"},"counted":{"type":"string"},"rate":{"type":"number"},"rateCalculated":{"type":"boolean"},"rank":{"type":"number"}},"additionalProperties":true}},"byPlatform":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"posts":{"type":"number"},"impressions":{"type":"number"},"engagement":{"type":"number"}},"additionalProperties":true}},"slots":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"id":{"type":"string"},"platform":{"type":"string"},"text":{"type":"string"},"source":{"type":"string"}},"additionalProperties":true}},"unplaced":{"type":"array","items":{}},"drafts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"platform":{"type":"string"},"text":{"type":"string"},"characters":{"type":"number"},"limit":{"type":"number"},"truncated":{"type":"boolean"},"adapted":{"type":"boolean"}},"additionalProperties":true}},"hashtags":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string"},"postCount":{"type":"number"},"datasetPosts":{"type":"number"},"datasetPostsSupplied":{"type":"boolean"},"impressions":{"type":"number"},"impressionsSupplied":{"type":"boolean"},"interpretation":{"type":"string"}},"additionalProperties":true}},"comments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"postId":{"type":"string"},"category":{"type":"string"},"method":{"type":"string"},"recognized":{"type":"boolean"},"matches":{"type":"string"},"interpretation":{"type":"string"}},"additionalProperties":true}},"anomalies":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rate":{"type":"number"},"outside":{"type":"boolean"},"confirmed":{"type":"boolean"}},"additionalProperties":true}},"groups":{"type":"array","items":{"type":"object","properties":{"exact":{"type":"boolean"},"similarity":{"type":"number"},"confirmed":{"type":"boolean"},"posts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}},"published":{"type":"boolean"},"scraped":{"type":"boolean"},"reachInvented":{"type":"boolean"},"postsRemoved":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-03T18:00:00.000Z","status":"checked","scheduled":false,"anomalyConfirmed":false,"moderationAction":false,"accountName":"Example Brand","accountPlatform":"instagram","followers":1200,"followersSupplied":true,"postCount":2,"commentCount":1,"impressions":1100,"engagement":52,"averageRate":0.044,"averageCalculated":true,"posts":[{"id":"P-1","platform":"instagram","date":"2026-11-03","impressions":1000,"impressionsSupplied":true,"likes":40,"comments":5,"shares":2,"saves":1,"engagement":48,"engagementSupplied":true,"counted":"likes,comments,shares,saves","rate":0.048,"rateCalculated":true,"rank":1},{"id":"P-2","platform":"instagram","date":"2026-11-04","impressions":100,"impressionsSupplied":true,"likes":4,"comments":0,"shares":0,"saves":0,"engagement":4,"engagementSupplied":true,"counted":"likes,comments,shares,saves","rate":0.04,"rateCalculated":true,"rank":2}],"byPlatform":[{"platform":"instagram","posts":2,"impressions":1100,"engagement":52}],"slots":[{"date":"2026-11-03","id":"P-1","platform":"instagram","text":"Hello #launch","source":"dated"},{"date":"2026-11-04","id":"P-2","platform":"instagram","text":"Hello #launch","source":"dated"}],"unplaced":[],"drafts":[{"id":"P-1","platform":"instagram","text":"Hello #launch","characters":13,"limit":2200,"truncated":false,"adapted":false},{"id":"P-2","platform":"instagram","text":"Hello #launch","characters":13,"limit":2200,"truncated":false,"adapted":false}],"hashtags":[{"tag":"#launch","postCount":2,"datasetPosts":4,"datasetPostsSupplied":true,"impressions":100,"impressionsSupplied":true,"interpretation":"stated"}],"comments":[{"id":"C-1","postId":"P-1","category":"question","method":"keyword","recognized":true,"matches":"question","interpretation":"keyword"}],"anomalies":[{"id":"P-1","rate":0.048,"outside":false,"confirmed":false},{"id":"P-2","rate":0.04,"outside":false,"confirmed":false}],"groups":[{"exact":true,"similarity":1,"confirmed":true,"posts":[{"id":"P-1"},{"id":"P-2"}]}],"published":false,"scraped":false,"reachInvented":false,"postsRemoved":false,"findings":[{"kind":"observation","code":"sample_too_small","subject":"","detail":"Fewer than 8 posts have both impressions and an engagement count. No anomaly fence was applied."},{"kind":"conflict","code":"duplicate_text","subject":"P-1","detail":"These posts use the same text after trimming. No post was removed."}],"limitations":["Engagement metrics are calculated only from numbers supplied in the request.","No account is scraped and no platform restriction is bypassed.","No post is published or scheduled.","Hashtag counts and impressions come only from the supplied posts and hashtag rows. Current popularity and reach are not estimated.","A calendar slot or repurposed draft uses text from the request. Text is shortened only for a documented character limit of a specified platform."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}