---
title: "Import Social Url"
method: POST
path: "/api/v1/social-saves/import"
tags: ["social-saves"]
---

# Import Social Url

`POST /api/v1/social-saves/import`

## Request

- Base URL: `https://yondry.app` (the document declares no server; this is the origin it was published from)
- URL: `https://yondry.app/api/v1/social-saves/import`
- Auth: HTTP bearer

## Request body

- SocialImportRequest
  - `url` string, nullable: Full URL of the social post to import
  - `source` 'instagram' | 'tiktok' | 'youtube' | 'other' | 'ocr', required
  - `user_comment` string, nullable: Optional note the user added before sharing
  - `ocr_text` string, nullable: Pre-extracted OCR text from the device (source=ocr only)

## Response `202`

Successful Response

- SocialImportJobOut
  - `job_id` string, uuid, required
  - `status` string, required
  - `poll_url` string, required
  - `social_save_id` string, uuid, nullable
  - `error_message` string, nullable
  - `created_at` string, date-time, required
  - `progress_events` unknown[], nullable
    - unknown

## Other responses

- `422`: Validation Error

---

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