Create Link

FreshPOST

POST https://api.creatify.ai/api/links/

Create a link from a URL. Creatify will analyze the page and extract product information, images, descriptions, and other metadata.

Request Body

Name	Type	Required	Description
url	string	Yes	The URL to analyze and store

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/links/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com/product-page"
  }'

Response

{
  "id": "link-001",
  "url": "https://example.com/product-page",
  "title": "Amazing Product",
  "description": "The best product for your needs",
  "images": ["https://example.com/img1.jpg"],
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

Code	Description
201	Link created successfully
400	Bad request -- invalid URL
401	Unauthorized -- invalid API credentials
429	Rate limit exceeded
500	Internal server error

TIP

Links are reusable. Once created, you can use the link ID across multiple video generation tasks without re-analyzing the URL.