Skip to main content

youcom-haystack

PyPI - Version PyPI - Python Version


Usage

YouComWebSearch runs without any configuration: with no API key available it uses the You.com keyless free tier (rate limited per IP). Set the YOUDOTCOM_API_KEY environment variable to use the keyed You.com Search API with higher limits.

from haystack_integrations.components.websearch.youcom import YouComWebSearch

websearch = YouComWebSearch(top_k=5)
result = websearch.run(query="What is Haystack by deepset?")
result["documents"]  # list[Document]
result["links"]  # list[str]

To require a key instead of silently degrading to the keyless tier, pass keyless_fallback=False; the component then raises YouComError when no key resolves.

Contributing

Refer to the general Contribution Guidelines.

The unit tests are fully mocked and need no credentials. The integration tests include one live keyless search that needs no key; to also run the keyed tests, export the YOUDOTCOM_API_KEY environment variable.

Metadata

Release files for youcom-haystack 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for youcom-haystack 1.0.0
File Size Uploaded Provenance Actions
youcom_haystack-1.0.0.tar.gz 13.9 kB With provenance Details for youcom_haystack-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for youcom-haystack 1.0.0
File Interpreter ABI Platform Actions
youcom_haystack-1.0.0-py3-none-any.whl Python 3 none any Details for youcom_haystack-1.0.0-py3-none-any.whl

Total release size: 24.5 kB

Release files / youcom_haystack-1.0.0.tar.gz

Download URL youcom_haystack-1.0.0.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5cf61458bb1c4dbe497cb5e11bc47085d0062149dcede2ac5e4950256efa8a60
BLAKE2b-256 checksum
How to use checksums
2e3ea39998fcb517270b02f05163e2518afd0fff9dec9475529d60e9111a907a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / youcom_haystack-1.0.0-py3-none-any.whl

Download URL youcom_haystack-1.0.0-py3-none-any.whl
Size 10.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
51c2ecbf019fe7c6dc0275d9f51133b2a0be736a43ca88b570f9ac13617ffa03
BLAKE2b-256 checksum
How to use checksums
bd682e29b751a22ae26cb42c870bfbba571adfdde3b916ee85eb19210b151367
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for youcom-haystack 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for youcom_haystack-1.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page