# Web and social media scrapers in SmallForce

SmallForce Scrapers provides a curated catalog for web and social research. Search the catalog by intent, inspect the scraper’s current input schema, submit a run, and retrieve its structured result items after completion.

```bash
smallforce scrapers search "Instagram reels" --json
smallforce scrapers run <scraperId> \
  --input '<json-built-from-the-scraper-schema>' \
  --max-credits 20 \
  --json
```

Runs are asynchronous. Use the returned SmallForce run ID to check status and retrieve items:

```bash
smallforce scrapers runs get <runId> --json
smallforce scrapers runs items <runId> --json
```

`--max-credits` creates a hard ceiling for the run. SmallForce reserves that amount before submission and settles it against the actual cost.

Use scrapers only for authorized purposes and handle personal or platform data according to applicable terms and law. Source media URLs may be temporary, so process required files promptly instead of treating external URLs as permanent storage.

See the complete [`smallforce scrapers` reference](/docs/cli/commands/scrapers).