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
- Discuss scope and coverage with our team; receive credentials and sandbox access
- Integrate endpoints from the OpenAPI docs
- 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
pageandpageSizeon list endpoints - Filtering: combine query params (e.g.,
country, keywordq) - 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.