Get Started
Authentication
How to authenticate with the Parsew API.
All Parsew Extract API requests require a secret API key (sr_ prefix).
Getting your API key
- Sign up at parsew.com
- Create an organization in the dashboard
- Navigate to Settings > API Keys
- Create a new secret key
Using your key
Pass the key in the Authorization header:
curl -X POST https://api.parsew.com/v1/scrape \
-H "Authorization: Bearer sr_your_secret_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'Or use the SDK which handles this automatically:
import { Parsew } from '@parsew/sdk/server'
const parsew = new Parsew({
apiKey: 'sr_your_secret_key',
})For Parsew Brands (logo API), use a publishable key:
import { ParsewBrands } from '@parsew/sdk/client'
const brands = new ParsewBrands({
token: 'pk_your_publishable_key',
})Key types
| Prefix | Type | Use case |
|---|---|---|
sr_ | Secret key | Server-side API access (Extract, Scrape, Map, Brand) |
pk_ | Publishable key | Client-side logo embeds (Parsew Brands) |
Never expose sr_ keys in client-side code. They grant full API access.
Quickstart
Get up and running with Parsew in under 5 minutes.
Extract branding profile POST
Analyze a website and extract its complete branding profile — colors, typography, images, components, spacing, personality, and design system. Requesting only `colors` and/or `images` uses heuristic extraction (2 credits). Full analysis costs 5 credits.