Find SEO & GEO Entities

Insight Igniter

Extract the entities, topics, and relationships a page is associated with across traditional search and generative engines.

POSThttps://ai.seovendor.co/api/insight-igniter/

Authenticate every request by passing your secret key as k in the JSON body. Requests are POST with Content-Type: application/json.

01Request parameters

Field	Type	Required	Description
action	string	optional	entities Find entities.
web	string	required	Website URL, max 300 characters.
url	string	optional	Fallback website URL used when web is not sent, max 300 characters.
brand	string	optional	Brand text, max 60 characters.
lang	integer	optional	0 US English1 UK English2 Australian English3 Spanish4 Italian5 French6 German7 Portuguese8 Dutch9 Bulgarian10 Czech11 Danish12 Estonian13 Finnish +26 more options 14 Greek15 Hungarian16 Polish17 Norwegian18 Romanian19 Swedish20 Brazilian Portuguese21 Mexican Spanish22 Colombian Spanish23 Argentine Spanish24 Peruvian Spanish25 Canadian English26 Chilean Spanish27 Bolivian Spanish28 Catalan29 Austrian German30 Canadian French31 Belgian Dutch (Flemish)32 Belgian French33 Scottish English34 Slovak35 New Zealand English36 Irish English37 Swiss German38 Croatian39 Turkish
k	string	required	API key sent as k in query string, POST body, JSON body; api_key is also accepted, 11 to 120 characters.

02Response

Every response uses the standard envelope (success, application, action, data, meta, error). The data field for this endpoint is documented below.

successaction: entities · HTTP 200

200 response example

{
  "success": true,
  "application": "insight-igniter",
  "action": "entities",
  "data": {
    "results": [
      {
        "engine": 0,
        "result": [
          {
            "keyword": "white label seo",
            "category": "Agency Services",
            "confidence": 0,
            "intent": "commercial",
            "demand": 0,
            "engine": 0
          }
        ],
        "upstream_http_code": 200
      }
    ],
    "errors": [
      {
        "engine": 0,
        "code": "invalid_request",
        "message": "The kw field is required."
      }
    ]
  },
  "meta": {
    "request_id": "req_3f9a7c2e8b41",
    "duration_ms": 1284,
    "upstream_http_code": 200,
    "engines": []
  },
  "error": null
}

Response schema

successboolean= true

applicationstring= "insight-igniter"

actionstring= "entities"

dataobjectEntity discovery results across multiple AI engines.

└─resultsarraySuccessful entity discovery results, one entry per AI engine.

└─engineintegerAI engine ID.

└─resultarrayEntities discovered by this engine.

└─keywordstringDiscovered entity name.

└─categorystringEntity category.

└─confidenceintegerConfidence score 0 to 100.

└─intentstringSearch intent classification.

└─demandintegerEstimated entity demand 0 to 100.

└─engineintegerEngine ID that produced this entity.

└─upstream_http_codeintegerHTTP status from the engine endpoint.

└─errorsarrayEngines that failed or returned no data.

└─engineintegerAI engine ID.

└─codestringError code.

└─messagestringError description.

metaobject

└─request_idstring

└─duration_msinteger

└─upstream_http_codeinteger

└─enginesarray

errornull

errorHTTP 400, 401, 502, 503, or 504

error response example

{
  "success": false,
  "application": "insight-igniter",
  "action": "string",
  "data": null,
  "meta": {
    "request_id": "req_3f9a7c2e8b41"
  },
  "error": {
    "code": "invalid_request",
    "message": "The kw field is required.",
    "field": "kw",
    "details": [],
    "apidefinitions": "https://ai.seovendor.co/api/insight-igniter/definitions"
  }
}

Response schema

successboolean= false

applicationstring= "insight-igniter"

actionstring

datanull

metaobject

└─request_idstring

errorobject

└─codestringError code returned by the API.

└─messagestringHuman-readable error message.

└─fieldstringInput field associated with the error.

└─detailsarrayAdditional error details.

└─apidefinitionsstringPublic API definitions URL.

POST /api/insight-igniter/

curl -X POST "https://ai.seovendor.co/api/insight-igniter/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "k": "[API KEY]",
  "action": "entities",
  "web": "https://seovendor.co",
  "brand": "SEO Vendor"
}'
<?php
$ch = curl_init("https://ai.seovendor.co/api/insight-igniter/");

$payload = [
    "k" => "[API KEY]",
    "action" => "entities",
    "web" => "https://seovendor.co",
    "brand" => "SEO Vendor",
];

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "Accept: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
const response = await fetch("https://ai.seovendor.co/api/insight-igniter/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json"
  },
  body: JSON.stringify({
    k: "[API KEY]",
    action: "entities",
    web: "https://seovendor.co",
    brand: "SEO Vendor",
  })
});

const data = await response.json();
console.log(data);
import requests

url = "https://ai.seovendor.co/api/insight-igniter/"

payload = {
    "k": "[API KEY]",
    "action": "entities",
    "web": "https://seovendor.co",
    "brand": "SEO Vendor",
}

headers = {
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

← PreviousBetter Keywords AI Next →Topical Authority

SEO Vendor API

Overview API Home seovendor.co