curl --request POST \
--url https://api.retriever.run/v1/exclusions/{kind} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domains": [
"stripe.com",
"https://www.salesforce.com"
]
}
'{
"inserted": 1,
"existing": 1,
"invalid": [
{
"value": "not a domain",
"reason": "company_domain_required"
}
]
}{
"error": {
"code": "invalid_request",
"message": "prompt: prompt must not be blank",
"details": [
{
"path": "prompt",
"message": "prompt must not be blank"
}
]
}
}{
"error": {
"code": "not_authenticated",
"message": "A valid API key is required."
}
}{
"error": {
"code": "invalid_request",
"message": "Content-Type must be application/json."
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Retry later."
}
}Exclusions
Ajouter des valeurs (upsert)
1 000 valeurs max par appel. Renvoyer une valeur existante ne fait
rien. Les valeurs invalides sont listées dans invalid sans faire
échouer la requête.
POST
/
v1
/
exclusions
/
{kind}
curl --request POST \
--url https://api.retriever.run/v1/exclusions/{kind} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domains": [
"stripe.com",
"https://www.salesforce.com"
]
}
'{
"inserted": 1,
"existing": 1,
"invalid": [
{
"value": "not a domain",
"reason": "company_domain_required"
}
]
}{
"error": {
"code": "invalid_request",
"message": "prompt: prompt must not be blank",
"details": [
{
"path": "prompt",
"message": "prompt must not be blank"
}
]
}
}{
"error": {
"code": "not_authenticated",
"message": "A valid API key is required."
}
}{
"error": {
"code": "invalid_request",
"message": "Content-Type must be application/json."
}
}{
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded. Retry later."
}
}Authorizations
Clé API ret_live_… créée dans Settings → API keys.
Path Parameters
Available options:
companies, people Body
application/json
- Option 1
- Option 2
Required array length:
1 - 1000 elements