dev.nichedb/nichedb

Tools

• add_source

  Add a source: an adapter with a config, fetched on a schedule (needs a key; admins and Pro). Call list_adapters first for the fields.

  shallow
• check_domain

  Is a domain name registered? Asks each registry over RDAP. Give `name` as a full name (foo.watches), or a bare word with `tlds` (foo + com,dev,io), or several names comma separated. Each answer is registered (with registrar and expiry), not_registered, or unknown. not_registered means the registry holds no registration; the name may still be reserved or premium, so it is not a promise that it is for sale. unknown (no RDAP server, a timeout, a 429) is never a yes. Each answer carries the cheapest known USD price for its ending.

  shallow
• claim_profile

  Claim a profile as the key owner (needs a key). Proven when the key owner’s email is one the profile lists, or when the person’s site or show page links back to the profile’s nichedb page. An admin may claim on behalf of an email.

  shallow
• create_feed

  Save a query as a feed (needs a key). Sources, kinds and tags narrow; q is a text match; upcoming keeps only future-dated items.

  shallow
• feed_items

  What a feed selects, newest first. Page with before_id.

  shallow
• follow_feed

  Follow a feed as the key owner (needs a key). Channels: webpush, email, webhook.

  shallow
• get_item

  One item with its full adapter payload.

  shallow
• get_profile

  One person by id, `<slug>-<id>` or handle: the parsed view and the OpenProfile.md as served.

  shallow
• get_tld

  One top-level domain: type, registry, RDAP server, when it entered or left the root, every registrar price (register, renew, transfer, restore, promotions, privacy, restrictions) and its change history.

  shallow
• list_adapters

  Every adapter this deployment can run, with the config fields each takes. Use before add_source.

  shallow
• list_collections

  The collections (niches) with their source, feed and item counts.

  shallow
• list_enrichers

  Every enricher (YouTube videos, Wikipedia, repo stats, downloads, company profiles, TL;DRs) and which collections turn it on by default. Items carry their results under `enrichment`.

  shallow
• list_feeds

  Public feeds, most followed first. Optionally one collection.

  shallow
• list_sources

  Sources with status, last run and item counts. Optionally one collection.

  shallow
• match_items

  Which title, channel or fixture is this name? Give a file name, a release name or a playlist entry ("Top.Gun.Maverick.2022.1080p.mkv", "US: ESPN2 HD"); it is cleaned (year, season and episode, quality tags, playlist decorations) and matched by similarity. A matchup ("NFL: Chiefs vs Bills", "Lakers @ Celtics", "Rangers at Celtic 19:45") is answered by the fixture whose two teams those are, kicking off between 36 hours ago and 7 days ahead unless date narrows it. Each result carries a score in 0..1. Use screen for films and TV, channels for television channels, sports for fixtures.

  shallow
• population

  Population and demography, drilled down from the world to the ZIP code. Give a `key` (us, us-ca, us-ca-los-angeles, gb, gb-england-london), a US `zip`, or a place name in `q`; no argument is the world. Answers with the area (population, year, measures: age, income, home value, rent, poverty, education, unemployment, race and Hispanic origin for the US; growth, age structure, births, deaths, fertility, life expectancy, migration, GDP per head and Gini for countries), how many areas of each level it contains, and the largest of its children at `level` (country, state, city or zip). Sources: World Bank, US Census ACS 5-year, GeoNames.

  shallow
• recent_items

  Newest items, optionally narrowed to a collection, source or kind.

  shallow
• run_source

  Fetch a source now instead of waiting for its schedule (needs a key; owner or admin).

  shallow
• search_items

  Full-text search over titles, summaries and tags. Use this first when you know a name.

  shallow
• search_profiles

  People: one entry per person assembled from every app that serves their OpenProfile.md (podcasters from p0dcasters, public profiles from OutreachGraph). Search by name, headline or anything in the document; newest change first. Each answer carries the page, the openprofile.md URL, accounts, topics, Broadcast shows and the Guest section.

  shallow
• search_tlds

  Top-level domains: every label in IANA's root, with type, registry, RDAP server and each registrar's one-year register/renew/transfer price (Porkbun, Dynadot, Cloudflare, OVHcloud). Sorted by renewal by default, because the first year is a promotion. `best` is the cheapest USD price across registrars; with `registrar` it is that registrar's own price in its currency. Answers carry facet counts. `trap: true` keeps only labels that renew at 2x the first year or more.

  shallow
• stats

  What this deployment holds: collections, sources, items, items added today, feeds.

  shallow
• submit_feed

  Suggest an RSS or Atom feed for the index. No key needed. An admin reviews every suggestion before anything is fetched; approved podcast feeds are handed to rssamplifier, everything else becomes a source here.

  shallow
• tld_changes

  Top-level domains added to or removed from IANA's root, newest first, with the IANA list version each happened in. Nobody else publishes this diff.

  shallow
• upcoming

  Items dated in the future (releases, launches, deadlines), soonest first.

  shallow
• update_profile

  Edit a profile you own (needs a key). Send `markdown`, a whole OpenProfile.md that replaces what you wrote before, or any of `name`, `headline`, `identity` (key: value, null removes), `sections` (name: body, `none` removes), `handle`, `public`. What you write wins over every source and survives every re-read.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/8cf5edfd-16c6-42d1-b4e0-7f71c290cbc5/badge.svg)](https://vouch.tools/servers/8cf5edfd-16c6-42d1-b4e0-7f71c290cbc5)