SmartAPIs.net
SmartAPIs.net gives developers and AI agents a cleaner way to work with real-world operational data. The current launch wedge is Products Watch: structured product, offer, and price-history intelligence exposed through REST, OpenAPI, and MCP. Instead of stitching together brittle scrapers, inconsistent filters, and fragmented public sources, SmartAPIs.net provides one structured API surface with…
SmartAPIs.net endpoints
| Method | Endpoint | Description |
|---|---|---|
| Discovery | ||
| GET |
getAgentCapabilities /v1/agent/capabilities |
|
| GET |
getAgentContext /v1/agent/context/{location_id} |
|
| GET |
getReadiness /readyz |
|
| GET |
getHealth /healthz |
|
| GET |
getOpenAPIYAML /v1/openapi.yaml |
This discovery surface is treated as public-contract critical. Use it when humans or tooling need the canonical YAML representation of the SmartAPIs public contract. |
| POST |
agentQueryPlan /v1/agent/query |
|
| GET |
getOpenAPIJSON /v1/openapi.json |
Use this route when you want a machine-consumable API contract for code generation, agent planning, or quick schema inspection. |
| GET |
listCoverageRegions /v1/coverage/regions |
Returns the public launch coverage map for SmartAPIs across currently supported North American metros. Customers and agents should call this before purchase or before attempting… |
| GET |
getCoverageRegion /v1/coverage/regions/{region_id} |
Returns one public region record, including geography metadata, timezone, and module coverage posture for that metro. |
| Billing | ||
| POST |
receiveStripeWebhook /v1/billing/stripe/webhook |
|
| POST |
activateDeveloperFree /v1/organizations/me/developer-free/activate |
|
| POST |
createStripePortalSession /v1/billing/stripe/portal-session |
Creates a hosted Stripe billing-management session for the current subscription. SmartAPIs uses Stripe for billing changes, invoices, payment methods, and cancellation flows. |
| GET |
listBillingPlans /v1/billing/plans |
Returns the public SmartAPIs pricing surface, including the free developer tier, checkout eligibility, monthly versus annual billing options, supported currencies, and the… |
| PATCH |
updateCurrentOrganizationSubscriptionBillingControls /v1/organizations/me/subscription/billing-controls |
Updates customer-controlled billing and overage settings for the current subscription. This endpoint is additive: it does not replace the Stripe subscription object, but it does… |
| POST |
createStripeCheckoutSession /v1/billing/stripe/checkout-session |
Creates a Stripe-hosted checkout session for a paid SmartAPIs plan. The free developer tier is intentionally excluded from checkout because it is an activation path, not a paid… |
| Control Plane | ||
| PATCH |
updateCurrentOrganizationIPAllowlist /v1/organizations/me/enterprise/ip-allowlist |
|
| DELETE |
revokeCurrentOrganizationAPIKey /v1/organizations/me/api-keys/{api_key_id} |
|
| GET |
listCurrentOrganizationAPIKeys /v1/organizations/me/api-keys |
|
| PATCH |
updateCurrentOrganizationSAMLConfiguration /v1/organizations/me/enterprise/saml |
|
| GET |
listCurrentOrganizationRoleTemplates /v1/organizations/me/governance/role-templates |
|
| GET |
listCurrentOrganizationKeyPresets /v1/organizations/me/governance/key-presets |
|
| POST |
rotateCurrentOrganizationAPIKey /v1/organizations/me/api-keys/{api_key_id}/rotate |
|
| GET |
listCurrentOrganizationAuditEvents /v1/organizations/me/audit-events |
|
| GET |
getCurrentOrganizationSAMLConfiguration /v1/organizations/me/enterprise/saml |
|
| GET |
listCurrentOrganizationEntitlements /v1/organizations/me/entitlements |
|
| GET |
getCurrentOrganization /v1/organizations/me |
|
| POST |
exportCurrentOrganizationAuditEvents /v1/organizations/me/audit-events/export |
|
| POST |
createCurrentOrganizationAPIKey /v1/organizations/me/api-keys |
Creates a new client key for product access. The raw key is only returned once, so clients should store it securely immediately after creation. |
| GET |
getCurrentOrganizationUsage /v1/organizations/me/usage |
|
| GET |
getCurrentOrganizationIPAllowlist /v1/organizations/me/enterprise/ip-allowlist |
|
| GET |
getDashboardSummary /v1/dashboard |
Returns the combined dashboard payload for the current organization, including organization details, subscription state, entitlements, key summaries, usage, audit history, and… |
| POST |
createCurrentOrganizationServiceAccount /v1/organizations/me/service-accounts |
|
| GET |
getCurrentOrganizationSCIMConfiguration /v1/organizations/me/enterprise/scim |
|
| PATCH |
updateCurrentOrganizationSCIMConfiguration /v1/organizations/me/enterprise/scim |
|
| Legal | ||
| GET |
getLegalDataset /v1/legal/datasets/{dataset_id} |
|
| GET |
listAttributionRecords /v1/attribution |
Returns the public attribution catalog for reviewed SmartAPIs source families. Filters are additive and intended for provenance and contract review, not internal diagnostics. |
| GET |
listLegalDatasets /v1/legal/datasets |
|
| Reports | ||
| GET |
exportPlacesSearchSnapshotReport /v1/reports/places/search-snapshot |
Exports a snapshot-backed places search report for technical and non-technical stakeholders. The export includes explicit freshness and provenance labeling and does not imply… |
| GET |
replayPlacesSearchSnapshotReport /v1/reports/places/search-snapshot/replay/{snapshot_id} |
Replays the places snapshot export for a previously issued `snapshot_id`. This route is deterministic for identical filters and snapshot lineage. |
| Places | ||
| GET |
getPlaceAgentContext /v1/places/{place_id}/agent-context |
|
| GET |
listPlaces /v1/places |
Returns a filtered list of place records for the current organization and plan. This endpoint is intended to be simple enough for direct agent reasoning while still preserving… |
| GET |
searchPlaces /v1/places/search |
Explicit Places V2 search route. This is the preferred additive search surface going forward, while `GET /v1/places` remains supported for compatibility. |
| GET |
getPlace /v1/places/{place_id} |
|
| GET |
getPlaceStatus /v1/places/{place_id}/status |
|
| GET |
nearbyPlaces /v1/places/nearby |
|
| GET |
getPlaceHours /v1/places/{place_id}/hours |
|
| POST |
createPlaceWatch /v1/places/watch |
Accepts a bootstrap watch request for a place record or place query scope. This route is an honest intake surface for future durable watch delivery, not a claim of real-time… |
| Products | ||
| POST |
createProductWatch /v1/products/watch |
Accepts a bootstrap product watch request for a product record or search scope. This route is an honest intake surface for future durable price and offer watch delivery, not a… |
| GET |
getProduct /v1/products/{product_id} |
|
| GET |
getProductPriceHistory /v1/products/{product_id}/price-history |
|
SmartAPIs.net pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|