Create Link with Parameters

FreshPOST

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

Create a link with explicit parameters instead of relying on automatic URL extraction. Use this when you want full control over the product data.

Credit Cost

1 credit per request

Request Body

Name	Type	Required	Description
url	string	Yes	The product URL
title	string	No	Product title (overrides auto-extraction)
description	string	No	Product description (overrides auto-extraction)
images	array	No	Array of image URLs to use
price	string	No	Product price
brand	string	No	Brand name

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/link_with_params/' \
  -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",
    "title": "Premium Widget Pro",
    "description": "The most advanced widget on the market. Features include AI-powered automation and real-time analytics.",
    "images": [
      "https://example.com/widget-hero.jpg",
      "https://example.com/widget-features.jpg"
    ],
    "price": "$49.99",
    "brand": "WidgetCo"
  }'

Response

{
  "id": "link-002",
  "url": "https://example.com/product",
  "title": "Premium Widget Pro",
  "description": "The most advanced widget on the market. Features include AI-powered automation and real-time analytics.",
  "images": [
    "https://example.com/widget-hero.jpg",
    "https://example.com/widget-features.jpg"
  ],
  "price": "$49.99",
  "brand": "WidgetCo",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

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

TIP

Use this endpoint when auto-extraction does not capture your product details correctly, or when you want to provide custom copy for the video generation.