---
title: "Post ShopMy affiliate product recommendations"
method: POST
path: "/affiliate/shopmy/posts"
tags: ["Affiliate"]
---

# Post ShopMy affiliate product recommendations

`POST /affiliate/shopmy/posts`

## Request

- Base URL: `https://doomscrollr.com/api/v1`
- URL: `https://doomscrollr.com/api/v1/affiliate/shopmy/posts`
- Auth: HTTP bearer

Creates rich DOOMSCROLLR posts from ShopMy affiliate/product URLs. The API crawls the final retail product page for title/description/photo while preserving the original ShopMy URL as the click target so affiliate commission attribution remains intact.

## Request body

- object
  - `products` object[], required
    - `url` string, uri, required: ShopMy affiliate/product URL
    - `title` string: Optional title override
    - `description` string: Optional description override
    - `note` string: Creator recommendation note
  - `collection_title` string: Collection/edit title, e.g. Holiday gift guide under $100
  - `use_case` string: Use case/category, e.g. outfit edit, beauty routine, home finds
  - `tags` string: Comma-separated tags; shopmy, affiliate, and product-recommendation are added automatically
  - `status` 'published' | 'draft' | 'scheduled'
  - `publish_at` string, date-time

## Response `201`

Created affiliate recommendation posts

- object
  - `created` integer
  - `posts` Post[]
    - `id` integer
    - `url` string
    - `title` string
    - `description` string
    - `image` string, uri
    - `status` 'published' | 'draft' | 'scheduled'
    - `post_type` string
    - `created_at` string, date-time
    - `publish_at` string, date-time, nullable
  - `message` string

## Other responses

- `401` (unresolved $ref)
- `422` (unresolved $ref)
- `429`: Monthly API rate limit exceeded

---

[API](https://skmtc.dev/doomscrollr/apis/doomscrollr-api.md) · [All operations](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/doomscrollr/apis/doomscrollr-api/revisions/0bd7ab034196?raw)