Documentation

One request shape, every service

Every one of the 58 services across 19 platforms uses the same base URL, the same auth header and the same response envelope. A credit is worth $0.0015 and each service lists its own credits-per-call cost — most are 1 credit, X and SEO endpoints less.

1. Authentication

Send your key in the X-API-Key header. Keys are created in the dashboard and shown only once — store them as a server-side secret and never ship them in browser code.

header
X-API-Key: ff_live_xxxxxxxxxxxxxxxxxxxx

2. Base URL & endpoint shape

endpoint
GET https://fastfetchz.com/v1/{platform}/{service}?target={handle|url|id}&limit={n}

The same path is also served from your project host under /v1/… so you can test without leaving the app.

3. Parameters

target
required

Handle, profile URL, post URL, ASIN, place or keyword — whatever the service resolves.

limit
optional

Maximum records to return from a list-style service. Each service has its own page size — shown under Limits on its reference page — and limit is capped at it. Omit it and you get the whole page. It shapes the response, not the price: a call costs the same either way.

cursor
optional

Pagination cursor returned as next_cursor on list responses.

fresh
optional

Set fresh=true to bypass cached data and force a live fetch — use it for daily monitoring or any figure you track over time. A separate query parameter, never a value of target. Accepts true, 1, false or 0; anything else returns 400 invalid_fresh. Defaults to false, and costs exactly the same as a cached call. Responses include cached: true|false when we can tell.

Number precision

Counts such as follower_count and like_count are always the most exact figure the platform publishes, never a display-rounded one. Two exceptions are the platform's own doing and not ours: YouTube publishes subscriber counts rounded to three significant figures (15.1M), and Facebook rounds Page follower counts for large Pages. Where a platform only publishes a rounded figure we return that figure rather than invent precision — every other count in the catalog is exact and safe to track day over day.

4. Make a call

curl
curl "https://fastfetchz.com/v1/instagram/profile?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"
node
const res = await fetch(
  "https://fastfetchz.com/v1/tiktok/videos-user-videos?target=nasa&limit=10",
  { headers: { "X-API-Key": process.env.FASTFETCHZ_KEY } },
);
const payload = await res.json();
console.log(payload.data);
python
import os, requests

res = requests.get(
    "https://fastfetchz.com/v1/youtube/transcript",
    params={"target": "dQw4w9WgXcQ"},
    headers={"X-API-Key": os.environ["FASTFETCHZ_KEY"]},
)
print(res.json()["data"])

5. Errors

Failed calls are never charged. Errors return a JSON body of the shape { error: { code, message, status } }.

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.
402insufficient_creditsYour balance is below the cost of the call. Top up to continue.
403account_suspended / key_revokedThe account is suspended or the key was revoked.
429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.
429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.
500upstream_errorUnexpected failure while fulfilling the request. Not charged.

Service reference

Each service has its own reference page with parameters, an example request and a full example response.

Browse all 58 services →