Posts

Create a link post

Publish a link post. When url is provided we auto-scrape og:image/title/description.

post/posts

Request

  • Base URL: https://doomscrollr.com/api/v1
  • URL: https://doomscrollr.com/api/v1/posts
  • Auth: HTTP bearer

Request body

urlstring uri required

URL to publish. DOOMSCROLLR attempts to fetch/repair preview metadata first; Polymarket event/market URLs are automatically rendered as owned widget embeds. Generic published links without a usable preview image/embed are rejected unless allow_no_image=true or status=draft.

titlestring
descriptionstring
tagsstring

Comma-separated tags

status'published' | 'draft' | 'scheduled'
publish_atstring date-time

Future publish time. When provided, status is set to scheduled.

shoppableboolean

Show a buy button on this post

post_type'default' | 'url_embed' | 'product'

Optional advanced override. Polymarket URLs automatically become url_embed posts.

allow_no_imageboolean

Advanced override. By default, published link posts are not created if DOOMSCROLLR cannot repair/fetch a usable preview image or embed after metadata enrichment. Set true only when a text-only/link-only card is intentional.

Example request

{
  "url": "https://example.com/article"
}

Response

Post created

idinteger
urlstring
titlestring
descriptionstring
imagestring uri
status'published' | 'draft' | 'scheduled'
post_typestring
created_atstring date-time
publish_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.