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

MCP

Search jobs and explore companies from your AI assistant. The Model Context Protocol (MCP) gives your assistant tools to read live Enterprise AI Trends data as you chat.

https://mcp.enterpriseaitrends.com/mcp

Connect with browser sign-in

Add the hosted URL to your AI client, sign in to Enterprise AI Trends, choose your organization, and approve the requested access. Return to your client when authorization completes. No API key is needed.

Claude Code

claude mcp add --transport http --scope user enterprise-ai-trends https://mcp.enterpriseaitrends.com/mcp

Open /mcp in Claude Code, select Enterprise AI Trends, and follow the browser sign-in instructions.

Codex

[mcp_servers.enterprise-ai-trends]
url = "https://mcp.enterpriseaitrends.com/mcp"

codex mcp login enterprise-ai-trends

When moving from API keys, remove this server’s existing authentication header or bearer_token_env_var setting so the client can use OAuth.

Claude and ChatGPT

In your client’s custom connector or MCP app settings, add the hosted URL above and choose OAuth if asked. Follow the browser sign-in and approval flow, then enable the connection in your conversation. Custom connections depend on your client’s plan and workspace permissions; ChatGPT may require developer mode and administrator approval.

The client stores your access and refresh tokens. Access tokens last 10 minutes; refresh tokens last up to 30 days and rotate on use. Revoking a refresh token prevents further refreshes; an already issued access token can remain valid until it expires. Removing organization membership stops catalog access when the backing API next checks it.

Optional: connect with an API key

API keys remain available for scripts and clients that support custom headers. Choose either OAuth or an API key for a connection.

1. Create your key

Sign in to your account, create or select an organization, and create a personal API key. Copy it when it appears, then set it in your terminal:

export FDE_API_KEY="YOUR_API_KEY"

Send API keys in X-Api-Key. OAuth access tokens use an Authorization: Bearer header. Keep your key out of chat messages and shared configuration files.

2. Connect Claude Code or Codex

Claude Code

Run this command in the terminal where you set your key:

claude mcp add --transport http --scope user enterprise-ai-trends https://mcp.enterpriseaitrends.com/mcp \
  --header "X-Api-Key: $FDE_API_KEY"

Open Claude Code and use /mcp to check the connection. This command saves the expanded key in your local user configuration. See the Claude Code MCP guide.

Codex

Add this entry to ~/.codex/config.toml:

[mcp_servers.enterprise-ai-trends]
url = "https://mcp.enterpriseaitrends.com/mcp"
env_http_headers = { "X-Api-Key" = "FDE_API_KEY" }

Start Codex from the terminal where FDE_API_KEY is set. The Codex app also needs that variable in its own environment. See the Codex MCP guide.

3. Try a prompt

Use Enterprise AI Trends to find remote forward-deployed engineering jobs (role_category: "fde"). Read the descriptions for three relevant roles and show their requirements, company profiles, and application links.

You can also ask: “Which company classifications are available?” or “Look up Anthropic and show its active roles.”

Search tools default to cursor pagination. Continue using meta.nextCursor with the same filters and limit until hasMore is false. Sessions expire after 15 minutes; start a new search after expiry. Supplying page selects legacy page mode. Counts in cursor mode describe visible snapshot candidates, not every relevant job. These tools read catalog data. Keyword and conceptual searches return a ranked selection, not every possible match. The response metadata states the count scope, whether completeness is known, and whether another page is available. Company list management and research report endpoints remain available through the REST API; they are not exposed as MCP tools yet.

Client setup references: ChatGPT, Codex, and Claude Code.

Discover filters before searching

Call list_job_categories, then pass a returned id to search_jobs as role_category. Call list_tags, then pass a returned slug to list_companies, for example market: "healthcare". Multiple slugs within a dimension use OR; dimensions combine with AND. For job search, pass employer tags under company_filters; keep job categories in role_category. These tools return the complete supported vocabulary, not counts or a guarantee of matching records.

{
  "role_category": "fde",
  "company_filters": {
    "market": [
      "healthcare"
    ]
  },
  "pagination": "cursor"
}

This requires the employer’s stored healthcare classification. Adding a search phrase ranks matching jobs by their content; it does not replace the employer tag requirement or infer a missing classification.

Use get_account_info when you need account or request-budget information; no identity preflight is needed before searches. Each tool operation consumes one API request. Protocol authentication does not consume the catalog budget, though API-key provider abuse limits still apply. Budgets are per API instance, not billing credits. On RATE_LIMITED, wait for retryAfter; reconnecting is not a remedy. Disconnecting does not revoke your OAuth grant. Manage or revoke connections in Account settings → Connected apps. Revoking a grant stops future refreshes; an issued access token may remain valid until its ten-minute expiry. Membership removal is checked on subsequent backend requests.

Interpret remote roles and counts

A listing with remotePolicy: "remote" and location “Remote — United States only” passes remote_only. It does not establish eligibility outside the US. Read the source location and full description; structured geographic eligibility remains unknown. Company headquarters do not establish work eligibility.

role_category: "fde" selects FDE roles alone. client_facing: true also includes solutions engineering, customer success, technical account management, sales, and other adjacent categories. FDE counts are included in that broader group. Stats describe active visible catalog records at the stated time, not all jobs worldwide.

Troubleshooting

A 401 Unauthorized response means you should check that your key is present, unexpired, and not revoked. For Codex, check that its process can read FDE_API_KEY. For OAuth, reconnect if authorization expired or was revoked. If browser sign-in is unavailable during rollout, use the optional API-key setup. For rate-limit errors, pause before retrying; see rate limits.

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.

For stable traversal, start with pagination=cursor. Continue with meta.nextCursor as the cursorparameter, repeating the same filters and limit, until hasMore=false. Do not send a page number. Sessions expire after 15 minutes (410); malformed or mismatched cursors return 400. Restart without a cursor after expiry.

Cursor sessions freeze candidate membership and order. New matches appear in a new session; returned fields stay current, and hidden, deleted, or inactive records are skipped. Updates do not rerank or reapply the original filters. Counts cover visible snapshot candidates; search caps and unknown completeness still apply. Legacy page mode can shift when data changes; totalPages covers only accessible pages.

{
  "data": [],
  "meta": {
    "pagination": "page",
    "nextCursor": null,
    "page": 1,
    "limit": 20,
    "total": 0,
    "totalPages": 0,
    "totalScope": "filtered_catalog",
    "searchMode": "filter",
    "totalMatches": 0,
    "totalRelation": "exact",
    "truncated": false,
    "accessibleTotal": 0,
    "accessibleTotalPages": 0,
    "hasMore": false,
    "resultWindow": 1000,
    "searchLimit": null,
    "correctedQuery": null
  }
}

Pages start at 1. Companies default to 50 items per page (maximum 100); jobs default to 20 (maximum 50). Missing values use defaults. Invalid, repeated, zero, negative, or out-of-range values return 400.

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"
  }
}

Account and request budget

Read your credential identity, organization, capabilities, and remaining request budget. Call when needed; other endpoints authenticate independently. This request consumes one API unit.

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, provided neither the job nor its company is hidden.

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"
      }
    ]
  }
}

Discover job categories

Complete supported job category vocabulary. No parameters, pagination, or job counts. No metadata backfill is required.

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

{
  "data": [
    {
      "id": "fde",
      "label": "Forward-Deployed Engineer",
      "description": "Engineering deployed directly with customers to integrate and deliver solutions.",
      "clientFacing": true
    },
    {
      "id": "solutions_engineer",
      "label": "Solutions Engineer",
      "description": "Technical solution design and architecture for customer needs.",
      "clientFacing": true
    },
    {
      "id": "csm",
      "label": "Customer Success Manager",
      "description": "Customer adoption, success, and ongoing relationship management.",
      "clientFacing": true
    },
    {
      "id": "tam",
      "label": "Technical Account Manager",
      "description": "Technical account ownership and ongoing customer guidance.",
      "clientFacing": true
    },
    {
      "id": "sales_engineer",
      "label": "Sales Engineer",
      "description": "Technical presales, demonstrations, and sales support.",
      "clientFacing": true
    },
    {
      "id": "implementation",
      "label": "Implementation Engineer",
      "description": "Customer onboarding, implementation, and integration delivery.",
      "clientFacing": true
    },
    {
      "id": "professional_services",
      "label": "Professional Services",
      "description": "Consulting and professional service delivery for customers.",
      "clientFacing": true
    },
    {
      "id": "sales",
      "label": "Sales",
      "description": "Sales, account development, business development, and partnerships.",
      "clientFacing": true
    },
    {
      "id": "engineering",
      "label": "Engineering",
      "description": "Software, infrastructure, hardware, and other engineering roles.",
      "clientFacing": false
    },
    {
      "id": "product",
      "label": "Product",
      "description": "Product management and product strategy.",
      "clientFacing": false
    },
    {
      "id": "design",
      "label": "Design",
      "description": "Product, user experience, and other design roles.",
      "clientFacing": false
    },
    {
      "id": "marketing",
      "label": "Marketing",
      "description": "Marketing, communications, and growth.",
      "clientFacing": false
    },
    {
      "id": "data",
      "label": "Data & Analytics",
      "description": "Data science, analytics, and related data roles.",
      "clientFacing": false
    },
    {
      "id": "operations",
      "label": "Operations",
      "description": "Business operations and operational support.",
      "clientFacing": false
    },
    {
      "id": "finance",
      "label": "Finance",
      "description": "Finance and accounting.",
      "clientFacing": false
    },
    {
      "id": "hr",
      "label": "HR & Recruiting",
      "description": "Human resources, recruiting, and people operations.",
      "clientFacing": false
    },
    {
      "id": "legal",
      "label": "Legal",
      "description": "Legal and compliance roles.",
      "clientFacing": false
    },
    {
      "id": "other",
      "label": "Other",
      "description": "Classified roles outside the named categories; not an alias for missing classification.",
      "clientFacing": false
    }
  ],
  "meta": {
    "jobContext": {
      "remotePolicyValues": [
        "remote",
        "hybrid",
        "onsite",
        "unknown"
      ],
      "remoteOnly": "remote_only=true matches remotePolicy=remote exactly; excludes hybrid, onsite and unknown. It does not establish worldwide eligibility.",
      "location": "Source listing text; location filtering is a case-insensitive substring match, not a geographic eligibility test.",
      "eligibility": "Structured work eligibility is not available. Review sourceLocationText, the full job description and applyUrl for country, residency, work authorization or visa restrictions. Do not infer eligibility from remote policy or company headquarters.",
      "classification": "roleCategory is the catalog classification, not an employer-certified label. Null means unclassified; other is a classified catch-all. classificationVersion may be null for legacy records; no confidence score is available.",
      "freshness": "firstSeenAt is catalog discovery time; lastSeenAt is last observed time, not employer publication time or a guarantee the job is still open.",
      "roleGroups": "FDE is only role_category=fde. client_facing=true includes FDE and adjacent customer-facing categories; an explicit role_category overrides that group."
    },
    "version": "job-categories-v1",
    "complete": true,
    "scope": "supported_vocabulary",
    "filterParameter": "role_category",
    "filterSemantics": "Exact category identifier. An explicit role_category takes precedence over client_facing=true. Omit both to include unclassified jobs; missing classification is not other."
  }
}

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,
    "jobsFirstSeenLast24Hours": 32,
    "asOf": "2026-09-22T12:00:00.000Z",
    "discoveryWindow": {
      "from": "2026-09-21T12:00:00.000Z",
      "before": "2026-09-22T12:00:00.000Z",
      "timezone": "UTC",
      "statusScope": "all",
      "visibilityScope": "visible_jobs_and_employers"
    }
  }
}

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.