Create an import
Creates an Import for your own data. Upload the file to the returned uploadUrl before uploadValidUntil, 1 hour after creation. Use an Import to enrich its records, to search within them with scope, or to leave them out of searches with exclude.
Authorizations
Pass your Exa API key in the x-api-key header. You can also authenticate with Authorization: Bearer .
Body
The size of the file in bytes. Maximum size is 50 MB.
x <= 50000000The number of records to import
The file format. The CSV must include a column that identifies each entity, or the import fails.
csv The type of entity each row describes.
- Company
- Person
- Article
- Research Paper
- Custom
The title of the import
Set of key-value pairs you want to associate with this object.
When format is csv, these are the specific import parameters.
Response
Import created successfully
An Import with the URL to upload your file to.
The unique identifier for the Import
The type of object
import The status of the Import
pending, processing, completed, failed, canceled The format of the import.
csv, webset The type of entity the import contains.
- Company
- Person
- Article
- Research Paper
- Custom
The title of the import
The number of entities in the import
Set of key-value pairs you want to associate with this object.
The reason the import failed
invalid_format, invalid_file_content, missing_identifier When the import failed
A human readable message of the import failure
When the import was created
When the import was last updated
The URL to upload the file to
The date and time until the upload URL is valid. The upload URL will be valid for 1 hour.