Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.linkstonic.com/llms.txt

Use this file to discover all available pages before exploring further.

The Linkstonic Webhook API lets you trigger Linkstonic actions from any external system that can send an HTTP POST request. Whether you’re building automation workflows in n8n, chaining Linkstonic into a multi-step pipeline, or calling it from a custom script, the API gives you programmatic access to the same actions available in the Linkstonic UI — tracking, analysis, reporting, and monitoring — on demand.

​
Supported trigger actions

Each API request specifies an action field that determines what Linkstonic executes:
ActionWhat it does
trackTriggers an AI visibility check for a specified keyword and brand.
analyzeRuns a TrueTrace analysis for a URL or brand, examining how AI platforms reference the target.
reportGenerates an audit report and returns a link to retrieve it when complete.
monitorTriggers a monitoring check and returns the current visibility status for the brand.

​
Prerequisites

  • Agency plan required — the Webhook API is not available on Starter or Pro plans.
  • An active Linkstonic workspace with at least one brand configured.

​
Get your webhook URL and API key

1

Open API & Webhooks settings

In Linkstonic, go to Settings → API & Webhooks.
2

Generate your webhook URL

Click Generate Webhook URL if you don’t have one yet, or copy your existing URL from the field shown on the page.
3

Copy your API key

Your API Key is displayed on the same page. Copy it now — you’ll include it as a Bearer token in every request. Keep this key private and do not commit it to source control.

​
Call the webhook

Send a POST request to your webhook endpoint with a JSON body specifying the action and its parameters. Include your API key in the Authorization header. 
POST https://app.linkstonic.com/api/webhook
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "action": "track",
  "keyword": "best project management software",
  "brand": "YourBrand",
  "callback_url": "https://your-n8n-instance.com/webhook/callback"
}
Replace YOUR_API_KEY with the key from your Settings → API & Webhooks page, and replace YourBrand with the exact brand name as it appears in your Linkstonic workspace.

​
Example response

Linkstonic responds immediately with a job ID and status — the action runs asynchronously. 
{
  "job_id": "jb_abc123",
  "status": "queued",
  "action": "track",
  "estimated_completion_seconds": 30
}
Use job_id to correlate the callback response with the original request when running multiple concurrent jobs.

​
Receive results with a callback URL

Pass a callback_url in your request body and Linkstonic will POST the completed results to that URL when the action finishes. This is the recommended pattern for asynchronous workflows — your automation can move on immediately after queuing the job and handle the results when they arrive. If you omit callback_url, you can poll the job status using the job_id returned in the initial response.
Use the callback_url pattern to chain Linkstonic results into downstream workflow steps. For example, trigger an analyze action from a scheduled n8n workflow, receive the TrueTrace results at your callback URL, then pass those results to a downstream node that formats and posts a summary to a Slack channel — no manual reporting needed.

​
Set up in n8n

1

Add an HTTP Request node

In your n8n workflow, add an HTTP Request node at the point where you want to trigger a Linkstonic action.
2

Configure the request

Set the method to POST and the URL to your Linkstonic webhook endpoint from Settings → API & Webhooks.
3

Add the Authorization header

In the Headers section, add a header with name Authorization and value Bearer YOUR_API_KEY.
4

Set the JSON body

Set the body type to JSON and add your desired action, along with the relevant parameters (keyword, brand, callback_url, etc.).
5

Add a Webhook node to receive the callback

Add a Webhook node in n8n and copy its URL. Paste that URL as the callback_url value in your HTTP Request node body. This is the endpoint Linkstonic will POST results to when the job completes.
6

Test end-to-end

Activate the Webhook node, then execute the HTTP Request node manually. Confirm that Linkstonic responds with a queued status and that the callback fires at your n8n Webhook node within the estimated completion window.
The Webhook API is exclusively available on the Agency plan. If your workspace is on Starter or Pro, requests to the webhook endpoint will return a 403 Forbidden response. Upgrade your plan under Settings → Plan & Usage to gain access.

Smart Alerts

Configure threshold-based alerts for AI visibility changes, ranking drops, and competitor activity.

Discord Integration

Route Linkstonic alerts directly to Discord channels using webhook URLs.