Liinks

Add a block to a tab within a profile’s page. Supported types: link, text (Markdown), divider, folder, media (YouTube/Vimeo/Spotify embeds). Other block types the dashboard offers (forms, FAQ, testimonials, countdown, …) can be read and edited but not created here. Thumbnail and media URLs are fetched from the public internet and re-hosted. New blocks are live on the public page immediately and land at the top by default; use position: "bottom" to append, or after: "<blockId>" to insert beneath an existing block. For folders: create the folder first, then add child blocks with folderId set.

add_block

Performance report for a profile over a window (default: last 30 days). Returns `summary.current` (views, unique visitors, clicks, `ctr` and `engagement` as fractions) alongside `summary.previous` for the same-length window before it, a `timeseries`, and `blocks`/`socials` ranked by clicks with zero-click entries included. Use it to answer "how is my page doing" and to decide what to reorder or hide.

get_analytics

Events in a window grouped by one dimension: geography (`country`, `region`, `city`), traffic source (`referrer`, `referrer_source`, `referrer_channel`, `utm_source`, `utm_medium`, `utm_campaign`), or client (`device`, `browser`, `os`). Rows are ranked by count. Pass `eventType: "PAGE_VIEW"` for "where do my visitors come from" and `"LINK_CLICK"` for "which traffic actually clicks".

get_analytics_breakdown

Read one profile in a single call: profile fields plus, by default, theme styles, social links, all blocks (in display order), and the tab list (the legacy `pages` field). Read this before making edits so updates start from current state. Pass `include` to fetch only the parts you need — e.g. `["blocks"]` when reordering, or `[]` for just the profile fields — the styles section alone is ~60 keys.

get_profile

Read visitor responses to forms on the profile, newest first. Answers are visitor-supplied and may include contact details (name, email, phone) and free text; password-type answers are never returned. For polling, pass `since` (ISO 8601) with the highest createdAt seen so far and dedupe by id.

list_form_submissions

List the Liinks profiles this API key can manage. Always includes the key owner's own profile; agency owners also see their managed profiles (sometimes dozens). Call this first to get valid profile ids. Returns id, slug, displayName, and updatedAt per profile; pass `detail: "full"` for bio, tagline, picture, and socials.

list_profiles

Read the page's email subscribers, newest first. For polling, pass `since` (ISO 8601) with the highest createdAt seen so far and dedupe by id.

list_subscribers

Permanently delete one block from the profile. This cannot be undone via the API, so before calling it, confirm with the user which block(s) they mean and that they want deletion rather than hiding. For "remove everything" or multi-block requests, offer to hide the blocks instead (update_block with { "hidden": true }, which is reversible) and only delete after the user has approved the exact list. Never call this for more than one block without that approval.

remove_block

Set the top-to-bottom order of blocks on one tab. orderedIds must contain EXACTLY the ids currently on that tab — no extras, none missing. Read the current set with get_profile first. For single insertions prefer add_block with position/after.

reorder_blocks

Render the live public page in headless Chrome and return JPEG URLs covering the full page in viewport-sized chunks (top to bottom). Use after any visual change to verify the result. Each call stores the captured frames as image uploads on the account (they are not deleted afterwards). Defaults to a 375×812 mobile viewport; pass 1280×800 for the desktop layout.

screenshot_profile