Skip to main content
Resources
Developer Resources

Developer Quickstart: Integrating the B2B Identity Graph via REST.

This integration guide gives data engineering teams a practical path to authenticate, query, and pull records from the GraphIQ.ai v2 core REST endpoints. Whether you're building an automated target scoring module, mapping complex global corporate parentage, or syncing enriched contacts, this blueprint covers the key patterns to initiate your connection smoothly and manage un-metered payloads cleanly.

Quickstart

Three-step access blueprint.

STEP 01

Secure token retrieval

Extract your live account credentials from your verified profile space, then pass the token across programmatic workloads via the standard X-API-Key request header.

curl https://api.graphiq.ai/v2/organizations/search \
  -H "X-API-Key: $GRAPHIQ_KEY" \
  -H "Content-Type: application/json"
STEP 02

Compose an AST query tree

Instead of flat parameter lines, structure searches as nested Abstract Syntax Trees. Use explicit operators — and, or, not, should — to filter across 300M+ organizations or 370M+ professionals in a single transaction.

{ "query": {
    "and": [
      { "industry": "precision machining" },
      { "should": [
        { "employees": { "gte": 100, "lte": 800 } },
        { "certification": "ISO 9001" }
      ] },
      { "not": { "status": "dissolved" } }
    ]
} }
STEP 03

Configure throttling & pagination

Manage streaming limits cleanly with limit, offset, and field constraints (get). Monitor response headers to track Redis cache sliding-window availability across your application lifecycle.

GET /v2/organizations/search
     ?limit=50&offset=0
     &get=name,domain,hierarchy

x-ratelimit-remaining: 4,812
x-cache-window:       sliding/60s
In production

Core data workflows and use cases.

Enterprise CRM cleansing

Streamline record hygiene by pointing data pipelines directly to our entity resolution layer.

Programmatic lookalike sourcing

Surface structural matches by passing the similar=True query boolean parameter.

Market monitoring triggers

Set continuous alert loops via POST /api/v2/news/search to catch executive shifts, funding, and hierarchy updates within 24–72 hours of filing.

Setup assistant

Ready to initialize your production workspace pipeline?

Launch the setup assistant to generate your first sandbox API credentials, test a live query against 300M+ resolved organizations, and configure your first automated data sync workflow.

Launch the setup assistant