Skip to main content

Surface: check a short link before you open it

links checked | Surface

Surface follows the hops on t.co, bit.ly, lnkd.in and youtu.be links (or any https URL) and says fetch or skip. It never returns the page, so it's one quick round trip.

Free for the first 1,000,000 requests every month, no card needed. After that: Preflight $0.25, Hop $0.40, Pixel $0.15, Inspect $0.20 per 1,000 requests (USD). Production plan with your own key and meter: $50 CAD/month (billing).

Get started · Docs · Free API key in 10 seconds: curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys

One install for Cursor or Claude (MCP)

Paste this into your MCP settings. The agent then calls preflight_url before it opens a short link.

{ "mcpServers": { "surface": { "type": "http", "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }

Python

pip install surfaceapi

from surfaceapi import Surface
key = Surface().create_key().get("key")   # free key
s = Surface(api_key=key)
print(s.preflight("https://youtu.be/jNQXAC9IVRw"))  # next: fetch or skip
print(s.inspect())                                  # bot, browser, or script

JavaScript: npm install @surfaceapi/surface

Metadata

Release files for surfaceapi 0.1.1

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

Source distribution (sdist)

Source distribution for surfaceapi 0.1.1
File Size Uploaded Provenance
surfaceapi-0.1.1.tar.gz 3.6 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 7.5 kB

Release files / surfaceapi-0.1.1.tar.gz

Download URL surfaceapi-0.1.1.tar.gz
Size 3.6 kB
Tags Source
SHA-256 checksum
How to use checksums
bdbcab9608611f48b07b6d8aa9e60b96f6eb8dffe0d43552b6b2a5bc929f3b26
BLAKE2b-256 checksum
How to use checksums
fd18cf73c73773af11d6ffbbe354934460fea65e149cbcbb89ec426142b11cdb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Release files / surfaceapi-0.1.1-py3-none-any.whl

Download URL surfaceapi-0.1.1-py3-none-any.whl
Size 3.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c94ee8376ae9b811bd980784cb14555e3bdcce186bd271ac4895e360407340db
BLAKE2b-256 checksum
How to use checksums
4f52cbfcfc0e539bb8e3dab1beae5c27153ff9b660b87ebda2cda01e5266b054
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.5

Security for surfaceapi 0.1.1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.1 This release

2 release files No 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