Find a competitor's handles, feed, pricing page and job board from its website
POST /api/v1/competitors/discover
Reads the competitor's home page (and its careers page when needed) and returns what the tracking can use: name, social handles, a blog or changelog feed, the pricing page, a job board and search phrases that find people shopping around. Nothing is saved: pass what you keep to create_competitor. No AI is used.
A full-access key (ss_sk_…), or an editor or owner signed in.
Request body
JSON, sent with Content-Type: application/json.
| Name | Type | Description |
|---|---|---|
url required |
string 3–300 characters |
The competitor's website, e.g. fernbill.com. |
Example
curl -X POST "https://sniffington.com/api/v1/competitors/discover" \
-H "Authorization: Bearer $SCOUT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/hooks/social-scout"}'