Search lookup
GET /v1/search/lookupFind public records by place/address text, postcode, UPRN or public UUID. Exact and lexical lookup uses no embedding model. Returns separate families with UUID detail links. Coverage is limited to published graph records; no match is not evidence of nonexistence. For attribute criteria use search_entities.
Same call over MCP
Find public records by address or referencelookup_entitiesAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Request
Calling GET /v1/search/lookup
curl "https://api.marketcode.ai/v1/search/lookup?q=%3Cq%3E" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| q | Query | string | Yes | |
| limit | Query | integer | No | Default: 5 |
Price and licence
What it costs, and where the data comes from
Search lookup 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 lookup
- Search properties, listings, buildings, land and market factsFree
search_entitiesBounded 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.Named in the description - 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
FAQ
Questions about Search lookup
How much does `lookup_entities` cost?
+
Search lookup 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 lookup on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.