Skip to main content
POST
/
catchAll
/
entities
/
batch
Create entities in batch
curl --request POST \
  --url https://catchall.newscatcherapi.com/catchAll/entities/batch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "entities": [
    {
      "name": "OpenAI",
      "entity_type": "company",
      "description": "Artificial intelligence research company",
      "additional_attributes": {
        "company_attributes": {
          "domain": "openai.com",
          "alternative_names": [
            "Open AI"
          ],
          "key_persons": [
            "Sam Altman"
          ]
        }
      }
    },
    {
      "name": "Stripe",
      "entity_type": "company",
      "description": "Online payment processing platform",
      "additional_attributes": {
        "company_attributes": {
          "domain": "stripe.com",
          "key_persons": [
            "Patrick Collison",
            "John Collison"
          ]
        }
      }
    }
  ]
}
'
{
  "entities": [
    {
      "id": "88430468-d784-485d-84d5-6964a29ccd1e",
      "status": "pending"
    },
    {
      "id": "ad4908fe-6db5-4237-a137-68dd8fc9fedc",
      "status": "pending"
    }
  ],
  "count": 2
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Body

application/json
​
entities
object[]
required

Array of entities to create. Each item follows the same schema as single entity creation.

Minimum array length: 1

Response

Batch of entities created successfully.

​
entities
object[]
required

Array of created entity stubs in the same order as the input.

​
count
integer
required

Total number of entities created.

Example:

3