Install the indexmysite CLI, sign in, and submit URLs for Google indexing from your terminal or a script.

The indexmysite CLI lets you submit URLs and check on jobs from a terminal, a script, or a CI step.

Install

npm i -g indexmysite

Then check it is on your path:

indexmysite --version

indexmysite login

This opens your browser so you can sign in and approve the CLI. You only need to do this once per machine.

Submit URLs

Pass URLs as arguments:

indexmysite submit https://example.com/new-post https://example.com/pricing

Or submit from a file with one URL per line, or from standard input:

indexmysite submit --file urls.txt
cat urls.txt | indexmysite submit --stdin

Add --name "September launch" to label the job and --project <project-id> to file it under a project. Add --fast for faster Google indexing of time-sensitive pages, or --bing to also send each URL to Bing. Each adds 1 credit per URL, and add-on credits are not returned (see Fast and Bing). The command prints a request ID; pass it back with --request-id if you retry the same submission so it is not charged twice.

Each job accepts up to 2000 URLs. Each sent URL uses one credit, plus one for each add-on. The command prints the job as JSON, including its ID so you can check on it later and a guidance object that says which URLs were sent or are waiting for credits and when to expect the first Google search (24 hours), additional searches (around days 3 and 7 until the exact URL is found or confirmed indexed), full report (around day 5) and final checks (around day 14), timed from when each URL is sent. Searches without a match do not trigger refunds. See the API reference for the fields.

List jobs

indexmysite jobs

Shows your recent jobs with their names, URL counts, and how many URLs are indexed so far.

Check a job

indexmysite status <job-id>

Shows every URL in the job with its current status, from checking and queued through in progress to indexed, refunded, skipped or failed. Skipped URLs carry a skipReason; URLs waiting as needs_review carry preflightWarnings and mainWordCount. See Submitting URLs for what each status means.

Approve URLs that need review

indexmysite approve <job-id> <url-id> [<url-id>...]
indexmysite approve <job-id> --all

Pages with little main content wait until you approve them. Pass the URL ids from status, or --all for every waiting URL in the job. Approved URLs cost the job’s credits per URL when they are sent. Technical skips cannot be approved, and repeating an approval changes nothing.

Projects

indexmysite project list
indexmysite project create "Acme Co. website"
indexmysite project show <project-id>

list prints your projects with their IDs and index rates, create makes a new one and prints its ID, and show prints a project’s figures and recent jobs. Use the ID with submit --project.

Check credits

indexmysite credits

Shows your current balance.

Use it in scripts

The CLI exits with a non-zero code when a command fails, so it works in shell scripts and CI. If you need structured output, use the API directly.

The indexmysite CLI