# Hugging Face Scraper | Hub Models & Authors (`lentic_clockss/huggingface-scraper`) Actor

Scrape the Hugging Face Hub: models, datasets, Spaces, papers and collections. Rows include author names, socials, and the Hugging Face org press email when published. No phones or street address. Guest Hub REST — no API token, no weight download. Export CSV, Excel or JSON.

- **URL**: https://apify.com/lentic\_clockss/huggingface-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** Developer tools, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**Hugging Face scraper** (also searched as **HuggingFace Hub scraper**) for the public [Hugging Face Hub](https://huggingface.co/) — search and export **models, datasets, Spaces, papers, and collections** without an API token. Rows include **author names, profile socials, and the Hugging Face org press email when published**. There are **no phones and no street addresses** on guest Hub pages. A practical **Hugging Face Hub API / model-card extractor** when you need guest-visible metadata in **CSV, Excel, or JSON**, not model weights.

This Actor is built for no-code operators first: pick a search type, enter a query (or a `repoId`), set `maxResults`, click **Start**, and download the Dataset. Developers can call the same Actor from the Apify API, Make, n8n, Zapier, LangChain, or a scheduled task.

> Thin Apify Actor + managed worker. Guest Hub REST only. The worker owns residential egress. You do not send a Hugging Face token, cookies, or `proxyUrl`. This Actor does **not** download weights or launch Spaces.

***

### What does the Hugging Face Scraper do?

The **Hugging Face Scraper** collects **public Hugging Face Hub listings and detail metadata** that a logged-out visitor can already see. It talks to Hub REST (`/api/models`, `/api/datasets`, `/api/spaces`, `/api/papers`, `/api/collections`) — **no Hugging Face account and no `hfToken`**.

Give it a query and a `searchType`, or a live `org/name` / paper id. The Actor:

1. Validates the input (`query`, `searchType`, `repoId` when required)
2. Calls a managed worker that fetches **huggingface.co** guest JSON
3. Parses opened surfaces into normalized Dataset rows (id, URL, downloads, likes, pipeline tag, license, tags, person, emails, …)
4. Dedupes and caps output with `maxResults` / `maxPages`. `enrichDetails` defaults **on** so author/org rows get profile leads.
5. Writes `INPUT_ECHO`, `RUN_SUMMARY`, and (on failure) `ERROR_SUMMARY` to the key-value store

#### Opened surfaces (what actually works)

| Mode (`searchType`) | What you scrape | Required input |
| --- | --- | --- |
| `models` | Model search / catalog | `query` optional; empty lists the default Hub feed |
| `datasets` | Dataset search / catalog | `query` optional; `modality`, `language`, `filterTags` |
| `spaces` | Space search / catalog (REST; HTML pager not used) | `query` optional; `spaceFilter` (e.g. `gradio`, `docker`) |
| `papers` | Papers catalog | Empty query lists the default feed (`search=` is ignored by Hub REST) |
| `collections` | Collections catalog | Empty query lists the default feed (`search=` is ignored by Hub REST) |
| `model` / `dataset` / `space` | Repo detail metadata | `repoId` (`org/name`) |
| `paper` | Paper detail | `repoId` (arxiv-style id, e.g. `2608.14978`) |
| `collection` | Collection detail | `repoId` (slug `org/collection-id`) |
| `files` | Files **tree metadata** (path, type, size) | `repoId` + optional `repoKind` |

Optional filters: `pipelineTag` (models), `filterTags` (e.g. `license:mit`, `diffusers`), `author`, `sort` (`downloads`, `likes`, `createdAt`, `lastModified`). Optional `detailUrls` for live huggingface.co model / dataset / space / tree / paper / collection URLs.

#### Honest limits (read this before you buy a competitor)

This Actor stays on **guest Hub metadata**. That is the point — and the constraint.

- **No phones and no street / 门牌.** Hugging Face profiles do not publish a mailing address or phone. `phones[]` is empty with `leadAbsences.reason=本站无`. Model ids that look like dates are not phone numbers.
- **Email is rare.** `press@huggingface.co` is the Hugging Face **org** press mailbox (plain mailto, already visible). User profiles usually have no mailto. `git@hf.co` is a git clone address, not an outreach email — it is never written to `emails[]`. This Actor does **not** stamp press@ onto every model row.
- **No Hugging Face token / no login.** Opened guest surfaces work without `hfToken`. Gated repos stay gated flags; we do not store cookies or mint sessions.
- **No weight download.** We do not fetch `/resolve` blobs, LFS, or safetensors files. `searchType=files` is **paths and sizes only**.
- **No Space launch / no Inference click.** Space rows are listing + detail metadata. `/inference/models` is not a repo id.
- **Papers / collections keyword search is ignored** by Hub REST (measured). Those modes list the default catalog + detail. Use `models` / `datasets` / `spaces` when you need `search=`.
- **HTML `sort=trending` is default Hub order.** API `sort=trending` returns 400 — omit sort or use `downloads` / `likes`.
- **Not opened:** Hugging Face Enterprise Hub, Community / discussions / commits, Home shelf, login, Inference Providers, `hf-mirror.com` as a separate catalog.

Other Store Actors may add author-website emails, eval-result enrichment, or monitor-only-new-releases. This one does **not**. Use it when you want **tokenless Hub listings + papers/collections + file-tree metadata**, exported as tables, at **$3.00 / 1,000 results** with **developer-paid platform usage**.

***

### What Hugging Face data can I extract?

Typical default-dataset fields (exact keys vary by mode):

| Field | Example / notes |
| --- | --- |
| `id` | `org/name`, paper id, or collection slug |
| `url` | `https://huggingface.co/...` link |
| `kind` / `type` | `model`, `dataset`, `space`, `paper`, `collection` |
| `pipelineTag` | Hub task (`text-generation`, `fill-mask`, `text-to-image`, …) |
| `downloads` / `likes` | Popularity when the listing exposes them |
| `license` | From `license:` tags or model card |
| `tags` | Hub tags (library, language, modality, …) |
| `authorName` | Owner / org login before enrich; display name after `enrichDetails` |
| `person.name` | Profile H1 / og:title (sample: Emils Petracenoks on `thoughtcast`) |
| `emails` | Usually empty. `press@huggingface.co` only on Hugging Face org rows |
| `web.socials` | Profile X / GitHub when they match the author login — not site footer links |
| `phones` / `address.street` / `geo` | Always empty; see `leadAbsences` (`本站无`) |
| `leadSource` / `leadReveal` / `leadAbsences` | Where the lead came from, and why phones/street/email are empty |
| `gated` | Whether the repo is gated |
| `files` / `fileCount` | Tree metadata only (`searchType=files`) — no `oid`, no blobs |

You get **structured rows you can join, filter, and schedule** — not a dump of model binaries and not a clone of the repo.

**You do not get:** weight files, `/resolve` URLs, Space runtime logs, Inference Provider responses, or anything behind Hugging Face login / Enterprise Hub.

***

### Why scrape Hugging Face?

[Hugging Face](https://huggingface.co/) is the default public index of **open models, datasets, Spaces, and ML papers**. Scraping the **Hugging Face Hub** is useful when you need a spreadsheet or pipeline of **downloads, likes, licenses, and pipeline tags** without paging the website or maintaining a Hub client.

Common jobs:

- **Model discovery** — find models by keyword or `pipelineTag` (`text-generation`, `text-to-image`, `automatic-speech-recognition`) and export downloads + URLs
- **License / stack audits** — `filterTags` such as `license:mit` or `diffusers`; dataset `language=zh` via Hub `filter=language:zh`
- **Dataset & Space catalogs** — list datasets by modality (`audio`, `image`, `text`) and Spaces by SDK (`gradio`, `docker`, `streamlit`)
- **Papers & collections** — pull the current Hub papers feed and curated collections (catalog + detail)
- **File inventories** — `searchType=files` for path/size metadata without downloading weights
- **Automation** — feed CRM, MLOps dashboards, competitive intel, or an AI agent via CSV / JSON / the Apify Dataset API

**Why not just use `huggingface_hub`?** The official library is the right choice when you already have a token, need to download weights, or must manage private repos you own. This Actor is a **Hugging Face API alternative for guest metadata**: no token to rotate, export-ready tables, and pay-per-result pricing.

**Why not a lead-gen Hub scraper?** Those tools are stronger when you *want* author websites and contact emails. This Actor is the opposite trade: **public, tokenless, listing/detail metadata only** — no website crawl, no email enrichment.

#### How this Hugging Face scraper compares

Store search for “Hugging Face scraper” also surfaces model-only Actors and lead-gen Hub crawls. This one is the **tokenless Hub catalog + papers/collections** option.

| | This Actor | Typical Store peers |
| --- | --- | --- |
| Models, datasets, Spaces | Yes (one `searchType` per run) | Often models-only, or all three in one run |
| Papers & collections | Yes (catalog + detail) | Usually not |
| Files tree (path/size) | Yes — **no weight download** | Rare |
| Author emails / website crawl | No | Some lead-gen Actors |
| Eval results / GGUF / param counts | No | Some enrichment Actors |
| Hugging Face token | Not required | Usually not required |
| Price (FREE / BRONZE) | **$3.00 / 1,000** + $0.005 start | About $2.20–$5.00 / 1,000 |

Use a peer when you need emails, eval tables, or GGUF flags. Use this Actor when you want **Hugging Face Hub listings you can export today**, including papers and collections.

***

### Pricing

**Pay per event.** You pay for Actor start + each **result** written to the default dataset. Platform compute / memory for this Actor is paid by the developer (`User pays platform usage costs = No`).

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start (per GB of memory, minimum one event) |
| result (`apify-default-dataset-item`) | **$3.00 / 1,000** on FREE & BRONZE (**$0.003** each) |

#### Volume examples (FREE / BRONZE, one start at 1024 MB)

| Results | Event charges (approx.) |
| --- | --- |
| 100 | $0.005 + $0.30 = **$0.305** |
| 1,000 | $0.005 + $3.00 = **$3.005** |
| 10,000 | $0.005 + $30.00 = **$30.005** |

#### Store volume tiers (per result)

| Tier | $/1,000 | per result |
| --- | --- | --- |
| FREE | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

Default memory is **1024 MB**. Actor Start is charged per GB (minimum one event). Keep `maxResults` at 2–15 while you test a query.

Empty / failed runs that write **zero** default-dataset rows are not billed as results (you still pay Actor Start).

Free Apify-plan users: this Actor caps **10 runs** and **200 results per run** (developer limit, not Apify).

***

### More Actors like this

Use a **specialized Actor** when one exists for your site — structured fields, better coverage, usually lower cost. Use **Hugging Face Scraper** for public Hub models, datasets, Spaces, papers, and collections. Use the general tools below when you need email/phone checks or a generic protected-page scrape.

#### General tools

- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)
- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)

#### Developer / Open source / AI

- [Hugging Face Scraper](https://apify.com/lentic_clockss/huggingface-scraper)
- [GitHub Scraper](https://apify.com/lentic_clockss/github-scraper)
- [Apple App Store Scraper](https://apify.com/lentic_clockss/apple-app-store-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Prefer a dedicated site scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic URL scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**E-commerce**

- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape Hugging Face models

No code required.

1. Open **Hugging Face Scraper** in [Apify Console](https://console.apify.com/) (Actor `lentic_clockss/huggingface-scraper`).
2. Set **Search type** — start with `models` (or `datasets` / `spaces` / `papers` / `collections`).
3. Enter a **Search query** (for example `whisper`, `qwen`, `llama`) or leave it empty to list the default Hub catalog.
4. Optional: set `pipelineTag` (`text-generation`), `filterTags` (`license:mit`), dataset `language` (`zh`), or Space `spaceFilter` (`docker`).
5. Set `maxResults` to **5–15** for a first run and `maxPages` to `1`.
6. Click **Start**. When the run finishes, open the **Dataset** tab.
7. Download **CSV, Excel, or JSON**.

That is enough for most spreadsheet and no-code workflows. Developers can skip the UI and POST the same JSON to the Apify Runs API.

#### Example: scrape Hugging Face models

```json
{
  "query": "whisper",
  "searchType": "models",
  "maxResults": 15,
  "maxPages": 1
}
```

#### Example: filter models by pipeline tag

```json
{
  "query": "",
  "searchType": "models",
  "pipelineTag": "text-to-image",
  "maxResults": 15,
  "maxPages": 1
}
```

#### Example: scrape Hugging Face datasets by language

```json
{
  "query": "",
  "searchType": "datasets",
  "language": "zh",
  "maxResults": 10,
  "maxPages": 1
}
```

#### Example: Hugging Face Spaces by SDK

```json
{
  "query": "",
  "searchType": "spaces",
  "spaceFilter": "gradio",
  "maxResults": 10
}
```

#### Example: model detail + files tree (metadata only)

```json
{
  "searchType": "files",
  "repoId": "openai/whisper-tiny",
  "repoKind": "models",
  "maxResults": 1
}
```

***

### Connect to your tools

Use this Actor from your existing stack:

| Platform | How to connect |
| --- | --- |
| **Make.com** | Search "Apify" → "Run Actor" → Actor ID: `lentic_clockss/huggingface-scraper` |
| **n8n** | Add Apify node → "Run Actor" → same Actor ID |
| **Zapier** | Apify integration → "Run Actor" |
| **LangChain** | `ApifyActorsTool("lentic_clockss/huggingface-scraper")` |
| **Python / Node.js** | Apify SDK or direct HTTPS call |

#### API call example

```bash
curl "https://api.apify.com/v2/acts/lentic_clockss~huggingface-scraper/runs" \
  -X POST \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"qwen","searchType":"models","maxResults":10,"maxPages":1}'
```

Read results from the Dataset API:

```http
GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json
```

You can also schedule the Actor (daily model watch, weekly dataset inventory) from Console.

***

### FAQ

**Phone and street/门牌: no** — Hugging Face does not publish them on guest pages (`leadAbsences.reason=本站无`). **Email:** only the Hugging Face org press mailbox `press@huggingface.co` is a reliable public mailto; most authors have none. Leave `enrichDetails` on (default) to fill `person.name` and matching socials from `/{author}`.

**Do I need a Hugging Face API token?**
No. Opened guest surfaces run **without `hfToken`**. Do not paste a token into input.

**Is this a Hugging Face API alternative?**
For **public Hub listing and detail metadata**, yes: you export CSV / Excel / JSON without managing Hub clients or tokens. It is **not** a replacement when you need weight downloads, private repos, or Inference Providers.

**Can I scrape models, datasets and Spaces together?**
Each run uses one `searchType`. Run three times (or three tasks) and merge Datasets if you need all three catalogs in one sheet.

**Can I download model weights?**
No. This Actor does not clone repos or fetch `/resolve` blobs. Use `huggingface-cli download` or the official Hub library for source.

**Why is papers search ignoring my query?**
Hub REST `GET /api/papers?search=` does not change the first results (measured). `searchType=papers` lists the default papers feed. Use paper **detail** with `repoId` for a known arxiv id.

**Does `sort=trending` work?**
Not on the Hub REST list. Omit sort (default Hub order, closest to HTML trending) or use `downloads` / `likes` / `createdAt` / `lastModified`.

**How is this different from other Hugging Face scrapers on Apify Store?**
[ParseForge’s model scraper](https://apify.com/parseforge/hugging-face-model-scraper) is models-only (~$5 / 1k). [Scrape Sage](https://apify.com/scrapesage/hugging-face-scraper) adds eval results and monitor-new-releases. This Actor covers **models + datasets + Spaces + papers + collections + files-tree metadata**, emits **author names / socials** (phones and street are 本站无; `press@huggingface.co` only on the Hugging Face org), stays **tokenless**, does **not** download weights, and prices PPE at **$3.00 / 1,000 results** with **developer-paid platform usage**.

**Do I need to bring proxies?**
No. Do not send `proxyUrl`. The worker provides egress (`WORKER_PROVIDES_PROXY=1`).

**What if a run returns 0 rows?**
The query may be too tight, the filter tag may have no matches (`filter=language:zh` on models is not applied — language is datasets-only), or the mode may be out of scope (Enterprise / login). Retry with an opened `searchType` and a broader `query`.

**Is it legal to scrape Hugging Face?**
You are responsible for how you use the data. This Actor only collects **public guest-visible** Hub metadata, does not log in, and does not download weights. Follow [Hugging Face Terms](https://huggingface.co/terms-of-service) and your own compliance review. Unofficial — not affiliated with Hugging Face, Inc.

**Can I use it from Make, n8n, Zapier, or LangChain?**
Yes. Actor ID `lentic_clockss/huggingface-scraper`. See [Connect to your tools](#connect-to-your-tools).

***

### Input reference

| Field | Type | Description |
| --- | --- | --- |
| `query` | string | Hub `search=` for models/datasets/spaces. Empty lists the default catalog. Ignored for papers/collections |
| `searchType` | string | `models`, `datasets`, `spaces`, `papers`, `collections`, `model`, `dataset`, `space`, `paper`, `collection`, `files` (opened). Others in the schema are not supported (enterprise, community, home, login, inference) |
| `repoId` | string | `org/name` for detail/files, paper id, or collection slug |
| `owner` / `name` | string | Combined when `repoId` is empty |
| `repoKind` | string | `models`, `datasets`, or `spaces` for files/detail when the URL is ambiguous |
| `pipelineTag` | string | Models `pipeline_tag=` (`text-generation`, `fill-mask`, `text-to-image`, …) |
| `filterTags` | array | Extra Hub `filter=` tags (`license:mit`, `diffusers`, `safetensors`). Do not pass `text-classification` here (use `pipelineTag`) |
| `modality` | string | Datasets `filter=modality:{value}` (`text`, `audio`, `image`) |
| `language` | string | Datasets only: `filter=language:{code}` (`zh`, `en`, `ja`). Not a country market |
| `spaceFilter` | string | Spaces `filter=` (`gradio`, `docker`, `streamlit`, `static`) |
| `author` | string | Optional Hub `author=` |
| `sort` | string | `downloads`, `likes`, `createdAt`, `lastModified`. HTML trending = omit sort |
| `maxResults` | integer | Cap emitted rows (schema 1–200) |
| `maxPages` | integer | Hub REST pages via Link cursor, **hard cap 20** |
| `detailUrls` | array | Optional huggingface.co model / dataset / space / tree / paper / collection URLs. `/resolve` and `/inference/models` are rejected |
| `enrichDetails` | boolean | Default **true**. Fetch public `/{author}` profile HTML (name, socials, mailto). Does not invent phones or street addresses |
| `workerBaseUrl` | string | Optional HTTPS override. Production source of truth is Actor env |

Do **not** send `proxyUrl`, cookies, or a Hugging Face token.

Full output schema is on the Dataset tab. Key-value store: `INPUT_ECHO`, `RUN_SUMMARY`, `ERROR_SUMMARY`.

***

### Related Actors

All **81** Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Developer / Open source / AI

- [Hugging Face Scraper](https://apify.com/lentic_clockss/huggingface-scraper)
- [GitHub Scraper](https://apify.com/lentic_clockss/github-scraper)
- [Apple App Store Scraper](https://apify.com/lentic_clockss/apple-app-store-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)
- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Watsons Product Scraper](https://apify.com/lentic_clockss/watsons-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

***

### Changelog

- **0.1.4** — README SEO: Hub API / library keywords, competitor comparison, Related Actors count.
- **0.1.3** — Store README (SEO, How to use, pricing, More Actors, Related Actors). PPE: Actor Start $0.005 + result $3.00/1k with volume tiers. Platform usage paid by developer.
- **0.1.2** — Hub expansion: `filterTags`, dataset `filter=modality:` / `filter=language:`, papers/collections catalog + detail, extra pipeline-tag matrix cells.
- **0.1.1** — First Cloud Run worker pairing; models/datasets/spaces search + detail + files-tree metadata.

# Actor input Schema

## `query` (type: `string`):

Hub search string for models/datasets/spaces. Empty lists the default Hub catalog (not a hardcoded bert canary).

## `searchType` (type: `string`):

Opened: models, datasets, spaces, papers, collections, model, dataset, space, paper, collection, files. enterprise/community/home/login/inference are 未验证. Papers/collections keyword search is ignored by Hub REST.

## `repoId` (type: `string`):

org/name. Required for searchType=model|dataset|space|files unless owner+name is set.

## `owner` (type: `string`):

Optional. Combined with name when repoId is empty.

## `name` (type: `string`):

Optional. Combined with owner when repoId is empty.

## `repoKind` (type: `string`):

For files/detail when the URL is ambiguous. models (default), datasets, or spaces.

## `pipelineTag` (type: `string`):

Models filter. Same key as HTML pipeline\_tag= (e.g. text-generation, text-classification, fill-mask).

## `modality` (type: `string`):

Datasets filter sent as filter=modality:{value} (e.g. text, audio, image). The Hub modality= query key is ignored for audio/image.

## `spaceFilter` (type: `string`):

Spaces list filter. Hub API filter= (e.g. gradio, docker, streamlit, static).

## `filterTags` (type: `array`):

Extra filter= tags such as license:mit, diffusers, safetensors, task\_categories:question-answering. text-classification is remapped to pipelineTag (Hub 400).

## `language` (type: `string`):

Datasets only. Sent as filter=language:{code} (zh, en, ja, ar). Not a country market. Ignored on models.

## `author` (type: `string`):

Optional Hub author= filter.

## `sort` (type: `string`):

downloads, likes, createdAt, lastModified. HTML trending is default Hub order (API sort=trending is 400).

## `maxResults` (type: `integer`):

Cap emitted rows.

## `maxPages` (type: `integer`):

Hub REST pages via Link cursor. Hard cap 20. Do not try to exhaust the catalog.

## `detailUrls` (type: `array`):

Optional huggingface.co model / dataset / space / tree URLs. /resolve blobs and /inference/models are rejected.

## `enrichDetails` (type: `boolean`):

Fetch public /{author} profile HTML (name, socials, mailto). Default on. Does not invent phones or street addresses. Does not stamp press@huggingface.co onto every model row.

## `workerBaseUrl` (type: `string`):

HTTPS only. Production source of truth is Actor env WORKER\_BASE\_URL.

## Actor input object example

```json
{
  "query": "",
  "searchType": "models",
  "repoId": "",
  "owner": "",
  "name": "",
  "repoKind": "",
  "pipelineTag": "",
  "modality": "",
  "spaceFilter": "",
  "language": "",
  "author": "",
  "sort": "",
  "maxResults": 3,
  "maxPages": 1,
  "enrichDetails": true
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset of Hugging Face Hub model / dataset / space / files-tree rows

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "",
    "searchType": "models",
    "repoId": "",
    "owner": "",
    "name": "",
    "repoKind": "",
    "pipelineTag": "",
    "modality": "",
    "spaceFilter": "",
    "language": "",
    "author": "",
    "sort": "",
    "maxResults": 3,
    "maxPages": 1,
    "enrichDetails": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/huggingface-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "",
    "searchType": "models",
    "repoId": "",
    "owner": "",
    "name": "",
    "repoKind": "",
    "pipelineTag": "",
    "modality": "",
    "spaceFilter": "",
    "language": "",
    "author": "",
    "sort": "",
    "maxResults": 3,
    "maxPages": 1,
    "enrichDetails": True,
}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/huggingface-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "",
  "searchType": "models",
  "repoId": "",
  "owner": "",
  "name": "",
  "repoKind": "",
  "pipelineTag": "",
  "modality": "",
  "spaceFilter": "",
  "language": "",
  "author": "",
  "sort": "",
  "maxResults": 3,
  "maxPages": 1,
  "enrichDetails": true
}' |
apify call lentic_clockss/huggingface-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lentic_clockss/huggingface-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/kMHkbosSDQa7C9WPG/builds/U0UpLCslheLrIh3BO/openapi.json