Skip to content
Quickstart

Quickstart

Identify your first accounts

Evident identifies the companies behind visitor IPs. There are three ways to send it data — pick the one that matches how quickly you need results and how much code you can drop in.

Path Best for Time to first result What you need
CSV upload Trying Evident today with a snapshot of past traffic 5 minutes An exported CSV of visitor IPs
REST API Any existing server or data pipeline 15 minutes Server-side code + an API key
Next.js middleware Real-time identification on a website you run 15 minutes A Next.js app + an API key

The rest of this quickstart walks through CSV upload — the zero-code path that gets you to an identified-accounts view fastest. Once you’ve seen the shape of the data, the API and Next.js paths give you the same enrichment continuously.

What you need

  • An Evident account
  • A CSV file with a column named ip_address containing up to 200 unique IP addresses

You can export IP addresses from Google Analytics, your web server logs, or any analytics tool that captures raw visitor IPs.

Steps

  1. Sign in to your Evident account at app.useevident.com.
  2. Go to the Data page from the main navigation.
  3. Click “Upload CSV” and select your file. The file must have an ip_address column header. Additional columns are passed through unchanged in the output.
  4. Confirm the job is queued. You will see the job appear in the job history with a status of Queued.
  5. Wait for processing to complete. Free accounts process one job at a time. Paid accounts process up to three concurrently. Processing time depends on the number of unique IPs.
  6. Download the enriched file or explore results directly in the UI. Each row now includes company name, domain, industry, country, confidence score, and infrastructure flags.
  7. Go to the Accounts page to see the same data aggregated at the company level, with event counts and trend indicators.

Next steps

CSV upload is a one-time snapshot. For ongoing visitor intelligence, connect a source that keeps sending data:

  • Next.js middleware — a ~15-line middleware.ts file identifies visitors in real time as they hit your site. Accounts appear within seconds of a visit.
  • REST API — enrich IPs and stream events from any server-side code or data pipeline.
  • Connect Amplitude — sync product events automatically every day (or on demand).

Generate an API key from Settings → API Keys to unlock the API and Next.js paths.

Need help getting started? Reach out to the Evident team.

Changelog