🔑 Nostr Scraper — Profiles, Posts & Search

A fast, login-free Apify Actor that extracts Nostr public data via the decentralized relay network. Nostr is a censorship-resistant social protocol with millions of users.

No authentication. No API keys. No browser. Pure WebSocket relay calls.

---

🔍 What It Does

Extracts public Nostr data from the relay network. Modes:

Mode	What You Get
Global Feed	Most recent public posts across the Nostr network.
Search Posts	Find posts by keyword (NIP-50 search on supported relays).
Get Profiles	Full profile: name, display name, bio, avatar, Lightning address, NIP-05.
Get User Posts	All public posts from specific Nostr users with full metadata.

Resolve users by hex pubkey or NIP-05 identifier (user@domain.com) — auto-lookup handled automatically.

---

📊 Data Extracted

Posts (Kind 1)

• Content text, creation date
• Author pubkey, npub
• Hashtags, referenced events, referenced pubkeys
• Event ID and signature

Profiles (Kind 0)

• Display name, bio, avatar, banner
• NIP-05 identifier, Lightning address (lud16)
• Website, pubkey, npub

---

⚙️ Input Parameters

Parameter	Type	Description
mode	string	feed, search, profile, or posts
npubs	string[]	Hex pubkeys for profile/posts modes
usernames	string[]	NIP-05 identifiers (e.g. jack@cash.app)
searchQuery	string	Keyword for search mode
maxItems	integer	Max results (1-500, default 50)
relays	string[]	Custom relay URLs — uses popular public relays if empty

Example: Get someone's profile

{
  "mode": "profile",
  "usernames": ["jack@cash.app"],
  "maxItems": 5
}

Example: Search for Bitcoin posts

{
  "mode": "search",
  "searchQuery": "bitcoin lightning",
  "maxItems": 100
}

Example: Global feed

{
  "mode": "feed",
  "maxItems": 50
}

---

💰 Pricing

Event	Price
Start (per run)	$0.005
Result	$0.001

With Apify's $5/month free credit, you get ~50 results free every month.

---

🔧 How It Works

This Actor connects to Nostr relays via WebSocket and sends standard REQ messages with filters. Public relays require no authentication — anyone can read the Nostr network.

Default relay pool: relay.damus.io, nos.lol, relay.nostr.band, relay.primal.net, and more.

---

🎯 Use Cases

• Content monitoring — track keywords and hashtags
• Profile data — enrich Nostr identities (NIP-05, Lightning addresses)
• Trend analysis — monitor what's trending on decentralized social
• Feed aggregation — build Nostr dashboards and feeds

---

❓ FAQ

Do I need a Nostr account? No. Nostr relays are public and read-only access requires no authentication.

How fast is it? 5-15 seconds for typical queries. WebSocket relay calls are fast and no browser or proxy overhead.

---

⚠️ Disclaimer

This Actor connects to public Nostr relays only. It does not publish any data — read-only access. Relays are third-party services; availability may vary.