Parse a target
Parse a target without fetching anything, and see what a lookup would do with it: which kind it is, which page the search would start from, and which stages it would run. The right first step for a list of pasted targets — it normalises and sorts them, and shows what each would cost in effort, before a single lookup is spent. **Free.** It makes no upstream request at all, answers in about a tenth of a second, and reports `pagesFetched: 0`.
/resolve-target Utilities https://api.fetchlayer.dev/email-finder/resolve-target Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
target string required Any website, social profile URL or YouTube channel to parse.
format string optional Envelope format: json or markdown. (default: json)
Response Fields
resolve-target
Parse a target
transport string The source. "public-web".
notes string[] Caveats you can act on, in plain language: which stages were checked and found nothing, that an address came from somewhere other than the target's own pages, or that a stage could not be finished in the time available.
pagesFetched number What the request is billed at: 1 on every completed lookup, including a NO_EMAIL_LISTED; 0 on /resolve-target. It is a billing figure, not a crawl size — that is `pagesCrawled`.
input string The target exactly as you sent it.
normalizedInput string The target after normalisation.
targetKind string What the target was taken to be: website, social, youtube.
resolvedUrl string The page the search started from. For a YouTube channel this is its /about page.
wouldSearch string[] The stages a lookup would run for this target, in order. A longer list is a longer lookup.
Request
curl -X POST "https://api.fetchlayer.dev/email-finder/resolve-target" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"target":"https://x.com/naval"}'Response
{
"transport": "public-web",
"notes": [],
"pagesFetched": 0,
"input": "https://x.com/naval",
"normalizedInput": "https://x.com/naval",
"targetKind": "social",
"resolvedUrl": "https://x.com/naval",
"wouldSearch": [
"landing-page",
"website-pages",
"linked-social-profiles",
"web-search"
]
}