curl --fail-with-body --max-time 30 "https://api.freshtalent.ai/v1/queries" \
-H "Authorization: Bearer $FRESHTALENT_API_KEY"
const response = await fetch("https://api.freshtalent.ai/v1/queries", {
signal: AbortSignal.timeout(30_000), headers: { Authorization: `Bearer ${process.env.FRESHTALENT_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const body = await response.json();
for (const saved of body.data) console.log(saved.id, saved.name, saved.query);
import json
import os
from urllib.request import Request, urlopen
request = Request(
"https://api.freshtalent.ai/v1/queries",
headers={"Authorization": f"Bearer {os.environ['FRESHTALENT_API_KEY']}"},
)
with urlopen(request, timeout=30) as response:
body = json.load(response)
for saved in body["data"]:
print(saved["id"], saved["name"], saved["query"])
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Palantir FDE leavers",
"query": {
"company": "palantir",
"role_family": "forward-deployed-engineer",
"company_left_min_months_ago": 18,
"open_to_work": true
},
"created_at": "2026-09-07T10:00:00.000Z"
}
],
"meta": {
"count": 1
}
}
List saved queries
Return every saved people-search query for the authenticated organization.
GET
/
queries
curl --fail-with-body --max-time 30 "https://api.freshtalent.ai/v1/queries" \
-H "Authorization: Bearer $FRESHTALENT_API_KEY"
const response = await fetch("https://api.freshtalent.ai/v1/queries", {
signal: AbortSignal.timeout(30_000), headers: { Authorization: `Bearer ${process.env.FRESHTALENT_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const body = await response.json();
for (const saved of body.data) console.log(saved.id, saved.name, saved.query);
import json
import os
from urllib.request import Request, urlopen
request = Request(
"https://api.freshtalent.ai/v1/queries",
headers={"Authorization": f"Bearer {os.environ['FRESHTALENT_API_KEY']}"},
)
with urlopen(request, timeout=30) as response:
body = json.load(response)
for saved in body["data"]:
print(saved["id"], saved["name"], saved["query"])
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Palantir FDE leavers",
"query": {
"company": "palantir",
"role_family": "forward-deployed-engineer",
"company_left_min_months_ago": 18,
"open_to_work": true
},
"created_at": "2026-09-07T10:00:00.000Z"
}
],
"meta": {
"count": 1
}
}
Returns the organization’s saved search records, newest first. Saved queries are organization-scoped; the API key cannot read another organization’s records.
This endpoint has no query parameters and is not paginated. It returns every saved query in
The nested
Next: Save query or Get saved query.
data, with meta.count equal to the array length. There is no cursor, limit, offset, or meta.next.
Response schema
Each item indata has:
| Field | Type | Nullability and meaning |
|---|---|---|
id | string (UUID) | Never null. |
name | string | Never null. |
query | object | Never null. Contains the compacted echoed people-search fields that were accepted when saved. It can be {}. |
created_at | string (ISO 8601 timestamp) | Never null. |
query keys and their types are documented on Save query. null and empty-string values are omitted when a query is saved; missing keys are not returned as null placeholders.
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Palantir FDE leavers",
"query": {
"company": "palantir",
"role_family": "forward-deployed-engineer",
"company_left_min_months_ago": 18,
"open_to_work": true
},
"created_at": "2026-09-07T10:00:00.000Z"
}
],
"meta": {
"count": 1
}
}
curl --fail-with-body --max-time 30 "https://api.freshtalent.ai/v1/queries" \
-H "Authorization: Bearer $FRESHTALENT_API_KEY"
const response = await fetch("https://api.freshtalent.ai/v1/queries", {
signal: AbortSignal.timeout(30_000), headers: { Authorization: `Bearer ${process.env.FRESHTALENT_API_KEY}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const body = await response.json();
for (const saved of body.data) console.log(saved.id, saved.name, saved.query);
import json
import os
from urllib.request import Request, urlopen
request = Request(
"https://api.freshtalent.ai/v1/queries",
headers={"Authorization": f"Bearer {os.environ['FRESHTALENT_API_KEY']}"},
)
with urlopen(request, timeout=30) as response:
body = json.load(response)
for saved in body["data"]:
print(saved["id"], saved["name"], saved["query"])
Errors and recovery
400(invalid_request): when using the platform API key, provide a validX-FreshTalent-Org-IdUUID.401(unauthorized): provide a valid API key.402(payment_required): restore the organization’s entitlement.429or5xx: retry with backoff. The read is safe to repeat.
Related
| Method | Path | Purpose |
|---|---|---|
POST | /queries | Save query |
GET | /queries/:id | Get saved query |
DELETE | /queries/:id | Delete a saved query; returns 204. |