Indexing
Submit URLs
POST /io/indexing/submit — notify search engines of new or changed URLs for one site or all sites.
Notify search engines of new or changed URLs. With no explicit urls, the URL
set is derived from the target's sitemap.
POST https://api.misar.io/io/indexing/submit
Authentication
Service key only: x-indexing-service-key: <key>. See
Authentication.
Request body
| Field | Type | Default | Description |
|---|---|---|---|
domain | string | — | Required. Registry id, host/URL, or "all". |
urls | string[] | — | Explicit absolute URLs. When omitted, derived from the sitemap. |
engines | EngineId[] | server default | Subset of indexnow, google, bing, yandex, baidu, … |
source | "all" | "changed" | "all" | changed submits only new + changed URLs since the last run (sitemap diff). |
dryRun | boolean | false | Plan only — compute counts without contacting engines. |
{
"domain": "misar.blog",
"source": "changed",
"engines": ["indexnow", "google", "bing"],
"dryRun": true
}Response
{
"ok": true,
"action": "submit",
"results": [
{
"domain": "blog",
"baseUrl": "https://misar.blog",
"urlCount": 12,
"note": "sitemap diff: +9 new, ~3 changed",
"engines": [
{ "engine": "indexnow", "action": "submit", "ok": true, "submitted": 12 },
{ "engine": "google", "action": "submit", "ok": true, "submitted": 12, "quotaLeft": 188 },
{ "engine": "bing", "action": "submit", "ok": true, "submitted": 12, "quotaLeft": 9988 }
]
}
]
}Each engine returns one EngineResult. A skipped or
failed engine (ok: false) never fails the request.