Contents

API reference / Competitors

Find a competitor's handles, feed, pricing page and job board from its website

POST /api/v1/competitors/discover

discover_competitor Write

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.

NameTypeDescription
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"}'