Skip to Content

Connect Orbit to Your AI Agent

Find people, build their public profiles and follow changes.

25 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a Orbit Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillOrbit

Research a professional audience

Find matching people and enrich selected profiles.

/oo Orbit: Use Orbit to find people matching [criteria]. Wait for the search, keep successful results, and enrich the selected profiles to [partial/full] depth. Include sources and report any failed items.

Start Working with Orbit

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Orbit

    Create a scoped API key at https://developer.orbitsearch.com/dashboard/keys.

    Connect Orbit→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • An Orbit API key with search:read for connection verification.
  • API credits and the scopes required by the operations you use.
  • Connecting requests a population price quote without starting a search.
  • Profile access needs profile:read; monitoring needs watchers:write; webhook management needs webhooks:write.
  • Asynchronous searches can return partial results. completed_with_errors preserves successful results.

Orbit Tools

Search by natural-language criteria or known identity signals. Enrich individual profiles or batches, search entire populations, and receive changes through scheduled watchers and signed webhooks.

People search

Search known people, discover candidates and search company or school populations.

Profile enrichment

Read profiles as JSON or Markdown and enrich one or many profiles.

Bulk search

Submit many searches, track progress, page results and cancel pending items.

Profile monitoring

Manage scheduled profile refreshes and read their run history.

Event delivery

Register, list, test and delete signed webhook destinations.

Photo search

Upload a photo from a public URL, detect faces and search the existing face index.

25 tools

Search

Find people, optionally discover additional candidates, and build every selected result to the requested profile depth. Requires the `search:read` scope. Requests that include profiles also require `profile:read`.

orbit.search

Get Search

Return the latest search snapshot. Poll while the status is `running`. Requires the `search:read` scope. Searches that include profiles also require `profile:read`.

orbit.get_search

Quote Population

What it costs to search everyone at a company or everyone who attended a school. Requires the `search:read` scope.

orbit.quote_population

Search Population

Search everyone at a company or everyone who attended a school. People are added to the results as the search finds them. Reserves the quoted credits. Requires the `search:read` scope.

orbit.search_population

Batch Enrich

Apply one enrichment operation to between 1 and 20 known Orbit profile IDs. Requires the `search:read` scope. Requests that include profiles also require `profile:read`.

orbit.batch_enrich

Read Profile

Read the current public profile for an Orbit profile ID, known alias ID, or public profile slug. When the stored profile is stale, the read can schedule a background refresh. Use POST /v3/enrich/{profile_id} to request a specific depth or regeneration. Requires the `profile:read` scope. Optional format=markdown returns compact factual USER.md, a manifest and populated section Markdown files in a JSON package; format=json is the default. Both representations use the same public-profile filtering, billing and refresh behavior.

orbit.read_profile

Enrich Profile

Read, upgrade, or regenerate one known Orbit profile. Requires the `search:read` scope. Requests that include the profile also require `profile:read`.

orbit.enrich_profile

Get Enrichment

Return the latest snapshot for one profile enrichment request. Poll while the status is `running`. Requires the `search:read` scope. Requests that include the profile also require `profile:read`.

orbit.get_enrichment

Create Watcher

Start watching a profile. Orbit checks it on the schedule you choose and adds what it finds to the profile. Each profile has one watcher per organization; creating a watcher for a profile you already watch updates that watcher and turns it back on. Requires the `watchers:write` scope.

orbit.create_watcher

List Watchers

All your watchers. Requires the `watchers:write` scope.

orbit.list_watchers

Get Watcher

One watcher, with its schedule and run counters. Requires the `watchers:write` scope.

orbit.get_watcher

Update Watcher

Pause, resume, retime or rescope a watcher. Send the fields you want to change. Requires the `watchers:write` scope.

orbit.update_watcher

Delete Watcher

Deletes the watcher and its schedule. Pausing keeps the configuration for later; deleting removes it. Requires the `watchers:write` scope.

orbit.delete_watcher

List Watcher Runs

The watcher's refresh runs, newest first: outcome, the events each run added with their sources, and what was billed. Requires the `watchers:write` scope.

orbit.list_watcher_runs

Create Webhook

Registers an HTTPS URL to receive signed event deliveries. The response includes the signing `secret` once. Requires the `webhooks:write` scope.

orbit.create_webhook

List Webhooks

Your registered endpoints, with masked signing secrets. Requires the `webhooks:write` scope.

orbit.list_webhooks

Delete Webhook

Deletes the endpoint. Deliveries stop immediately and the signing secret is invalidated. Requires the `webhooks:write` scope.

orbit.delete_webhook

Test Webhook

Delivers one signed test event to the endpoint so you can verify your handler without waiting for a real event. The body is your most recent event of this type when you have one and the documented example payload otherwise; either way the envelope carries `"test": true` and an `evt_test_` event ID. Test deliveries are free, are never retried, and are not recorded in your delivery history. Requires the `webhooks:write` scope and is rate limited more tightly than other routes.

orbit.test_webhook

Detect Faces

Store a photo privately and return every face in it, left to right. Requires the `search:read` scope.

orbit.detect_faces

Search Face Index

Return the Orbit profiles whose photos show the picked face. Requires the `search:read` scope.

orbit.search_face_index

Bulk Search

Requires search:read and profile:read when any item includes profiles. Accepted items are queued and retry temporary execution failures automatically.

orbit.bulk_search

Get Bulk Search

Read Bulk Search Progress.

orbit.get_bulk_search

Get Bulk Results

Read Bulk Search Results.

orbit.get_bulk_results

Cancel Bulk Search

Cancel Undispatched Bulk Items.

orbit.cancel_bulk_search

Get Batch Enrichment

Read all accepted child enrichment requests in one call. Keep the request_ids from batch_enrich; completed_with_errors retains successful profiles and failed child details.

orbit.get_batch_enrichment

Frequently Asked Questions

What does completed_with_errors mean?

Some work failed but other results are available. Inspect the returned results and failures; do not discard successful profiles.

How do I wait for a batch enrichment?

Pass the request_ids array returned by batch_enrich to get_batch_enrichment. It reads each accepted child and keeps both successful profiles and failures.