Request asynchronous read collection
curl --request POST \
--url https://realtycrawl.dev/v1/jobs \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"operation": "listings.search",
"params": {
"platforms": [
"<string>"
],
"location": {
"kind": "text",
"query": "<string>",
"country": "<string>"
},
"property_types": [
"<string>"
],
"status": [
"<string>"
],
"price": {
"min": 123,
"currency": "<string>",
"max": 123,
"unit_code": "<string>"
},
"bedrooms": {
"min": 123,
"max": 123
},
"bathrooms": {
"min": 123,
"max": 123
},
"listed_since": "2023-11-07T05:31:56Z",
"include": [],
"source_filters": {},
"limit": 20,
"cursor": "<string>",
"allow_partial": false,
"group_by_property": false
},
"max_items": 5000
}
'import requests
url = "https://realtycrawl.dev/v1/jobs"
payload = {
"operation": "listings.search",
"params": {
"platforms": ["<string>"],
"location": {
"kind": "text",
"query": "<string>",
"country": "<string>"
},
"property_types": ["<string>"],
"status": ["<string>"],
"price": {
"min": 123,
"currency": "<string>",
"max": 123,
"unit_code": "<string>"
},
"bedrooms": {
"min": 123,
"max": 123
},
"bathrooms": {
"min": 123,
"max": 123
},
"listed_since": "2023-11-07T05:31:56Z",
"include": [],
"source_filters": {},
"limit": 20,
"cursor": "<string>",
"allow_partial": False,
"group_by_property": False
},
"max_items": 5000
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
operation: 'listings.search',
params: {
platforms: ['<string>'],
location: {kind: 'text', query: '<string>', country: '<string>'},
property_types: ['<string>'],
status: ['<string>'],
price: {min: 123, currency: '<string>', max: 123, unit_code: '<string>'},
bedrooms: {min: 123, max: 123},
bathrooms: {min: 123, max: 123},
listed_since: '2023-11-07T05:31:56Z',
include: [],
source_filters: {},
limit: 20,
cursor: '<string>',
allow_partial: false,
group_by_property: false
},
max_items: 5000
})
};
fetch('https://realtycrawl.dev/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "<string>",
"operation": "listings.search",
"status": "queued",
"created_at": "2023-11-07T05:31:56Z",
"result_count": 123,
"sources": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
],
"completed_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"schema_version": "<string>",
"generated_at": "2023-11-07T05:31:56Z",
"completeness": "complete",
"sources": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
],
"warnings": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>"
}
],
"pagination": {
"next_cursor": "<string>",
"has_more": true,
"returned": 123,
"total": 123,
"total_relation": "exact"
},
"property_groups": [
{
"property_id": "<string>",
"listing_ids": [
"<string>"
],
"match_method": "<string>",
"status": "matched",
"confidence": 123
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"details": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
]
},
"request_id": "<string>"
}Jobs
Request asynchronous read collection
Proposed interface. Enable only for documented and verified source/country capabilities. Apify/Bright Data async collection semantics
POST
/
v1
/
jobs
Request asynchronous read collection
curl --request POST \
--url https://realtycrawl.dev/v1/jobs \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"operation": "listings.search",
"params": {
"platforms": [
"<string>"
],
"location": {
"kind": "text",
"query": "<string>",
"country": "<string>"
},
"property_types": [
"<string>"
],
"status": [
"<string>"
],
"price": {
"min": 123,
"currency": "<string>",
"max": 123,
"unit_code": "<string>"
},
"bedrooms": {
"min": 123,
"max": 123
},
"bathrooms": {
"min": 123,
"max": 123
},
"listed_since": "2023-11-07T05:31:56Z",
"include": [],
"source_filters": {},
"limit": 20,
"cursor": "<string>",
"allow_partial": false,
"group_by_property": false
},
"max_items": 5000
}
'import requests
url = "https://realtycrawl.dev/v1/jobs"
payload = {
"operation": "listings.search",
"params": {
"platforms": ["<string>"],
"location": {
"kind": "text",
"query": "<string>",
"country": "<string>"
},
"property_types": ["<string>"],
"status": ["<string>"],
"price": {
"min": 123,
"currency": "<string>",
"max": 123,
"unit_code": "<string>"
},
"bedrooms": {
"min": 123,
"max": 123
},
"bathrooms": {
"min": 123,
"max": 123
},
"listed_since": "2023-11-07T05:31:56Z",
"include": [],
"source_filters": {},
"limit": 20,
"cursor": "<string>",
"allow_partial": False,
"group_by_property": False
},
"max_items": 5000
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
operation: 'listings.search',
params: {
platforms: ['<string>'],
location: {kind: 'text', query: '<string>', country: '<string>'},
property_types: ['<string>'],
status: ['<string>'],
price: {min: 123, currency: '<string>', max: 123, unit_code: '<string>'},
bedrooms: {min: 123, max: 123},
bathrooms: {min: 123, max: 123},
listed_since: '2023-11-07T05:31:56Z',
include: [],
source_filters: {},
limit: 20,
cursor: '<string>',
allow_partial: false,
group_by_property: false
},
max_items: 5000
})
};
fetch('https://realtycrawl.dev/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"id": "<string>",
"operation": "listings.search",
"status": "queued",
"created_at": "2023-11-07T05:31:56Z",
"result_count": 123,
"sources": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
],
"completed_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"schema_version": "<string>",
"generated_at": "2023-11-07T05:31:56Z",
"completeness": "complete",
"sources": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
],
"warnings": [
{
"code": "<string>",
"message": "<string>",
"field": "<string>"
}
],
"pagination": {
"next_cursor": "<string>",
"has_more": true,
"returned": 123,
"total": 123,
"total_relation": "exact"
},
"property_groups": [
{
"property_id": "<string>",
"listing_ids": [
"<string>"
],
"match_method": "<string>",
"status": "matched",
"confidence": 123
}
]
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"details": [
{
"platform": "<string>",
"status": "success",
"provider": "<string>",
"error_code": "<string>",
"truncated": true,
"observed_at": "2023-11-07T05:31:56Z"
}
]
},
"request_id": "<string>"
}This operation is defined in the API contract but is not currently enabled.
Check live capabilities before calling this operation. A documented contract does not imply active coverage for every source or country.
Authorizations
Body
application/json
⌘I