> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soldfetch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk keyword search

> Read progress and individual outcomes from an SSE stream.

```bash theme={null}
curl --fail-with-body --no-buffer 'https://soldfetch.com/api/bulk-search' \
  -H "Authorization: Bearer $SOLDFETCH_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"keywords":["sony wh-1000xm5","bose quietcomfort"],"count":20}'
```

Submit 1–20 keywords. The server emits SSE `progress`, `result`, `error`, and `complete` events. Parse events individually: HTTP 200 opens the stream and does not guarantee every keyword succeeded. Each successful keyword search consumes one request; failures consume zero.

Set a keyword budget before starting. After a disconnect, do not automatically resubmit the whole batch, which could repeat successful work and consume more quota.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.