Cylex

Listings data for agencies and partners

Cylex API

Built for managing your business listings at scale. Programmatically access business profiles, categories, hours, and attributes across multiple countries, with support for agencies and listing partners. The Cylex API is a REST API documented with OpenAPI.

Why teams choose the Cylex API

  • Unified access to company profiles, contact data, categories, hours, attributes, and more
  • Multi-country coverage with localized fields and compliance considerations
  • Reliable, standards-aware schemas with consistent identifiers
  • Designed for ingestion, enrichment, and synchronization at scale

Common use cases

  • Aggregators and listing partners enriching listings with high-quality business data
  • Agencies keeping client directories in sync across markets
  • Platforms building local search, discovery, or analytics features
  • Multi-location brands standardizing and validating branch data

Built on proven coverage

32
Countries & Regions
196,726,052
Pageviews
91
Directory Integrations

CTO outcomes

  • Coverage & scale: multi-country data with consistent identifiers
  • Time-to-value: fast integration with clear schemas and examples
  • Governance: duplicate control (/suppress), abuse reporting, taxonomy mapping

Reliability & support

  • SLAs: aligned to your traffic and markets
  • Monitoring: observability & error transparency
  • Onboarding: guided setup, sandbox, and taxonomy alignment

End-to-end company lifecycle (CRUD)

Manage the full lifecycle of business listings programmatically:

  • Create: POST /order: create/order a new company
  • Read: GET /search, GET /details: discover and enrich profiles
  • Update: PUT /update: keep data current (hours, attributes, etc.)
  • Delete/Suppress: POST /suppress, DELETE /cancel: handle suppression and matching cancellation

Sample flow (curl)

# 1) Create
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"New Co Ltd","countryCode":"GB"}' \
  "https://api2.cylex-international.com/order?Token=$TOKEN"

# 2) Read
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api2.cylex-international.com/search?Name=New%20Co%20Ltd&CountryCode=GB"

# 3) Update
curl -s -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"id":"GB-123456","description":"Updated description"}' \
  "https://api2.cylex-international.com/update?Token=$TOKEN"

# 4) Suppress/Cancel
curl -s -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"listingId":"GB-123456","suppress":true}' \
  "https://api2.cylex-international.com/suppress?Token=$TOKEN"

curl -s -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://api2.cylex-international.com/cancel?CountryCode=GB&id=GB-123456&Token=$TOKEN"

How it works

  1. Discuss scope and coverage with our team; receive credentials and sandbox access
  2. Integrate endpoints from the OpenAPI docs
  3. Launch to production with aligned SLAs, limits, and monitoring

Pricing

  • One-time setup fee plus per-entry annual subscription
  • Regional pricing and volume discounts available
  • Contact sales for a tailored quote

Developer quickstart

Base URL and auth header

Base URL: https://api2.cylex-international.com
Header:    Authorization: Bearer <TOKEN>

Search companies (curl)

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api2.cylex-international.com/search?q=plumber&country=GB&page=1&pageSize=50"

Bulk details (Node.js)

fetch("https://api2.cylex-international.com/details?ids=123,456,789", {
  headers: { Authorization: "Bearer $TOKEN" }
}).then(r => r.json()).then(console.log)

Update listing (Python)

import requests
requests.put(
  "https://api2.cylex-international.com/update",
  headers={"Authorization": "Bearer TOKEN", "Content-Type": "application/json"},
  json={"id": "123", "name": "New Name Ltd"}
).json()

Filters, paging, and errors

  • Pagination: use page and pageSize on list endpoints
  • Filtering: combine query params (e.g., country, keyword q)
  • Retries: back off on 429/5xx; log response body for diagnostics
  • Schemas: see OpenAPI docs

Build faster with the Cylex API

Get access, integrate the endpoints you need, and keep your listings in sync across markets.