data.attributes.tags to a set of companies. Every tag is added to every selected company. The companies are supplied either as an explicit items array (up to 100 items per request), or as an advanced_search selection that is resolved into companies (up to 100,000) when the job runs. To remove tags, use POST /v1/tags/batch-remove-tags-jobs — adding and removing are separate jobs.summary.failed_count.GET /v1/tags/batch-add-tags-jobs/{job_id}) until status is completed or failed. The job reports summary counts, not the outcome of each company.companies:write OAuth2 scope.X-Api-Key: ********************{
"data": {
"attributes": {
"advanced_search": {
"excluded_company_ids": [
"651713"
],
"filters": {
"items": [
{
"field": "country_code",
"operator": "in",
"type": "filter",
"value": [
"DE"
]
},
{
"field": "employee_count",
"operator": "in_range",
"type": "filter",
"value": {
"gte": 50
}
}
],
"operator": "and",
"type": "group"
},
"page": {
"size": 1000
},
"sort": {
"direction": "desc",
"field": "employee_count"
}
},
"tags": [
{
"id": "dd11fc370098e78e",
"type": "tag"
}
]
},
"type": "batch_add_tags_job"
}
}curl --location 'https://api.leadfeeder.com/v1/tags/batch-add-tags-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"data": {
"attributes": {
"advanced_search": {
"excluded_company_ids": [
"651713"
],
"filters": {
"items": [
{
"field": "country_code",
"operator": "in",
"type": "filter",
"value": [
"DE"
]
},
{
"field": "employee_count",
"operator": "in_range",
"type": "filter",
"value": {
"gte": 50
}
}
],
"operator": "and",
"type": "group"
},
"page": {
"size": 1000
},
"sort": {
"direction": "desc",
"field": "employee_count"
}
},
"tags": [
{
"id": "dd11fc370098e78e",
"type": "tag"
}
]
},
"type": "batch_add_tags_job"
}
}'{
"data": {
"attributes": {
"completed_at": null,
"configuration": {
"items": [
{
"id": "159001425",
"type": "company"
},
{
"id": "159001426",
"type": "company"
}
],
"tags": [
{
"id": "dd11fc370098e78e",
"type": "tag"
},
{
"id": "8bb95c4d8e7c5fd2",
"type": "tag"
}
]
},
"created_at": "2026-05-13T12:00:00Z",
"errors": [],
"status": "running"
},
"id": "job_550e8400-e29b-41d4-a716-446655440000",
"type": "batch_add_tags_job"
},
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}