Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt

Use this file to discover all available pages before exploring further.

RevOps teams often research in Seamless, then sync enriched records into Salesforce, HubSpot, or a warehouse. The API supports this with research (spend credits once) and org data (read already-researched records without new research).

​
Flow

​
Step 1 — Research new leads

Follow Enrich a lead list or the contact workflow to research contacts and wait until poll status is done.

​
Step 2 — Export org contacts

After research completes, records live in your org. Fetch them with Get org contacts: 
curl -X GET "https://api.seamless.ai/api/client/v1/contacts?limit=50" \
  -H "Token: $SEAMLESS_API_KEY"

import os
import requests

response = requests.get(
    "https://api.seamless.ai/api/client/v1/contacts",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    params={"limit": 50},
)
response.raise_for_status()
for contact in response.json().get("data", []):
    print(contact.get("fullname"), contact.get("email"))
Org endpoints return contacts you have already researched. They do not accept searchResultId or requestId. No additional research credits are consumed on read.

​
Step 3 — Map fields to your CRM

Map Seamless fields to your CRM object (for example email, phone, title, company). In the Seamless app you can also import using CRM integrations — see the knowledge base article on importing into your CRM.

​
When to use org data vs research

SituationEndpoint
New targets from searchSearch → Research → Poll/webhook
Nightly sync of already enriched contactsGET org contacts / companies
Re-fetch after manual research in the appGET org contacts