Skip to main content

Confirm

Are you sure?

URLpipe
Sign inStart free

URLpipe

Changelog · September 24, 2026

Labels: tag requests with your own ids

Know which requests — and which credits — belonged to which of your clients.

By · Last updated: September 2026

TL;DR

Every endpoint now takes labels: a flat object of your own keys and string values, such as {"client": "acme"}, up to 16 per request. They come back in the response headers, the webhook payload, GET /result and MCP, and the dashboard totals requests, failures and credits per label value each month.

Start freeSee the API

Free plan, no credit card. 1,000 credits a month.

Agencies and anyone running work for their own customers need to know which requests belonged to whom. labels is an object of up to 16 keys (40 characters each) with string values (up to 256 characters). Strings only and nothing coerced, so what you filter by is exactly what you sent; anything else is a 422 invalid_labels before any work is done.

Labels come back wherever the request is reported: X-Labels on every response, the async accept and GET /result's pending body, the webhook payload beside the token, and MCP's metadata. They are not part of the cache key, so a labelled repeat is still a free cache hit, and keeps its own labels.

Request

Example

Label a request
curl -X POST https://urlpipe.dev/screenshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "labels": {"client": "acme", "job": "weekly-report"}}'

In the dashboard, History gains a Labels column and a key/value filter, and a Labels tab totals requests, failures and credits per value of a key per calendar month — counted by the same rules as your bill, with unlabelled usage alongside so the figures add up.

Labels docs

Endpoints

The endpoints on this page

/screenshot API docs/console API docs

FAQ

Frequently asked questions

How many labels can one request carry?
Up to 16 keys, each up to 40 characters, with string values up to 256 characters.
Do labels change what is cached?
No. They are not part of the cache key, so a labelled repeat of a request is still a free cache hit.
Can MCP tools use labels?
Yes. The MCP tools take labels, and list_requests can filter by them.

Keep reading

Monitoring client websitesFilter requests and webhooks in the dashboardRequest timing as marks, not spansParallel requests per planConsole APIUnhandled promise rejectionAll of changelog

Try it on the free plan.

Free plan, no card. Confirm your email and your API key is live — you'll be making real requests in minutes.

Start freeEmail the team