Skip to main content

speedyindex — Python client for the SpeedyIndex API

speedyindex is a small, dependency-free Python client and command-line tool for SpeedyIndex, a service for link indexing and Google, Bing and Yandex index checking. It wraps the public SpeedyIndex API v2, so you can check whether a list of URLs is indexed, submit links for indexing and pull reports from scripts, cron jobs or CI.

  • Standard library only (urllib), Python 3.8+
  • Index checks for Google, Bing and Yandex
  • Link indexing tasks for Google and Yandex, with optional drip-feed
  • Task status, task list and full reports
  • Backlink checks: find links to your domains on donor pages
  • speedyindex CLI for quick jobs from the shell

Install

pip install speedyindex

API key

Every request needs an API key. You can find it in your SpeedyIndex dashboard or in the SpeedyIndex Telegram bot settings. The client reads it from the SPEEDYINDEX_API_KEY environment variable:

export SPEEDYINDEX_API_KEY="your-key"

Keep the key out of source code and commit history; use environment variables or your CI secret store.

Quick start (Python)

from speedyindex import SpeedyIndex

si = SpeedyIndex()  # reads SPEEDYINDEX_API_KEY

print(si.balance())

# Check which URLs are in Google's index
task = si.create_task(
    ["https://example.com/", "https://example.com/blog/post-1"],
    engine="google",
    task_type="checker",
    title="blog check",
)
print(task)

# Later: progress and the full report
task_id = si.list_tasks(engine="google")["result"][0]["id"]  # newest task
status = si.task_status([task_id], engine="google", task_type="checker")
report = si.full_report(task_id, engine="google", task_type="checker")

Submit links for indexing, spread over several days:

si.create_task(urls, engine="google", task_type="indexer", drip_feed=True, drip_feed_days=7)

Check donor pages for links to your site:

si.create_backlink_check(["https://donor.example/page"], target_domains=["mysite.com"])

Command line

speedyindex balance
speedyindex check urls.txt --engine google --title "weekly check"
speedyindex check urls.txt --engine bing
speedyindex index urls.txt --engine google --drip-feed-days 5
speedyindex status 65f8c7315752853b9171860a --type checker
speedyindex report 65f8c7315752853b9171860a --type checker > report.json
speedyindex tasks --engine google --page 0
speedyindex backlinks donors.txt --target mysite.com

urls.txt holds one URL per line; empty lines and lines starting with # are skipped, duplicates are removed. Use - to read URLs from stdin:

cat sitemap-urls.txt | speedyindex check - --engine google

Limits the client enforces

Rule Value
URLs per task up to 10,000
Task IDs per status request up to 1,000
Drip-feed days 2–30, and at least as many URLs as days
Bing checker tasks only
Google indexer always sent with pay_per_indexed: true (the only mode the API accepts)

API error codes are raised as SpeedyIndexError with .code: 1 means the balance is too low, 2 means a validation error.

Tips before you run an index check

  • Clean the list first: remove UTM parameters, fragments and duplicates.
  • Check status codes and noindex before submitting: a 404 or a noindex page will not be indexed whatever you do.
  • Google's own URL Inspection tool remains the reference for a single URL on a site you own.

License

MIT

Metadata

Release files for speedyindex 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for speedyindex 0.1.0
File Size Uploaded Provenance Actions
speedyindex-0.1.0.tar.gz 7.5 kB With provenance Details for speedyindex-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for speedyindex 0.1.0
File Interpreter ABI Platform Actions
speedyindex-0.1.0-py3-none-any.whl Python 3 none any Details for speedyindex-0.1.0-py3-none-any.whl

Total release size: 15.5 kB

Release files / speedyindex-0.1.0.tar.gz

Download URL speedyindex-0.1.0.tar.gz
Size 7.5 kB
Tags Source
SHA-256 checksum
How to use checksums
120e23d86816c57f4789cbdd57ac8099fb4078ceb8cc772dd82ea0328089631c
BLAKE2b-256 checksum
How to use checksums
34c1f92da5a5e1cb5adcb8b4d71a621dc8e1ba0bdc5bec248ac435aab39940f3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Release files / speedyindex-0.1.0-py3-none-any.whl

Download URL speedyindex-0.1.0-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b6ab7fe7f7828485b9a6cd1bc082dec1e3ba2e109c94f8cfcc2812ea5f938286
BLAKE2b-256 checksum
How to use checksums
8eeb91a982ed172729594388433c3b1cff721c59267a71926d3ee2dd1be26cce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

Security for speedyindex 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for speedyindex-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page