Company Public Tender Lookup API

Query company public tender lookup sources and receive normalized JSON records with confidence, provenance, and source URLs.

Who this is for

Developers, enrichment teams, analysts, and operations teams use this actor when they need focused company public tender lookup output instead of a broad generic scraper or manual checking.

Buyer outcomes

• Send a company public tender lookup query and receive normalized records for integration.
• Prioritize matches with confidence, source URLs, normalized fields, and warnings.
• Use predictable JSON in APIs, enrichment flows, CRM, spreadsheets, and review queues.

Sources monitored

• TED Search API
• oeffentlichevergabe.de Open Data
• SIMAP Switzerland
• Austria USP tender search/publication media
• Apify Standby mode

Inputs

• sourceMode: use sample for a smoke run or configured query/source modes for integration.
• startUrls: optional public record, registry, company, permit, recall, or tender URLs when URL-backed lookup is supported.
• sourceIds: approved lookup source identifiers.
• maxItems: bounded number of normalized lookup results.
• watchlistTerms: query terms, identifiers, brands, companies, products, or source filters.
• webhookUrl: optional destination for integration handoff or review queues.
• outputMode: use sample records for Store validation or production output for normal runs.

How it transforms the input

• Input: company public tender lookup query, identifier, URL, or watchlist term.
• Transformation: normalize the query, match against configured public sources, and attach confidence/provenance.
• Output: predictable JSON result records with normalized fields, source URLs, confidence, and warnings.

Outputs

The actor returns normalized API-style result records with query context, source-backed fields, confidence, provenance, warnings, and integration-ready JSON.

Family-specific fields to expect:

• query: Input query or identifier.

• normalizedResult: Matched and normalized result object.

• confidence: Match confidence.

• sourceUrl: Source-backed record URL.

• warnings: Ambiguity or data-quality warnings.

• recordId: Stable record ID for exports, dedupe, and downstream joins.

• title: Human-readable record title for review and export.

• sourceName: Source identifier used to trace where the record came from.

• sourceUrl: Direct source URL for review and audit.

• dedupeKey: Stable key used for delta mode and duplicate suppression.

• retrievedAt: Timestamp showing when the actor retrieved or generated this record.

• score: Normalized field for filtering, routing, or downstream review.

• scoreReasons: Buyer-readable explanation for the score or match.

• confidence: Normalized field for filtering, routing, or downstream review.

• errors: Normalized field for filtering, routing, or downstream review.

• runSummary: Run-level summary for counts, filters, charges, and next actions.

Pricing

This actor uses Apify pay-per-event pricing. Current public listing guidance: $29-$49 / 1,000 launch validation records until public data proof is complete. Charges are tied to buyer-visible value events such as lookup-result, dataset-processed, record-saved, enriched-record. Small validation runs are supported so you can inspect output before scaling a schedule.

• lookup-result: Charge when Company Public Tender Lookup API produces Lookup Result. Typical price: $0.043. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• dataset-processed: Base charge when Company Public Tender Lookup API writes a non-empty default dataset. Typical price: $0.011. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• record-saved: Charge for each buyer-visible result saved by Company Public Tender Lookup API. Typical price: $0.003. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• enriched-record: Charge when Company Public Tender Lookup API adds match scoring, source evidence, or enrichment to a saved result. Typical price: $0.022. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• first-run-cap: Recommended first run budget cap. Typical price: $3.820. Start with the default small run, inspect the dataset, then raise maxItems or schedule recurring runs.

API example

curl -X POST "https://api.apify.com/v2/actors/zentrafoundry~company-public-tender-lookup-api/runs" \
+  -H "Authorization: Bearer $APIFY_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"maxItems":10,"sourceIds":["TED-SEARCH","OEV-OPEN","SIMAP-CH"],"includeSourceUrls":true,"includeMatchReasons":true,"outputMode":"buyer-ready-records"}'

Recommended first run

{
    "maxItems": 10,
    "sourceIds": [
        "TED-SEARCH",
        "OEV-OPEN",
        "SIMAP-CH"
    ],
    "includeSourceUrls": true,
    "includeMatchReasons": true,
    "outputMode": "buyer-ready-records"
}

Sample output

Sample status: sample_unavailable at https://zentra.nimblique.studio/external/actor-review/samples/company-public-tender-lookup-api.json. No fake sample is published; run a bounded real sample refresh before using examples in promotion.

Recommended public tasks

[
    {
        "name": "Validate 10 lookup results",
        "description": "Low-cost validation run for checking query, normalized result, confidence, and source fields.",
        "input": {
            "maxItems": 10,
            "sourceIds": [
                "TED-SEARCH",
                "OEV-OPEN",
                "SIMAP-CH"
            ],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "company-public-tender-lookup-api"
        }
    },
    {
        "name": "Daily lookup refresh",
        "description": "Recurring batch for watched queries and normalized source-backed result changes.",
        "schedule": "Daily during local business hours",
        "input": {
            "maxItems": 25,
            "sourceIds": [
                "TED-SEARCH",
                "OEV-OPEN",
                "SIMAP-CH"
            ],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "company-public-tender-lookup-api"
        }
    }
]

Use cases

• Embed company public tender lookup lookup into API, CRM, enrichment, or review workflows.
• Normalize source-backed query results into predictable JSON fields.
• Return confidence, source URLs, and machine-readable context for each match.
• Use low-volume validation runs before integrating into production systems.

Trust and compliance

• Uses TED Search API, oeffentlichevergabe.de Open Data, SIMAP Switzerland.
• Keeps source URLs and source identifiers in output records for auditability.
• Does not require private credentials unless a source is explicitly configured for approved authenticated access.

Limitations

• Results depend on public-source availability, source uptime, and source update cadence.
• Public sources can revise records after publication; rerun scheduled tasks for fresh evidence.
• Scores and match reasons are decision-support signals, not legal, financial, procurement, medical, safety, or regulatory advice.
• Large production runs can cost more than the default smoke run; start small, inspect output, then scale schedules.

FAQ

Can I run this without URLs? Yes. The default sample mode is designed to succeed without user-supplied URLs, and URL-backed runs can use startUrls when needed.

Can I schedule it? Yes. Use sinceLastRun, watchlistTerms, and optional webhookUrl to turn the actor into a recurring alert or report workflow.

How do I verify value before scaling? Run the recommended first-run input, review the sample output fields, then increase maxItems or schedule recurring runs after the dataset matches your use case.