Your first API request

Bring company intelligence into your own tools. Read company profiles, find jobs, and retrieve research with a single API key.

export FDE_API_KEY="YOUR_API_KEY"

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/me"

{
  "data": {
    "type": "user",
    "userId": "user_example",
    "email": null,
    "name": null,
    "organizationId": "org_example"
  }
}

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/companies?limit=5"

Get started

Authentication

Every endpoint in this reference requires an API key. Send it in one of these headers on each request:

X-Api-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Keep the key on your server or in a secret manager. Do not put it in a query string, commit it to source control, or embed it in a public website.

Both key types can read the catalog endpoints below. List management requires a personal key. Set an expiry of 7, 30, 90, or 365 days when creating a key (default: 90 days). Revoke a key from your account when you no longer need it. Expired or revoked keys return 401.

Get started

Pagination & filtering

Company and job lists return a data array and a meta object. Single-record endpoints return an object under data. JSON field names use camelCase; query parameters use the names listed in each endpoint.

{
  "data": [],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 0,
    "totalPages": 0
  }
}

Pages start at 1. Companies default to 50 items per page (maximum 100); jobs default to 20 (maximum 50). Missing, nonnumeric, zero, or negative pagination values fall back to the defaults.

A page cannot start at or beyond result 1001. Deeper requests return 400 RESULT_WINDOW_EXCEEDED. Search queries return at most 100 matches. Narrow your filters instead of continuing beyond these limits.

Use --data-urlencode with cURL to safely encode filter values. For example, find remote engineering roles:

curl --fail-with-body --get \
  -H "X-Api-Key: $FDE_API_KEY" \
  --data-urlencode "role_category=engineering" \
  --data-urlencode "remote_only=true" \
  --data-urlencode "limit=10" \
  "https://www.enterpriseaitrends.com/api/v1/jobs"

Get started

Rate limits

The API allows 100 requests per minute. Personal keys share a request budget per user; organization keys have a budget per key. When that budget is exhausted, requests return 429 RATE_LIMITED.

Cache responses where practical and avoid tight retry loops. Key verification also has a shared limit of 600 checks per minute per key across services; exceeding it can return 401. If a valid key starts failing during a burst of requests, pause for a minute before trying again.

Get started

Errors

Check the HTTP status before reading data. API errors use an error object with a stable code and a human-readable message.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid, expired or revoked API key"
  }
}

Check your identity

Check which organization your key belongs to. This is a useful first request when setting up an integration or troubleshooting a key.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/me"

{
  "data": {
    "type": "user",
    "userId": "user_example",
    "email": null,
    "name": null,
    "organizationId": "org_example"
  }
}

List companies

Browse active, visible companies or find companies by search and classification tags. Without a search term, results are ordered by active job count, profile completeness, then name.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/companies?limit=1"

{
  "data": [
    {
      "id": "3c123740-3ef5-4d1e-b701-08a8f2d30a12",
      "name": "Example AI",
      "slug": "example-ai",
      "domain": "example.com",
      "website": "https://example.com",
      "logoUrl": null,
      "headcountRange": "11-50",
      "description": "Tools for building AI applications.",
      "hqLocation": "New York, NY",
      "totalFunding": null,
      "latestValuation": null,
      "annualRevenue": null,
      "sourceKind": null,
      "sourcePlatform": null,
      "sourceUrl": null,
      "activeJobCount": 1,
      "tags": []
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

Get a company

Retrieve a company’s profile, classification tags, and job count. Use an id or slug returned by the company list.

Set COMPANY_ID to a value from the corresponding list response before running this request.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/companies/$COMPANY_ID"

{
  "data": {
    "id": "3c123740-3ef5-4d1e-b701-08a8f2d30a12",
    "name": "Example AI",
    "slug": "example-ai",
    "domain": "example.com",
    "website": "https://example.com",
    "logoUrl": null,
    "headcountRange": "11-50",
    "description": "Tools for building AI applications.",
    "hqLocation": "New York, NY",
    "totalFunding": null,
    "latestValuation": null,
    "annualRevenue": null,
    "sourceKind": null,
    "sourcePlatform": null,
    "sourceUrl": null,
    "activeJobCount": 1,
    "tags": [],
    "oneLiner": "Tools for AI developers.",
    "keyInvestors": null,
    "linkedinUrl": null,
    "careersUrl": "https://example.com/careers",
    "enrichmentUpdatedAt": null,
    "lastRunAt": null
  }
}

List jobs

Find active jobs at visible companies. Without a search term, the most recently observed new jobs come first. Combine filters to narrow the results.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/jobs?limit=1"

{
  "data": [
    {
      "id": "b17ff1e4-90fc-4a15-b659-521d0773a2b1",
      "title": "Software Engineer",
      "roleCategory": "engineering",
      "department": "Engineering",
      "location": "New York, NY",
      "remotePolicy": "hybrid",
      "salaryMin": null,
      "salaryMax": null,
      "salaryCurrency": "USD",
      "applyUrl": "https://example.com/careers/engineer",
      "firstSeenAt": "2026-09-01T12:00:00.000Z",
      "lastSeenAt": "2026-09-08T12:00:00.000Z",
      "companyName": "Example AI",
      "companySlug": "example-ai",
      "companyLogoUrl": null,
      "companyDomain": "example.com",
      "companyDescription": "Tools for building AI applications.",
      "companyHqLocation": "New York, NY",
      "companyTotalFunding": null
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

Get a job

Retrieve a job’s description and application URL. Check status before displaying the listing: a saved job can still be returned after it is no longer active.

Set JOB_ID to a value from the corresponding list response before running this request.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/jobs/$JOB_ID"

{
  "data": {
    "id": "b17ff1e4-90fc-4a15-b659-521d0773a2b1",
    "title": "Software Engineer",
    "roleCategory": "engineering",
    "department": "Engineering",
    "location": "New York, NY",
    "remotePolicy": "hybrid",
    "salaryMin": null,
    "salaryMax": null,
    "salaryCurrency": "USD",
    "applyUrl": "https://example.com/careers/engineer",
    "firstSeenAt": "2026-09-01T12:00:00.000Z",
    "lastSeenAt": "2026-09-08T12:00:00.000Z",
    "description": "Build tools for AI developers.",
    "status": "active",
    "companyName": "Example AI",
    "companySlug": "example-ai",
    "companyLogoUrl": null,
    "companyWebsite": "https://example.com"
  }
}

List classification tags

Get the available classification labels, grouped by dimension. Use the slug rather than the display value when filtering companies. No parameters are required.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/tags"

{
  "data": {
    "market": [
      {
        "value": "Healthcare",
        "slug": "healthcare"
      }
    ],
    "funding_stage": [
      {
        "value": "Series A",
        "slug": "series-a"
      }
    ]
  }
}

Get catalog statistics

Get a snapshot of the catalog’s job and company counts. No parameters are required.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/stats"

{
  "data": {
    "totalJobs": 1250,
    "totalCompanies": 240,
    "newToday": 32
  }
}

Get company research

Read a company’s existing research report, including its market, products, people, and funding. Coverage varies by company; this request does not generate a new report.

Set COMPANY_DOMAIN to a value from the corresponding list response before running this request.

curl --fail-with-body \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/v1/deep-research/$COMPANY_DOMAIN"

{
  "data": {
    "company": {
      "id": "3c123740-3ef5-4d1e-b701-08a8f2d30a12",
      "name": "Example AI",
      "domain": "example.com",
      "slug": "example-ai"
    },
    "research": {
      "summary": "Tools for building AI applications.",
      "oneLiner": null,
      "foundedYear": null,
      "hqCity": null,
      "hqState": null,
      "hqCountry": null,
      "employeeCount": null,
      "businessModel": null,
      "founders": null,
      "leadership": null,
      "marketAnalysis": null,
      "targetCustomers": null,
      "keyProducts": null,
      "recentNews": null,
      "competitors": null,
      "techStack": null,
      "fundingRounds": null,
      "notableCustomers": null,
      "markdownReport": "# Example AI\n\nTools for building AI applications.",
      "screenshotUrl": null,
      "processorTier": "base",
      "lastFullResearchAt": "2026-09-01T12:00:00.000Z",
      "lastFastResearchAt": null,
      "enrichedAt": "2026-09-01T12:00:00.000Z"
    }
  }
}

API reference · Personal keys

Manage company lists

Group companies into named lists for research, job hunting, or a report about the companies you follow. These endpoints use /api/lists, outside the catalog’s /api/v1 base path.

Every JSON read and write is owner-only, including for public lists. Public visibility makes the website page at /lists/{slug} shareable; it does not grant other API callers access. Website sessions can use these endpoints too; session writes require a matching Origin header.

Set FDE_API_KEY to your personal key. After creating a list, set LIST_ID to its returned UUID. Set COMPANY_ID to a UUID from the catalog’s company list.

curl --fail-with-body -X GET \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists"

{
  "data": [
    {
      "id": "db113740-3ef5-4d1e-b701-08a8f2d30a12",
      "name": "AI infrastructure",
      "slug": "ai-infrastructure-a94c12",
      "description": "Companies to follow",
      "visibility": "private",
      "isDefault": false,
      "itemCount": 1,
      "createdAt": "2026-09-08T12:00:00.000Z",
      "updatedAt": "2026-09-08T12:00:00.000Z"
    }
  ]
}

curl --fail-with-body -X POST \
  -H "X-Api-Key: $FDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"AI infrastructure","description":"Companies to follow","visibility":"private"}' \
  "https://www.enterpriseaitrends.com/api/lists"

curl --fail-with-body -X GET \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID"

{
  "data": {
    "id": "db113740-3ef5-4d1e-b701-08a8f2d30a12",
    "name": "AI infrastructure",
    "slug": "ai-infrastructure-a94c12",
    "description": "Companies to follow",
    "visibility": "private",
    "isDefault": false,
    "itemCount": 1,
    "createdAt": "2026-09-08T12:00:00.000Z",
    "updatedAt": "2026-09-08T12:00:00.000Z"
  }
}

curl --fail-with-body -X PATCH \
  -H "X-Api-Key: $FDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Companies to research","description":null}' \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID"

curl --fail-with-body -X DELETE \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID"

curl --fail-with-body -X PUT \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID/items/$COMPANY_ID"

{
  "data": {
    "listId": "db113740-3ef5-4d1e-b701-08a8f2d30a12",
    "companyId": "3c123740-3ef5-4d1e-b701-08a8f2d30a12",
    "added": true
  }
}

curl --fail-with-body -X DELETE \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID/items/$COMPANY_ID"

curl --fail-with-body -X POST \
  -H "X-Api-Key: $FDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"companyId":"3c123740-3ef5-4d1e-b701-08a8f2d30a12","saved":true}' \
  "https://www.enterpriseaitrends.com/api/lists/save"

{
  "data": {
    "listId": "db113740-3ef5-4d1e-b701-08a8f2d30a12",
    "listSlug": "saved-a94c12",
    "saved": true
  }
}

curl --fail-with-body -X GET \
  -H "X-Api-Key: $FDE_API_KEY" \
  "https://www.enterpriseaitrends.com/api/lists/$LIST_ID/items?page=1&limit=50"

{
  "data": [
    {
      "id": "3c123740-3ef5-4d1e-b701-08a8f2d30a12",
      "name": "Example AI",
      "slug": "example-ai",
      "domain": "example.com",
      "website": "https://example.com",
      "logoUrl": null,
      "description": "Tools for AI developers.",
      "oneLiner": null,
      "hqLocation": null,
      "totalFunding": null,
      "latestValuation": null,
      "headcountRange": null,
      "activeJobCount": 1,
      "addedAt": "2026-09-08T12:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

List response fields

List metadata includes id, name, slug, description (string or null), visibility (private or public), isDefault (boolean), and ISO 8601 createdAt and updatedAt timestamps. List and detail reads include itemCount; create and update responses instead include the owner’s userId.

Member records include company identity, website and profile fields, activeJobCount (number), and addedAt (ISO 8601). Profile facts may be null; funding and valuation are display strings rather than numeric amounts.

Limits and errors

All successful list operations return HTTP 200 with a data value. Errors use { error: { code, message } }. List responses are not cached.

List endpoints share a separate budget of 100 requests per 60-second window per user, across personal keys and sessions. The budget is shared across server instances. Read X-RateLimit-Limit and X-RateLimit-Remaining; 429 responses also include Retry-After. Authentication and origin failures occur before this budget is charged.