Create import

Create a new data import job to import mentions into a topic.

Maximum 100,000 mentions per import. If items contain a large amount of data (such as lengthy text content), you may receive a 413 (Content Too Large) error. In this case, try splitting your batch into smaller ones.

Each mention must have:

• A valid URL (required) — must be an absolute HTTP or HTTPS URL. If you want to import an item without a URL, you should still create a fake unique-per-topic URL (https://mysite.com/1)
• A published date (required) — cannot be empty
• At least one content field: title, text, or imageUrl

Processing:

• Mentions are processed asynchronously after the import is created
• Use the Get Import Status endpoint to track progress
• Failed mentions can be retrieved using the Get Import Errors endpoint
• Duplicate mentions (same URL) will be rejected with error code "Duplicate"