canonical: https://jentic.com/apis/neugeschaeft.de/neugeschaeft

# Neugeschaeft De neugeschaeft REST-API

The neugeschaeft REST-API provides programmatic access to a business database of roughly 11 million company records across the DACH region. It searches companies with detailed or selection-list results, exports selected records with fill-rate statistics, and builds and shares company lists. It also monitors lists for changes and runs data-match projects that reconcile your own records against the database.

## For AI agents

Search roughly 11 million DACH company records, export selected records, build and monitor company lists, and run data-match reconciliation projects.

## Scope

Does not handle payments, email outreach, or CRM pipeline management. Use for company data search, export, and matching only.

## Capabilities

- Search roughly 11 million DACH company records with detailed or selection-list results
- Export selected company records and read export info and fill-rate statistics
- Create, copy, rename, and share company lists
- Add and remove records in a company list and read them back
- Monitor saved company lists for changes
- Run data-match projects to reconcile your records against the database

## Use cases

### AI Agent Company Lookup

An AI agent connected through Jentic finds companies that match a user's criteria across the DACH region and exports the matching records for downstream use. Detailed search returns full firmographic records, while the selection-list variant returns summarized matches when the agent only needs a shortlist.

Example prompt: Search for companies matching given criteria and export the matching records

### List Building and Monitoring

A sales operation builds a company list, adds matching records, and sets up monitoring so changes to those companies are surfaced over time. Lists can be copied, renamed, and shared with colleagues, keeping a working set in one place.

Example prompt: Create a company list, add matching records, and set up monitoring for changes

### Data Matching and Reconciliation

To clean a CRM, an agent runs a data-match project: it creates the project, adds the records to reconcile, starts the match, and reads the result against the database. This flags which of your records correspond to known companies.

Example prompt: Create a data-match project, add your records, start it, and read the match results

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/search/fi` | Search companies with detailed results |
| POST | `/export` | Export selected company records |
| GET | `/export/info` | Get export info |
| GET | `/fls/list` | List company lists |
| POST | `/fls/create` | Create a company list |
| POST | `/datamatch/create` | Create a data-match project |
| GET | `/datamatch/result` | Get data-match results |

## Key resources

- **Search** — Search company records with detailed or selection-list results
- **Export** — Export records and read export info and fill-rate statistics
- **Company Lists** — Create, manage, and share lists of company records
- **Monitoring** — Monitor company lists for changes
- **Data Match** — Reconcile your records against the company database
- **Credits** — Read and top up your query credit balance

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 37 / 100
- **Maturity:** Non-Ready
- **Dimensions:**
  - Foundational Compliance: 83 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 40 / 100
  - Agent Usability: 94 / 100
  - Security: 10 / 100
  - AI Discoverability: 42 / 100
- **View full report:** https://jentic.com/apis/neugeschaeft.de/neugeschaeft/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the neugeschaeft REST-API by hand means setting up HTTP Basic authentication, tracking your query credits, and shaping each company search and export yourself. Through Jentic you install once, import neugeschaeft from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** neugeschaeft carries search criteria and list identifiers in the request body, so rules bound which operations your agent may call, not which lists it touches. You choose the operations it may use, such as searching and exporting records, so deleting or sharing a company list is not included unless you add it.
- **Credential handling:** Your neugeschaeft Basic auth credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'search company records' or 'export companies', and Jentic returns the matching neugeschaeft operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Clearbit** — Clearbit enriches company records with firmographic and technographic data.
- **OpenCorporates** — OpenCorporates provides official company registry data worldwide.
- **Crunchbase** — Crunchbase adds funding, investor, and company profile context.

## FAQ

### What authentication does the neugeschaeft REST-API use?

It uses HTTP Basic authentication, as declared in its OpenAPI spec. You send your username and password with the request. Through Jentic the credentials are stored encrypted by your own Jentic One instance and injected at call time, so they never appear in the agent's prompt or logs.

### Can I search for companies in the DACH region with the neugeschaeft REST-API?

Yes. The company-search operation returns detailed records, a selection-list variant returns summarized matches, and you can export the results and read fill-rate statistics for the export.

### What are the rate limits for the neugeschaeft REST-API?

The OpenAPI spec does not specify rate limits; usage is governed by the query credits on your account, which you can read through the credits operation. Check your neugeschaeft account for your current credit balance before running large exports.

### Can I limit what my agent is allowed to do with the neugeschaeft REST-API?

Yes. Write a rule that allows only the search and export operations, so the agent can find and pull company records but cannot create, delete, or share company lists, and every call it makes is logged.

### How do I search for companies with the neugeschaeft REST-API through Jentic?

Search Jentic for 'search company records', add the neugeschaeft REST-API from the directory, and store your Basic credentials once. Your agent runs the search and exports the matching records. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a neugeschaeft REST-API MCP server?

You don't need an MCP server to give your agent the neugeschaeft REST-API. Jentic connects it directly from the API Directory: import it, store your credentials once, and your agent calls the search, export, list, and data-match operations. That keeps extra tool definitions out of the agent's context.
