ProFix Directory docs - APIs, datasets, MCP, JSON-LD

Welcome

Use ProFix as structured data

ProFix Directory publishes Ohio home-services profiles, permit signals, license evidence, verification deltas, cost benchmarks, and Schema.org graphs as public, cacheable, attributed data. Start here if you are building an integration, citing the dataset, powering retrieval, or checking the public API surface.

Data access

The 3 ways to consume ProFix data

AI agents

Use MCP for agent workflows, llms.txt for retrieval hints, and OpenAPI 3.1 for REST contracts.

/api/mcp

MCP server for AI agents that need structured ProFix lookup context.

/llms.txt

Short AI-readable index of high-value public pages and feeds.

/llms-full.txt

Expanded AI-readable documentation bundle for deeper retrieval.

/api/openapi.json

OpenAPI 3.1 contract for public REST JSON APIs and CSV exports.

REST JSON APIs

/api/lead-feed.json

Aggregate lead-volume and urgency mix. No homeowner PII.

/api/quality-stats.json

Lead-quality score histogram and tier statistics.

/api/coverage-stats.json

Verified contractor counts by Ohio county, region, and trade.

/api/permit-leaderboard.json

Permit-pull leaderboard data by trade and jurisdiction.

/api/embed/{slug}.json

Single-profile embed payload for a public contractor slug.

/api/pro/{slug}.json

Single-profile JSON document for a public contractor slug.

/api/trust-scores.json

Aggregate ProFix Trust Score feed for public profiles.

/api/jsonld/{type}

Schema.org graph endpoint for supported graph types.

/api/verification-feed.json

Machine-readable verification, license, permit, and audit deltas.

/api/cost-report.json

2026 Northwest Ohio cost-report benchmarks.

/api/permits.json

Permit-office and trade-level permit guidance dataset.

/api/cities.json

Canonical public cities with county, metro, and ZIP context.

/api/city-taxonomy.json

Canonical city pages plus observed service-area aliases.

/api/license-evidence.json

License evidence states for licensable public profiles.

/api/pros.json

Bulk public profile feed pointer and dataset metadata.

/api/outage-status

Public service-status and outage-state document.

CSV exports

/api/permit-leaderboard.csv

CSV companion to the permit leaderboard feed.

/api/coverage-stats.csv

CSV companion to the coverage statistics feed.

/api/lead-feed.csv

CSV companion to the aggregate lead feed.

/api/cost-report.csv

CSV companion to the cost-report dataset.

/api/pros.csv

CSV companion to the public profile dataset.

Datasets

Bulk dataset

Bulk profile data is hosted on Hugging Face. License: CC-BY-4.0. Refresh cadence: monthly for bulk exports, with public API feeds refreshed as their source datasets update.

Schema.org graphs

JSON-LD feeds

/api/jsonld/pros

Full LocalBusiness graph for public profiles.

/api/jsonld/cost-guides

Article graph for public cost-guide content.

/api/jsonld/faq

Combined FAQ graph from guide and cost content.

/api/jsonld/organization

Canonical ProFix Directory Organization entity.

/api/jsonld/local-business-index

ItemList index of ranked LocalBusiness entities.

/api/jsonld/breadcrumb-coverage

BreadcrumbList graph for coverage pages.

/api/jsonld/faq-trade-plumber

Trade FAQ graph pattern: /api/jsonld/faq-trade-{trade}.

Sitemaps

Crawl indexes

/sitemap.xml

Core public routes.

/pro/sitemap.xml

Public pro profiles and evidence pages.

/oh/sitemap.xml

Ohio city, county, and local coverage pages.

/coverage/sitemap.xml

Coverage landing and service-area routes.

/content/sitemap.xml

Editorial guides, research, and evergreen content.

/permits-leaderboard/sitemap.xml

Permit leaderboard index and detail pages.

/api/sitemap.xml

Public API feed sitemap.

Embed widgets

Drop-in widgets

Preview widgets at /embed-preview, then use the snippet below with the trade and city you want to surface.

<div id="profix-widget" data-trade="plumber" data-city="toledo"></div>
<script src="https://profixdirectory.com/embed.js" defer></script>

Rate limits + caching

Public cache policy

Rate limits: none currently. Public endpoints are CDN-cached for 1h with stale-while-revalidate for 1d unless an endpoint states a stricter policy.

Licensing

CC-BY-4.0

Public feeds, CSV exports, and datasets are CC-BY-4.0 across the board. Cite ProFix Directory and keep attribution visible in downstream documentation, analysis, and generated summaries.

Contact

Partnerships and support

Email hello@profixdirectory.com for partnerships. Use /partners for integration context and /support for user support.