tap-apollo
tap-apollo is a Singer tap for Apollo.io, built with the
Meltano Singer SDK. It extracts the records your team
manages in Apollo (contacts, accounts, deals, tasks, calls, sequences and
outreach emails) plus workspace reference data, through the
Apollo REST API.
Streams
| Stream | Endpoint | Replication |
|---|---|---|
contacts |
POST /contacts/search |
Incremental on updated_at |
accounts |
POST /accounts/search |
Full table |
opportunities |
GET /opportunities/search |
Full table |
tasks |
POST /tasks/search |
Full table |
phone_calls |
GET /phone_calls/search |
Full table |
sequences |
POST /emailer_campaigns/search |
Full table |
emailer_messages |
GET /emailer_messages/search |
Full table |
users |
GET /users/search |
Full table |
email_accounts |
GET /email_accounts |
Full table |
lists |
GET /labels |
Full table |
custom_fields |
GET /typed_custom_fields |
Full table |
contact_stages |
GET /contact_stages |
Full table |
account_stages |
GET /account_stages |
Full table |
opportunity_stages |
GET /opportunity_stages |
Full table |
Limitations
-
50,000 records per search. Apollo's search endpoints return at most 500 pages of 100 records. When a stream hits that cap, the tap logs a warning and stops. Apollo has no updated-since filter, so
contactsis requested newest first and pagination stops at the bookmark. After the first sync, each run only needs to page through contacts that changed since the last run. -
Master API key. Some endpoints (e.g.
users,emailer_messages) only accept a master API key. With a regular key these streams fail with a 403. Deselect them if your key doesn't have access. -
Rate limits. Apollo limits calls per minute, hour and day, depending on your plan. The tap retries 429 responses, honoring
Retry-Afterwhen Apollo sends it. -
Schemas. Schemas in
tap_apollo/schemas/are generated from Apollo's OpenAPI spec and response examples byscripts/gen_schemas.py. Fields not in the spec are dropped. Rerun the script to pick up spec changes:curl -sSLo spec.json https://docs.apollo.io/openapi/apollo-rest-api.json python scripts/gen_schemas.py spec.json tap_apollo/schemas
Configuration
| Setting | Required | Description |
|---|---|---|
api_key |
Yes | Apollo API key (Settings → Integrations → API). |
start_date |
No | Earliest update time to extract for contacts. |
The SDK also supports stream_maps, flattening_enabled and the other standard
settings. Run tap-apollo --about to list them all.
Settings can also be set via environment variables, e.g. TAP_APOLLO_API_KEY
(see .env.example), when the tap runs with --config=ENV.
Usage with Meltano
Add the tap to a Meltano project as a custom extractor:
plugins:
extractors:
- name: tap-apollo
namespace: tap_apollo
pip_url: git+https://github.com/<org>/tap-apollo.git
capabilities: [state, catalog, discover, about, stream-maps, structured-logging]
settings:
- name: api_key
kind: string
sensitive: true
- name: start_date
kind: date_iso8601
settings_group_validation:
- [api_key]
meltano install extractor tap-apollo
meltano config tap-apollo set api_key <key>
meltano run tap-apollo target-jsonl
Development
uv sync
uv run pytest # offline tests with a mocked API
TAP_APOLLO_API_KEY=<key> uv run pytest # also runs the SDK's standard tests live
uv run tap-apollo --config .secrets/config.json --discover
meltano.yml in this repo is set up for local testing:
meltano install
meltano run tap-apollo target-jsonl
Metadata
Release files for meltanolabs-tap-apollo 0.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| meltanolabs_tap_apollo-0.1.2.tar.gz | 252.7 kB | With provenance | Details for meltanolabs_tap_apollo-0.1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| meltanolabs_tap_apollo-0.1.2-py3-none-any.whl | Python 3 | none | any | Details for meltanolabs_tap_apollo-0.1.2-py3-none-any.whl |
Total release size: 282.1 kB
Release files / meltanolabs_tap_apollo-0.1.2.tar.gz
| Download URL | meltanolabs_tap_apollo-0.1.2.tar.gz |
|---|---|
| Size | 252.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4b1df2c801540cf561b174cc7f3274f9136fbb517bef0c9a89b00c2060806548
|
|
BLAKE2b-256 checksum How to use checksums |
6607e6a2746fb4fda7eac7978806ac127186af05b5b48bb20bb00944334c3aac
|
| 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 27, 2026.
Transparency logRelease files / meltanolabs_tap_apollo-0.1.2-py3-none-any.whl
| Download URL | meltanolabs_tap_apollo-0.1.2-py3-none-any.whl |
|---|---|
| Size | 29.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a43e8812466c81f0bd6cfaf87caf7e5a902652e7a154fb1ae3d255a08d0b488c
|
|
BLAKE2b-256 checksum How to use checksums |
b0ef422696dae1a95f0020c017c100ec36f295b56d44036c01145f19e897eb8f
|
| 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 27, 2026.
Transparency logSecurity for meltanolabs-tap-apollo 0.1.2
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.
Attestation for meltanolabs_tap_apollo-0.1.2.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 27, 2026.
Transparency logA 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.