Search
POST /v1/searchBounded public search using the versioned SearchQuery. Criteria are validated by the server; sorting and pagination use the same eligibility as the map. All Entities returns separate groups. No graph inference or unknown evidence changes eligibility.
Authenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Request
Calling POST /v1/search
curl -X POST "https://api.marketcode.ai/v1/search" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{}'Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
This endpoint takes no path or query parameters.
Price and licence
What it costs, and where the data comes from
Search is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Related
Endpoints used with Search
- Recorded entity relationshipsFree
entity_relationshipsRecorded relationship evidence from the derived graph. Use canonical ids from search. Cite path provenance and publication dates. Bounded and eventually consistent; missing links do not establish absence, ownership or off-market status. No private ownership payloads are returned.Same category - Search capabilities and coverageFree
entity_search_capabilitiesGoverned entity families, criteria, coverage and query limits. Call before building searches.Same category
FAQ
Questions about Search
How much does `search_entities` cost?
+
Search is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
How do I authenticate?
+
Send your API key as a Bearer token in the Authorization header. Keys are created in the API & MCP Hub, shown once and revocable. Every response carries the credits charged and your remaining balance.
Try Search on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.