fix72-indexnow

Lightweight IndexNow client for Node.js — submit URLs instantly to Bing, Yandex, Seznam and Naver with a single API call.

Built and maintained by Fix72 — IT repair specialists in Le Mans, France.

Install

npm install fix72-indexnow

Usage

import { submit } from 'fix72-indexnow';

const result = await submit({
  host: 'example.com',
  key: 'your-indexnow-key',           // key you generated at indexnow.org
  urls: [
    'https://example.com/new-page',
    'https://example.com/updated-post',
  ],
});

console.log(result.ok);     // true = 200 or 202 accepted
console.log(result.status); // raw HTTP status

Submit a single URL

import { submitOne } from 'fix72-indexnow';

await submitOne('https://example.com/page', {
  host: 'example.com',
  key: 'your-indexnow-key',
});

Custom key file location

await submit({
  host: 'example.com',
  key: 'abc123',
  keyLocation: 'https://example.com/seo/abc123.txt', // optional
  urls: ['https://example.com/'],
});

API

submit(options) → Promise<{status, ok}>

| Option | Type | Required | Description | |--------|------|----------|-------------| | host | string | ✅ | Your domain without protocol, e.g. "example.com" | | key | string | ✅ | Your IndexNow key | | urls | string[] | ✅ | Absolute URLs to submit (up to 10 000 per call) | | keyLocation | string | — | URL of the key verification file (auto-derived from host + key if omitted) |

Returns { status: number, ok: boolean } — ok is true for HTTP 200 and 202.

submitOne(url, options) → same as submit

Convenience wrapper for submitting a single URL.

Generate your IndexNow key

1. Generate a random key (any hex/UUID string, 8–128 chars)
2. Create a file at https://yourdomain.com/<key>.txt containing just the key
3. Use it in the options above

IndexNow propagates submissions to all partner engines (Bing, Yandex, Seznam, Naver) from a single call.

License

MIT — © Fix72