How to Use Imports

# Step 1: Create a CSV import with your supplier URLs
curl -X POST "https://api.exa.ai/websets/v0/imports" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "csv",
    "count": 5,
    "size": 128,
    "entity": { "type": "company" },
    "title": "IT Consulting Suppliers"
  }'
# Response includes an `uploadUrl` and an import `id`

# Step 2: Upload your CSV to the presigned URL from Step 1
curl -X PUT "<UPLOAD_URL>" \
  -H "Content-Type: text/csv" \
  --data-binary @suppliers.csv
# suppliers.csv contains: url\nhttps://www.accenture.com\nhttps://www.infosys.com\n...

# Step 3: Create a Webset that uses this import (enrichments only, no search/criteria)
# The import is automatically scheduled for processing when the Webset is created.
curl -X POST "https://api.exa.ai/websets/v0/websets" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "import": [
      { "source": "import", "id": "<IMPORT_ID>" }
    ],
    "enrichments": [
      { "description": "What services does this company provide?", "format": "text" },
      { "description": "Number of employees", "format": "number" }
    ]
  }'

curl -X POST "https://api.exa.ai/websets/v0/websets" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "query": "IT consulting and staff augmentation companies",
      "entity": { "type": "company" },
      "criteria": [
        { "description": "The company has an office in the United States" },
        { "description": "The company provides IT consulting or staff augmentation services" }
      ],
      "count": 25
    },
    "enrichments": [
      { "description": "What services does this company provide?", "format": "text" },
      { "description": "Number of employees", "format": "number" }
    ]
  }'

# Step 1: Create a CSV import and upload it (same as Config 1, Steps 1-2)
# ... (see Config 1 for the full import flow)
# You'll get back an <IMPORT_ID>

# Step 2: Create a Webset with a scoped search -- evaluates each imported URL against criteria
# The import is automatically scheduled for processing when the Webset is created.
curl -X POST "https://api.exa.ai/websets/v0/websets" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "query": "IT consulting and staff augmentation companies",
      "entity": { "type": "company" },
      "criteria": [
        { "description": "The company has an office in the United States" },
        { "description": "The company provides IT consulting or staff augmentation services" }
      ],
      "count": 25,
      "scope": [
        { "source": "import", "id": "<IMPORT_ID>" }
      ]
    },
    "enrichments": [
      { "description": "What services does this company provide?", "format": "text" },
      { "description": "Number of employees", "format": "number" }
    ]
  }'

# Step 1: Create a CSV import and upload it (same as Config 1, Steps 1-2)
# ... (see Config 1 for the full import flow)
# You'll get back an <IMPORT_ID>

# Step 2: Create a Webset with a scoped search -- evaluates each imported URL against criteria
# The import is automatically scheduled for processing when the Webset is created.
curl -X POST "https://api.exa.ai/websets/v0/websets" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "search": {
      "query": "IT consulting and staff augmentation companies",
      "entity": { "type": "company" },
      "criteria": [
        { "description": "The company has an office in the United States" },
        { "description": "The company provides IT consulting or staff augmentation services" }
      ],
      "count": 25,
      "scope": [
        { "source": "import", "id": "<IMPORT_ID>" }
      ]
    },
    "enrichments": [
      { "description": "What services does this company provide?", "format": "text" },
      { "description": "Number of employees", "format": "number" }
    ]
  }'
# Response includes a webset `id` -- save it as <WEBSET_ID>

# Step 3: Wait for the scoped search to complete, then add a web search to discover new matches
curl -X POST "https://api.exa.ai/websets/v0/websets/<WEBSET_ID>/searches" \
  -H "x-api-key: $EXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "IT consulting and staff augmentation companies",
    "entity": { "type": "company" },
    "criteria": [
      { "description": "The company has an office in the United States" },
      { "description": "The company provides IT consulting or staff augmentation services" }
    ],
    "count": 25,
    "behavior": "append"
  }'