image-agent
Image Agent

Extract Product From Url

Extract product data (name, price, images, description) from a URL.

Uses Firecrawl to scrape the page HTML, then runs HybridProductExtractor (rule-based Shopify/JSON-LD/OG parsing with Gemini LLM fallback) to pull structured product information.

Intended for the ads-studio "paste a link" flow — the frontend calls this when a user pastes a product URL, then creates a url_product chip with the returned data.

post/api/v1/image-agent/extract-product-url

Request

  • Base URL: https://api.trylapis.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trylapis.com/api/v1/image-agent/extract-product-url
  • Auth: HTTP bearer

Request body

urlstring required

Product page URL to scrape and extract data from

Response

Successful Response

product_namestring nullable

Product title/name

pricestring nullable

Displayed price string

price_numericnumber nullable

Numeric price value

currencystring nullable

3-letter currency code (USD, EUR, AUD, etc.)

descriptionstring nullable

Product description (max 500 chars)

image_urlstring nullable

Main product image URL

image_urlsstring[]

All product image URLs (max 10)

vendorstring nullable

Brand or manufacturer name

product_typestring nullable

Product category

in_stockboolean nullable

Whether the product is in stock

on_saleboolean nullable

Whether the product is on sale

compare_at_pricestring nullable

Original price if on sale

urlstring required

The original URL that was scraped

Changes

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