Skip to main content

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 contacts is 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-After when Apollo sends it.

  • Schemas. Schemas in tap_apollo/schemas/ are generated from Apollo's OpenAPI spec and response examples by scripts/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)

Source distribution for meltanolabs-tap-apollo 0.1.2
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)

Table of built distributions (wheels) for meltanolabs-tap-apollo 0.1.2
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 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.

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