{"openapi":"3.1.0","info":{"title":"lobstr.io API","version":"2","description":"Structured data from websites, one call per page. Every operation is described in https://api.lobstr.io/v2/catalog.md."},"servers":[{"url":"https://api.lobstr.io"}],"security":[{"bearer":[]}],"paths":{"/v2/run":{"post":{"operationId":"run","summary":"Run one operation: one page of a list, or one item.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":255},"description":"Retry safely: the same key never runs or bills twice."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/google_maps.places.get.Request"},{"$ref":"#/components/schemas/google_maps.places.search.Request"},{"$ref":"#/components/schemas/google_maps.reviews.list.Request"},{"$ref":"#/components/schemas/google_news.articles.search.Request"},{"$ref":"#/components/schemas/lacentrale.listings.check.Request"},{"$ref":"#/components/schemas/lacentrale.listings.get.Request"},{"$ref":"#/components/schemas/lacentrale.listings.search.Request"},{"$ref":"#/components/schemas/leboncoin.listings.check.Request"},{"$ref":"#/components/schemas/leboncoin.listings.get.Request"},{"$ref":"#/components/schemas/leboncoin.listings.search.Request"},{"$ref":"#/components/schemas/leboncoin.phones.get.Request"},{"$ref":"#/components/schemas/realtor.listings.get.Request"},{"$ref":"#/components/schemas/realtor.listings.search.Request"},{"$ref":"#/components/schemas/seloger.listings.get.Request"},{"$ref":"#/components/schemas/seloger.listings.search.Request"},{"$ref":"#/components/schemas/websites.contacts.get.Request"},{"$ref":"#/components/schemas/x.profiles.get.Request"},{"$ref":"#/components/schemas/x.tweets.list.Request"},{"$ref":"#/components/schemas/x.tweets.search.Request"}]}}}},"responses":{"200":{"description":"The answer, its records in `results`","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/google_maps.places.get.Answer"},{"$ref":"#/components/schemas/google_maps.places.search.Answer"},{"$ref":"#/components/schemas/google_maps.reviews.list.Answer"},{"$ref":"#/components/schemas/google_news.articles.search.Answer"},{"$ref":"#/components/schemas/lacentrale.listings.check.Answer"},{"$ref":"#/components/schemas/lacentrale.listings.get.Answer"},{"$ref":"#/components/schemas/lacentrale.listings.search.Answer"},{"$ref":"#/components/schemas/leboncoin.listings.check.Answer"},{"$ref":"#/components/schemas/leboncoin.listings.get.Answer"},{"$ref":"#/components/schemas/leboncoin.listings.search.Answer"},{"$ref":"#/components/schemas/leboncoin.phones.get.Answer"},{"$ref":"#/components/schemas/realtor.listings.get.Answer"},{"$ref":"#/components/schemas/realtor.listings.search.Answer"},{"$ref":"#/components/schemas/seloger.listings.get.Answer"},{"$ref":"#/components/schemas/seloger.listings.search.Answer"},{"$ref":"#/components/schemas/websites.contacts.get.Answer"},{"$ref":"#/components/schemas/x.profiles.get.Answer"},{"$ref":"#/components/schemas/x.tweets.list.Answer"},{"$ref":"#/components/schemas/x.tweets.search.Answer"}]}}}},"default":{"description":"An error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/catalog":{"get":{"operationId":"catalog","summary":"Every operation, without a key.","security":[],"responses":{"200":{"description":"The operations"}}}},"/v2/catalog/{source}/{resource}/{verb}":{"get":{"operationId":"operation","summary":"One operation's public contract, without a key.","security":[],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string"}},{"name":"resource","in":"path","required":true,"schema":{"type":"string"}},{"name":"verb","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The contract"},"default":{"description":"An error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/catalog/{source}/{resource}/{verb}/status":{"get":{"operationId":"operation_status","summary":"How the operation's calls went, the last 90 days, a UTC day at a time, without a key.","security":[],"parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string"}},{"name":"resource","in":"path","required":true,"schema":{"type":"string"}},{"name":"verb","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Calls, successful calls and median duration per day"},"default":{"description":"An error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v2/balance":{"get":{"operationId":"balance","summary":"The credits the key's account can spend, and its plan with the price of one credit on it.","responses":{"200":{"description":"The balance"},"default":{"description":"An error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["type","code","message","request_id","retryable"],"properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"param":{"type":["string","null"]},"doc_url":{"type":["string","null"]},"request_id":{"type":"string"},"retryable":{"type":"boolean"},"retry_after":{"type":"integer"}}}}},"google_maps.places.get.Options":{"type":"object","additionalProperties":false,"required":["place"],"properties":{"place":{"type":"string","minLength":2,"maxLength":300,"description":"The place, however you know it: its Google place id (ChIJ..., a search's `id`), its cid (`ids.cid`), its feature id (`ids.feature_id`, 0x...:0x...), the link of its page on Google Maps as the browser shows it (a short maps.app.goo.gl link is not taken: open it and copy the page's link), or its name with its city as you would search it in Google Maps (\"Le Vieux Lyon, Lyon\"), for the place Google opens. A name Google answers with several places answers `ambiguous_query` with the first ones (free): send the one you mean.","examples":["ChIJ39Y-tdg1fYcRQcZcBb499do","15777584755905447489","Le Vieux Lyon, Lyon"]},"language":{"type":"string","pattern":"^[a-z]{2}$","default":"en","description":"The language of names, categories, hours and labels, as an ISO 639-1 code."},"country":{"type":"string","pattern":"^[a-z]{2}$","default":"us","description":"The country Google answers for, as an ISO 3166-1 alpha-2 code in lower case."}}},"google_maps.places.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","name","categories","primary_category_id","result_type","address","location","phone","website_url","rating","review_topics","description","owner_description","booking_url","hours","more_hours","timezone","attributes","highlights","actions","owner","ids","photo_url","url","source_url","observed_at","photos","related","inside","popular_times","admission","hotel","things_to_do"],"properties":{"object":{"const":"place","description":"The kind of record: a place, whichever site it comes from."},"id":{"type":"string","description":"Google's place id (ChIJ...), stable across languages; repeated in ids.place_id."},"name":{"type":"string"},"categories":{"type":"array","items":{"type":"string"},"description":"As Google Maps names them, the main one first."},"primary_category_id":{"type":["string","null"],"pattern":"^[a-z0-9_]+$","description":"The main category's id as Google files it, the same in every language: lebanese_restaurant, sewing_machine_store, cosmetic_dentist. Google gives it on a place's page for the main category alone; categories has every category's name, in the search's language."},"result_type":{"type":["string","null"],"pattern":"^[a-z0-9_]+$","description":"Google's search-result type for the place, the same in every language: a family for most places (shopping, industrial, personal_care), finer for some (french_restaurant, bakery, park). Not its category: categories has those by name, and places/get gives primary_category_id."},"address":{"type":"object","additionalProperties":false,"required":["full","street","neighborhood","city","postal_code","state","country_code"],"properties":{"full":{"type":["string","null"]},"street":{"type":["string","null"]},"neighborhood":{"type":["string","null"],"description":"The district Google files the place under: Manhattan."},"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"state":{"type":["string","null"],"description":"The state or region, where the address has one: New York."},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2","upper case.":null}}},"location":{"type":"object","additionalProperties":false,"required":["latitude","longitude"],"properties":{"latitude":{"type":"number","description":"Degrees, 7 decimals (about a centimetre)."},"longitude":{"type":"number","description":"Degrees, 7 decimals."}}},"phone":{"type":["string","null"],"pattern":"^\\+[0-9]{6,15}$","description":"E.164; null when Google gives no international number."},"website_url":{"type":["string","null"],"format":"uri"},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count","distribution"],"description":"The average rating and how many reviews make it; null when the place has none.","properties":{"value":{"type":"number"},"scale":{"const":5,"description":"The best possible value: ratings from other sites compare once divided by it."},"count":{"type":["integer","null"]},"distribution":{"type":["object","null"],"additionalProperties":false,"required":["1","2","3","4","5"],"description":"How many reviews give each number of stars, 1 to 5; they add up to count. Null when Google does not say.","properties":{"1":{"type":"integer"},"2":{"type":"integer"},"3":{"type":"integer"},"4":{"type":"integer"},"5":{"type":"integer"}}}}},"review_topics":{"type":["array","null"],"description":"The topics Google draws from the reviews (pleasant waiters), how many reviews mention each, and the id Google filters the reviews by; null when the answer has none (a list of results).","items":{"type":"object","additionalProperties":false,"required":["name","mentions","id"],"properties":{"name":{"type":"string"},"mentions":{"type":["integer","null"]},"id":{"type":["string","null"]}}}},"description":{"type":["string","null"],"description":"Google's short summary of the place, when it has one."},"owner_description":{"type":["string","null"],"description":"What the place says of itself on its profile, as its owner wrote it (From the owner); null when it says nothing."},"booking_url":{"type":["string","null"],"format":"uri"},"hours":{"type":["array","null"],"description":"The week, Monday first, in local time (`timezone`). A day closed has no interval; `intervals: null` is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.","items":{"type":"object","additionalProperties":false,"required":["day","intervals"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"intervals":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["open","close"],"properties":{"open":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time."},"close":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time; 24:00 is midnight."}}}}}}},"more_hours":{"type":"array","description":"Hours of a service apart from the place's own (Kitchen, Brunch, Takeout...), labelled in `language`.","items":{"type":"object","additionalProperties":false,"required":["label","hours"],"properties":{"label":{"type":"string"},"hours":{"type":["array","null"],"description":"The week, Monday first, in local time (`timezone`). A day closed has no interval; `intervals: null` is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.","items":{"type":"object","additionalProperties":false,"required":["day","intervals"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"intervals":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["open","close"],"properties":{"open":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time."},"close":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time; 24:00 is midnight."}}}}}}}}}},"timezone":{"type":["string","null"],"description":"IANA time zone."},"attributes":{"type":"array","description":"What Google lists about the place in its results (accessibility...). `id` is Google's own, the same in every language; `value` is true when the place has it.","items":{"type":"object","additionalProperties":false,"required":["id","label","group","value"],"properties":{"id":{"type":"string","examples":["has_wheelchair_accessible_entrance"]},"label":{"type":["string","null"]},"group":{"type":"string","examples":["accessibility"]},"value":{"type":["boolean","null"],"description":"true when Google shows the place has it; null for anything else it says."}}}},"highlights":{"type":"array","description":"Google's badges on the place: LGBTQ+ friendly, women-owned. `id` is the same in every language.","items":{"type":"object","additionalProperties":false,"required":["id","label"],"properties":{"id":{"type":["string","null"],"examples":["lgbtq_friendly"]},"label":{"type":"string"}}}},"actions":{"type":"array","description":"What people can do from Google: reserve a table, order online. `url` is Google's own page for it; `providers` are the services it sends to (OpenTable, a delivery service, the place's site).","items":{"type":"object","additionalProperties":false,"required":["type","label","url","providers"],"properties":{"type":{"enum":["reserve","order",null],"description":"null for a kind of action we do not name yet; `label` says it."},"label":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"providers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","domain","url"],"properties":{"name":{"type":"string"},"domain":{"type":"string"},"url":{"type":["string","null"],"format":"uri"}}}}}}},"owner":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"description":"The Google account that manages the place's profile, as Google shows it.","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"popular_times":{"type":["object","null"],"additionalProperties":false,"required":["week","live"],"description":"Google's \"Popular times\": for each day, how busy each hour usually is, 0 (empty) to 100 (busiest); and how busy it is now when Google says so (`live`, its label in `language`). null when Google shows none.","properties":{"week":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["day","hours"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"hours":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["hour","busyness"],"properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"busyness":{"type":"integer","minimum":0,"maximum":100}}}}}}},"live":{"type":["object","null"],"additionalProperties":false,"required":["hour","busyness","label"],"properties":{"hour":{"type":["integer","null"]},"busyness":{"type":"integer","minimum":0,"maximum":100},"label":{"type":["string","null"]}}}}},"admission":{"type":["object","null"],"additionalProperties":false,"required":["price","url","domain","offers"],"description":"What a visit costs, for a place one visits (a museum, a monument): the price Google shows, the official site, the sellers.","properties":{"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"url":{"type":["string","null"],"format":"uri"},"domain":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["seller","url","price"],"properties":{"seller":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}}}}}}},"hotel":{"type":["object","null"],"additionalProperties":false,"required":["check_in","check_out","price","similar"],"description":"For a hotel: the night Google prices, its price for that night, and the hotels Google compares it with.","properties":{"check_in":{"type":["string","null"],"format":"date"},"check_out":{"type":["string","null"],"format":"date"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"similar":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","feature_id","price","rating","note"],"properties":{"name":{"type":"string"},"feature_id":{"type":["string","null"]},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":"number"},"scale":{"const":5},"count":{"type":["integer","null"]}}},"note":{"type":["string","null"],"description":"What Google says the price includes: breakfast, parking."}}}}}},"things_to_do":{"type":"array","description":"The tours and activities Google offers at the place: title, seller, price, duration, rating.","items":{"type":"object","additionalProperties":false,"required":["title","url","seller","price","duration","rating"],"properties":{"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"seller":{"type":["string","null"]},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"duration":{"type":["string","null"],"description":"As Google writes it","7h.":null},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":"number"},"scale":{"const":5},"count":{"type":["integer","null"]}}}}}},"ids":{"type":"object","additionalProperties":false,"required":["place_id","cid","feature_id","kgmid"],"description":"Every id Google gives the place: the one another call or another tool may need.","properties":{"place_id":{"type":"string"},"cid":{"type":["string","null"],"description":"Customer id: the second half of feature_id, in decimal; google.com/maps?cid=<cid> opens the place."},"feature_id":{"type":["string","null"],"description":"Feature id (0x...:0x...), what reviews and photos are listed by."},"kgmid":{"type":["string","null"],"description":"Knowledge Graph id (/g/...)."}}},"photo_url":{"type":["string","null"],"format":"uri","description":"The place's main photo."},"url":{"type":"string","format":"uri","description":"The place on Google Maps (Maps URLs, query_place_id)."},"source_url":{"type":"string","format":"uri","description":"The place's page these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null},"photos":{"type":"array","description":"The photos on the place's page, full size.","items":{"type":"object","additionalProperties":false,"required":["url","width","height"],"properties":{"url":{"type":"string","format":"uri"},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]}}}},"related":{"type":"array","description":"What Google shows as \"People also search for\", by group, each place by its feature id (read it with places/get).","items":{"type":"object","additionalProperties":false,"required":["label","feature_ids"],"properties":{"label":{"type":"string"},"feature_ids":{"type":"array","items":{"type":"string"}}}}},"inside":{"type":"array","description":"The places inside this one: a shop in a museum, a stand in a market.","items":{"type":"object","additionalProperties":false,"required":["name","feature_id","kgmid","location"],"properties":{"name":{"type":"string"},"feature_id":{"type":"string"},"kgmid":{"type":["string","null"]},"location":{"type":"object","additionalProperties":false,"required":["latitude","longitude"],"properties":{"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}}}}}}},"google_maps.places.get.Request":{"type":"object","required":["source","operation"],"description":"One place's page on Google Maps, by its id, its link or its name, with everything places/search gives and its photos.","properties":{"source":{"const":"google_maps"},"operation":{"const":"places/get"},"options":{"$ref":"#/components/schemas/google_maps.places.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"google_maps.places.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"google_maps"},"operation":{"const":"places/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/google_maps.places.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/google_maps.places.get.Record"}}}},"google_maps.places.search.Options":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"What you would type in Google Maps' search box: a kind of place (\"dentist\"), a name, or both with a place (\"restaurants in Lyon\"). Results are ranked for `country` (default us) and written in `language` (default en): set them for a search elsewhere.","examples":["restaurants in Lyon","plumber"]},"near":{"type":"object","additionalProperties":false,"required":["lat","lng"],"description":"Optional: the point to search around, as the map would centre on it (\"bakery\" around a spot). Leave it out when the query names its place (\"restaurants in Lyon\", \"Le Vieux Lyon, Lyon\"): Google locates it, better than a guessed point. Left out with a query naming no place, Google uses the country.","properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lng":{"type":"number","minimum":-180,"maximum":180}}},"zoom":{"type":"integer","minimum":3,"maximum":20,"default":14,"description":"The map's zoom around `near`, from 3 (a continent) to 20 (a street). Google lists places from the whole area the map shows, ranked by relevance, not by distance: at 13 they spread about 4 km around `near`, at 15 about 1 km (a neighbourhood), at 17 a few hundred metres (a street). Used only with `near`."},"language":{"type":"string","pattern":"^[a-z]{2}$","default":"en","description":"The language of names, categories and hours, as an ISO 639-1 code."},"country":{"type":"string","pattern":"^[a-z]{2}$","default":"us","description":"The country Google ranks results for, as an ISO 3166-1 alpha-2 code in lower case."},"page":{"type":"integer","minimum":1,"maximum":20,"default":1,"description":"The page to start at; `next` in an answer goes on from it with `cursor`. Google Maps stops listing after 200 to 300 places, depending on the search: the last page is short, a page past the end is empty and free."},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the search it was given with (otherwise `invalid_cursor`). Leave it out to start at `page`."}}},"google_maps.places.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","name","categories","primary_category_id","result_type","address","location","phone","website_url","rating","review_topics","description","owner_description","booking_url","hours","more_hours","timezone","attributes","highlights","actions","owner","popular_times","admission","hotel","things_to_do","ids","photo_url","url","source_url","observed_at"],"properties":{"object":{"const":"place","description":"The kind of record: a place, whichever site it comes from."},"id":{"type":"string","description":"Google's place id (ChIJ...), stable across languages; repeated in ids.place_id."},"position":{"type":"integer","minimum":1,"description":"Its rank among the places of the search, across pages: 21 is the first of page 2."},"name":{"type":"string"},"categories":{"type":"array","items":{"type":"string"},"description":"As Google Maps names them, the main one first."},"primary_category_id":{"type":["string","null"],"pattern":"^[a-z0-9_]+$","description":"Null in a list of results: Google gives a place's category id only on its page (google_maps/places/get). result_type is the family a list does give."},"result_type":{"type":["string","null"],"pattern":"^[a-z0-9_]+$","description":"Google's search-result type for the place, the same in every language: a family for most places (shopping, industrial, personal_care), finer for some (french_restaurant, bakery, park). Not its category: categories has those by name, and places/get gives primary_category_id."},"address":{"type":"object","additionalProperties":false,"required":["full","street","neighborhood","city","postal_code","state","country_code"],"properties":{"full":{"type":["string","null"]},"street":{"type":["string","null"]},"neighborhood":{"type":["string","null"],"description":"The district Google files the place under: Manhattan."},"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"state":{"type":["string","null"],"description":"The state or region, where the address has one: New York."},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2","upper case.":null}}},"location":{"type":"object","additionalProperties":false,"required":["latitude","longitude"],"properties":{"latitude":{"type":"number","description":"Degrees, 7 decimals (about a centimetre)."},"longitude":{"type":"number","description":"Degrees, 7 decimals."}}},"phone":{"type":["string","null"],"pattern":"^\\+[0-9]{6,15}$","description":"E.164; null when Google gives no international number."},"website_url":{"type":["string","null"],"format":"uri"},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count","distribution"],"description":"The average rating and how many reviews make it; null when the place has none.","properties":{"value":{"type":"number"},"scale":{"const":5,"description":"The best possible value: ratings from other sites compare once divided by it."},"count":{"type":["integer","null"]},"distribution":{"type":["object","null"],"additionalProperties":false,"required":["1","2","3","4","5"],"description":"How many reviews give each number of stars, 1 to 5; they add up to count. Null when Google does not say. A list of results seldom has it; a search naming one place does.","properties":{"1":{"type":"integer"},"2":{"type":"integer"},"3":{"type":"integer"},"4":{"type":"integer"},"5":{"type":"integer"}}}}},"review_topics":{"type":["array","null"],"description":"The topics Google draws from the reviews (pleasant waiters), how many reviews mention each, and the id Google filters the reviews by; null when the answer has none (a list of results).","items":{"type":"object","additionalProperties":false,"required":["name","mentions","id"],"properties":{"name":{"type":"string"},"mentions":{"type":["integer","null"]},"id":{"type":["string","null"]}}}},"description":{"type":["string","null"],"description":"Google's short summary of the place, when it has one."},"owner_description":{"type":["string","null"],"description":"What the place says of itself on its profile, as its owner wrote it (From the owner); null when it says nothing."},"booking_url":{"type":["string","null"],"format":"uri"},"hours":{"type":["array","null"],"description":"The week, Monday first, in local time (`timezone`). A day closed has no interval; `intervals: null` is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.","items":{"type":"object","additionalProperties":false,"required":["day","intervals"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"intervals":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["open","close"],"properties":{"open":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time."},"close":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time; 24:00 is midnight."}}}}}}},"more_hours":{"type":"array","description":"Hours of a service apart from the place's own (Kitchen, Brunch, Takeout...), labelled in `language`.","items":{"type":"object","additionalProperties":false,"required":["label","hours"],"properties":{"label":{"type":"string"},"hours":{"type":["array","null"],"description":"The week, Monday first, in local time (`timezone`). A day closed has no interval; `intervals: null` is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.","items":{"type":"object","additionalProperties":false,"required":["day","intervals"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"intervals":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["open","close"],"properties":{"open":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time."},"close":{"type":"string","pattern":"^\\d{2}:\\d{2}$","description":"HH:MM, local time; 24:00 is midnight."}}}}}}}}}},"timezone":{"type":["string","null"],"description":"IANA time zone."},"attributes":{"type":"array","description":"What Google lists about the place in its results (accessibility...). `id` is Google's own, the same in every language; `value` is true when the place has it.","items":{"type":"object","additionalProperties":false,"required":["id","label","group","value"],"properties":{"id":{"type":"string","examples":["has_wheelchair_accessible_entrance"]},"label":{"type":["string","null"]},"group":{"type":"string","examples":["accessibility"]},"value":{"type":["boolean","null"],"description":"true when Google shows the place has it; null for anything else it says."}}}},"highlights":{"type":"array","description":"Google's badges on the place: LGBTQ+ friendly, women-owned. `id` is the same in every language.","items":{"type":"object","additionalProperties":false,"required":["id","label"],"properties":{"id":{"type":["string","null"],"examples":["lgbtq_friendly"]},"label":{"type":"string"}}}},"actions":{"type":"array","description":"What people can do from Google: reserve a table, order online. `url` is Google's own page for it; `providers` are the services it sends to (OpenTable, a delivery service, the place's site).","items":{"type":"object","additionalProperties":false,"required":["type","label","url","providers"],"properties":{"type":{"enum":["reserve","order",null],"description":"null for a kind of action we do not name yet; `label` says it."},"label":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"providers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","domain","url"],"properties":{"name":{"type":"string"},"domain":{"type":"string"},"url":{"type":["string","null"],"format":"uri"}}}}}}},"owner":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"description":"The Google account that manages the place's profile, as Google shows it.","properties":{"id":{"type":"string"},"name":{"type":"string"}}},"popular_times":{"type":["object","null"],"additionalProperties":false,"required":["week","live"],"description":"Google's \"Popular times\": for each day, how busy each hour usually is, 0 (empty) to 100 (busiest); and how busy it is now when Google says so (`live`, its label in `language`). null when Google shows none.","properties":{"week":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["day","hours"],"properties":{"day":{"enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"hours":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["hour","busyness"],"properties":{"hour":{"type":"integer","minimum":0,"maximum":23},"busyness":{"type":"integer","minimum":0,"maximum":100}}}}}}},"live":{"type":["object","null"],"additionalProperties":false,"required":["hour","busyness","label"],"properties":{"hour":{"type":["integer","null"]},"busyness":{"type":"integer","minimum":0,"maximum":100},"label":{"type":["string","null"]}}}}},"admission":{"type":["object","null"],"additionalProperties":false,"required":["price","url","domain","offers"],"description":"What a visit costs, for a place one visits (a museum, a monument): the price Google shows, the official site, the sellers.","properties":{"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"url":{"type":["string","null"],"format":"uri"},"domain":{"type":["string","null"]},"offers":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["seller","url","price"],"properties":{"seller":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}}}}}}},"hotel":{"type":["object","null"],"additionalProperties":false,"required":["check_in","check_out","price","similar"],"description":"For a hotel: the night Google prices, its price for that night, and the hotels Google compares it with.","properties":{"check_in":{"type":["string","null"],"format":"date"},"check_out":{"type":["string","null"],"format":"date"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"similar":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","feature_id","price","rating","note"],"properties":{"name":{"type":"string"},"feature_id":{"type":["string","null"]},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":"number"},"scale":{"const":5},"count":{"type":["integer","null"]}}},"note":{"type":["string","null"],"description":"What Google says the price includes: breakfast, parking."}}}}}},"things_to_do":{"type":"array","description":"The tours and activities Google offers at the place: title, seller, price, duration, rating.","items":{"type":"object","additionalProperties":false,"required":["title","url","seller","price","duration","rating"],"properties":{"title":{"type":"string"},"url":{"type":["string","null"],"format":"uri"},"seller":{"type":["string","null"]},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency","text"],"description":"A price: `amount` and `currency` (ISO 4217) when they read, null otherwise (\"$\" names several currencies); `text` as Google wrote it.","properties":{"amount":{"type":["number","null"]},"currency":{"type":["string","null"],"pattern":"^[A-Z]{3}$"},"text":{"type":"string"}}},"duration":{"type":["string","null"],"description":"As Google writes it","7h.":null},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":"number"},"scale":{"const":5},"count":{"type":["integer","null"]}}}}}},"ids":{"type":"object","additionalProperties":false,"required":["place_id","cid","feature_id","kgmid"],"description":"Every id Google gives the place: the one another call or another tool may need.","properties":{"place_id":{"type":"string"},"cid":{"type":["string","null"],"description":"Customer id: the second half of feature_id, in decimal; google.com/maps?cid=<cid> opens the place."},"feature_id":{"type":["string","null"],"description":"Feature id (0x...:0x...), what reviews and photos are listed by."},"kgmid":{"type":["string","null"],"description":"Knowledge Graph id (/g/...)."}}},"photo_url":{"type":["string","null"],"format":"uri","description":"The place's main photo."},"url":{"type":"string","format":"uri","description":"The place on Google Maps (Maps URLs, query_place_id)."},"source_url":{"type":"string","format":"uri","description":"The search these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"google_maps.places.search.Request":{"type":"object","required":["source","operation"],"description":"One page of places for a Google Maps search, 20 at most, as the results list shows them.","properties":{"source":{"const":"google_maps"},"operation":{"const":"places/search"},"options":{"$ref":"#/components/schemas/google_maps.places.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"google_maps.places.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"google_maps"},"operation":{"const":"places/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/google_maps.places.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/google_maps.places.search.Record"}}}},"google_maps.reviews.list.Options":{"type":"object","required":["place"],"additionalProperties":false,"properties":{"place":{"type":"string","pattern":"^(ChIJ[A-Za-z0-9_-]{23}|0x[0-9a-f]{1,16}:0x[0-9a-f]{1,16}|[0-9]{1,20}|https://(www\\.)?google\\.[a-z.]{2,6}/maps\\S*|https://maps\\.google\\.[a-z.]{2,6}/\\S*)$","description":"The place: its Google place id (ChIJ..., the `id` google_maps/places/search and places/get return), its cid (`ids.cid`, the number in a maps?cid= link), its feature id (`ids.feature_id`, 0x...:0x...), or the link of its page on Google Maps as the browser shows it. A short link (maps.app.goo.gl) is not taken: open it and copy the page's link. With only a name, get the place with google_maps/places/get first (1 credit).","examples":["ChIJ39Y-tdg1fYcRQcZcBb499do","15777584755905447489"]},"sort":{"enum":["newest","relevant","highest","lowest"],"default":"newest","description":"The order Google Maps offers: newest first, most relevant (its own), highest rating first, lowest first. `newest` is the order that reaches every review of a place; Google stops the others after about 1,500."},"language":{"type":"string","pattern":"^[a-z]{2}$","default":"en","description":"An ISO 639-1 code (a regional form such as pt-BR is not taken yet). Reviews written in it come first with `sort: relevant`, and aspect labels are written in it. `text` is always as its author wrote it (its `language` says which); a review written in another language also comes with Google's `translation` into this one."},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to continue, from `next` in an answer, as it is: opaque, and only for the place and sort it was given with (otherwise `invalid_cursor`)."}}},"google_maps.reviews.list.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","place","rating","text","language","translation","published_at","is_edited","visit","reaction_count","author","photo_urls","owner_reply","aspects","url","source_url","observed_at"],"properties":{"object":{"const":"review","description":"The kind of record: a review, whichever site it comes from."},"id":{"type":"string","description":"Google's id of the review, stable across languages and sorts."},"position":{"type":"integer","minimum":1,"description":"Its rank in this order, across pages: 11 is the first of page 2."},"place":{"type":"object","additionalProperties":false,"required":["cid","url"],"description":"The place reviewed, so reviews of several places can be told apart.","properties":{"cid":{"type":"string","pattern":"^[0-9]{1,20}$","description":"The place's cid, as google_maps/places/search gives it in `ids.cid`."},"url":{"type":"string","format":"uri","description":"The place on Google Maps."}}},"rating":{"type":"object","additionalProperties":false,"required":["value","scale"],"properties":{"value":{"type":"integer","minimum":1,"maximum":5},"scale":{"const":5,"description":"The best possible value."}}},"text":{"type":["string","null"],"description":"The author's own words, whole, in their language (`language`), line breaks as \\n; null for a rating alone. Quote this as what the author wrote."},"language":{"type":["string","null"],"description":"The text's language, ISO 639-1, as Google detects it."},"translation":{"type":["object","null"],"additionalProperties":false,"required":["language","text"],"description":"Google's translation of `text` into the call's `language`, when the review is written in another.","properties":{"language":{"type":"string","pattern":"^[a-z]{2}$"},"text":{"type":"string","description":"Google's machine translation, not the author's words: say so when you quote it."}}},"published_at":{"type":"string","format":"date-time","description":"When the review was posted, or last edited when `is_edited` (the first date is then not given), UTC. Tell reviews apart by `id`, never by date."},"is_edited":{"type":"boolean"},"visit":{"type":["object","null"],"additionalProperties":false,"required":["month","text"],"description":"When the author says they went, when they said.","properties":{"month":{"type":["string","null"],"pattern":"^[0-9]{4}-[0-9]{2}$","description":"YYYY-MM; null in a language we do not read yet."},"text":{"type":"string","description":"As Google writes it, in the call's language."}}},"reaction_count":{"type":["integer","null"],"minimum":0,"description":"People who reacted to the review (likes and other reactions)."},"author":{"type":"object","additionalProperties":false,"required":["name","id","url","photo_url","review_count","photo_count","is_local_guide"],"properties":{"name":{"type":"string"},"id":{"type":["string","null"],"description":"The author's Google Maps contributor id."},"url":{"type":["string","null"],"format":"uri","description":"The author's reviews on Google Maps."},"photo_url":{"type":["string","null"],"format":"uri"},"review_count":{"type":["integer","null"],"minimum":0,"description":"Reviews the author has written, all places."},"photo_count":{"type":["integer","null"],"minimum":0,"description":"Photos the author has posted, all places."},"is_local_guide":{"type":"boolean"}}},"photo_urls":{"type":"array","items":{"type":"string","format":"uri"},"description":"The photos posted with the review."},"owner_reply":{"type":["object","null"],"additionalProperties":false,"required":["text"],"description":"The place's reply, when it gave one (Google shows no date for it).","properties":{"text":{"type":"string"}}},"aspects":{"type":"array","description":"What the reviewer added beyond the text: a rating of an aspect (`rating`, 1 to 5), or answers to Google's questions (`answers`). `id` is stable across languages; `label` and the answers are in `language`.","items":{"type":"object","additionalProperties":false,"required":["id","label","rating","answers"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9_]+$","examples":["dining_food","dining_meal_type"]},"label":{"type":["string","null"]},"rating":{"type":["integer","null"],"minimum":1,"maximum":5},"answers":{"type":["array","null"],"items":{"type":"string"}}}}},"url":{"type":["string","null"],"format":"uri","description":"The review on Google Maps."},"source_url":{"type":"string","format":"uri","description":"The place whose reviews these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"google_maps.reviews.list.Request":{"type":"object","required":["source","operation"],"description":"One page of a Google Maps place's reviews, 10 at most, with their rating, text, author, photos and owner reply.","properties":{"source":{"const":"google_maps"},"operation":{"const":"reviews/list"},"options":{"$ref":"#/components/schemas/google_maps.reviews.list.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"google_maps.reviews.list.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"google_maps"},"operation":{"const":"reviews/list"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/google_maps.reviews.list.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/google_maps.reviews.list.Record"}}}},"google_news.articles.search.Options":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"The words to search, as typed in Google News' search box; its operators work (\"exact words\", OR, -word).","examples":["artificial intelligence","\"Jensen Huang\"","electric cars -Tesla"]},"edition":{"type":"string","enum":["AU:en","BW:en","CA:en","ET:en","GH:en","IN:en","ID:en","IE:en","IL:en","KE:en","LV:en","MY:en","NA:en","NZ:en","NG:en","PK:en","PH:en","SG:en","ZA:en","TZ:en","UG:en","GB:en","US:en","ZW:en","ID:id","MY:ms","ES:ca","CZ:cs","DE:de","AT:de","CH:de","EE:et","AR:es-419","CL:es-419","CO:es-419","CU:es-419","ES:es","US:es-419","MX:es-419","PE:es-419","VE:es-419","BE:fr","CA:fr","FR:fr","MA:fr","SN:fr","CH:fr","IT:it","LV:lv","LT:lt","HU:hu","BE:nl","NL:nl","NO:no","PL:pl","BR:pt-419","PT:pt-150","RO:ro","SK:sk","SI:sl","FI:fi","SE:sv","VN:vi","TR:tr","GR:el","BG:bg","RU:ru","UA:ru","RS:sr","UA:uk","IL:he","AE:ar","SA:ar","LB:ar","EG:ar","IN:mr","IN:hi","BD:bn","IN:bn","IN:pa","IN:gu","IN:ta","IN:te","IN:ml","TH:th","CN:zh-Hans","TW:zh-Hant","HK:zh-Hant","JP:ja","KR:ko"],"default":"US:en","description":"One of Google News' 90 editions, COUNTRY:language as Google writes it (its \"Language & region\" menu): US:en by default, GB:en, FR:fr, DE:de, IN:en, BR:pt-419... Google ranks and picks the articles for that edition's readers.","examples":["US:en","FR:fr","GB:en"]},"site":{"type":"string","description":"Only the articles of this publisher's domain (lemonde.fr, reuters.com).","examples":["reuters.com"]},"when":{"type":"string","enum":["1h","1d","7d"],"description":"Only the articles of the last hour, day or week. Not with `after` or `before`."},"after":{"type":"string","format":"date","description":"Only the articles published from this day (YYYY-MM-DD), which Google reads in US Pacific time. The articles of a search by day carry their day, not their hour (Google cuts their time to the day's midnight, Pacific)."},"before":{"type":"string","format":"date","description":"Only the articles published before this day (YYYY-MM-DD, US Pacific time). With `after`, a span of days."}}},"google_news.articles.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","title","url","amp_url","published_at","publisher","authors","image","story","ids","google_news_url","source_url","observed_at"],"properties":{"object":{"const":"article"},"id":{"type":"string","description":"The article's id: 16 characters, the same for its publisher's URL in every search and edition. Google's own id is ids.article_id."},"position":{"type":"integer","minimum":1,"description":"Its place in Google's ranking; a story's articles in their story's place."},"title":{"type":["string","null"],"description":"The title","as the publisher wrote it.":null},"url":{"type":["string","null"],"format":"uri","description":"The article at its publisher's (never Google's link)."},"amp_url":{"type":["string","null"],"format":"uri","description":"Its AMP page, when the publisher has one."},"published_at":{"type":["string","null"],"format":"date-time","description":"When it was published, UTC (a day's midnight, Pacific, in a search by `after`/`before`)."},"publisher":{"type":"object","additionalProperties":false,"required":["name","site","icon","id","google_news_url"],"properties":{"name":{"type":["string","null"]},"site":{"type":["string","null"],"description":"The publisher's site: https://www.lemonde.fr."},"icon":{"type":["string","null"],"description":"Its icon, as Google News shows it."},"id":{"type":["string","null"],"description":"Google News' id of the publisher, the same on all its articles; null for some smaller ones."},"google_news_url":{"type":["string","null"],"format":"uri","description":"The publisher's page on Google News."}}},"authors":{"type":"array","description":"The authors Google News names (about half the articles), each with their Google News page when it has one.","items":{"type":"object","additionalProperties":false,"required":["name","google_news_url"],"properties":{"name":{"type":"string"},"google_news_url":{"type":["string","null"],"format":"uri"}}}},"image":{"type":["object","null"],"additionalProperties":false,"required":["url","google_url","width","height"],"properties":{"url":{"type":["string","null"],"description":"The image at its publisher's."},"google_url":{"type":["string","null"],"description":"Google's copy of it, as the page shows it."},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]}}},"story":{"type":["object","null"],"additionalProperties":false,"required":["title","position"],"description":"The story Google groups the article in (three articles under its heading, in plain searches only); null for an article alone.","properties":{"title":{"type":["string","null"],"description":"Google's heading of the story."},"position":{"type":"integer","description":"The article's place in its story, 1 to 3."}}},"ids":{"type":"object","additionalProperties":false,"required":["article_id"],"description":"Every id Google News gives with the article.","properties":{"article_id":{"type":["string","null"],"description":"Google News' id of the article (CBMi...), the one in its own links: about 250 characters."}}},"google_news_url":{"type":["string","null"],"format":"uri","description":"The article's link on Google News."},"source_url":{"type":"string","format":"uri","description":"The search on news.google.com these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"google_news.articles.search.Request":{"type":"object","required":["source","operation"],"description":"The articles of a Google News search, up to 100, as Google ranks them, each with its publisher's URL.","properties":{"source":{"const":"google_news"},"operation":{"const":"articles/search"},"options":{"$ref":"#/components/schemas/google_news.articles.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"google_news.articles.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"google_news"},"operation":{"const":"articles/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/google_news.articles.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/google_news.articles.search.Record"}}}},"lacentrale.listings.check.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","minLength":7,"maxLength":1000,"description":"A LaCentrale listing reference (E120356577), numeric URL id (69120356577), or public auto/moto/quad/scooter listing URL, as lacentrale/listings/get takes it. Required; no default. Tracking query parameters are ignored.","examples":["https://www.lacentrale.fr/auto-occasion-annonce-66104376140.html","B104376140","69120356577"]}}},"lacentrale.listings.check.Record":{"type":"object","additionalProperties":false,"required":["object","listing_id","url","status","published_date","updated_at","publication_ended_at","source_url","observed_at"],"properties":{"object":{"const":"listing_status"},"listing_id":{"type":"string","description":"LaCentrale's reference of the listing (B104376140), the `id` of lacentrale/listings/search and lacentrale/listings/get."},"url":{"type":"string","format":"uri","description":"The listing's address. For a listing given by its reference or numeric id that LaCentrale no longer holds, the auto address, which serves every vehicle family."},"status":{"type":"string","description":"online: the listing is online. blocked: LaCentrale's own word for a listing it has taken offline and still holds, whether sold, withdrawn by its seller or expired (LaCentrale does not say which); its page says the listing is no longer available. gone: LaCentrale holds nothing under this id, a listing offline for long (two weeks offline are still held, three months are not) or an id that never was. Another word is LaCentrale's own for a state it adds, given as it is, in lower case.","examples":["online","blocked","gone"]},"published_date":{"type":["string","null"],"format":"date","description":"The day the listing first went online, as LaCentrale's search gives it. Null for a listing no longer online, and for a listing online that the search does not show yet."},"updated_at":{"type":["string","null"],"format":"date-time","description":"When the listing was last updated, UTC, as LaCentrale's search gives it. Null as published_date."},"publication_ended_at":{"type":["string","null"],"format":"date-time","description":"For a blocked listing, the end of its publication as LaCentrale keeps it: the moment it went offline, on the listings checked. Null otherwise."},"source_url":{"type":"string","format":"uri","description":"The listing's page on lacentrale.fr."},"observed_at":{"type":"string","format":"date-time","description":"When they were read, UTC."}}},"lacentrale.listings.check.Request":{"type":"object","required":["source","operation"],"description":"Whether a LaCentrale vehicle listing is still online, with its dates.","properties":{"source":{"const":"lacentrale"},"operation":{"const":"listings/check"},"options":{"$ref":"#/components/schemas/lacentrale.listings.check.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"lacentrale.listings.check.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"lacentrale"},"operation":{"const":"listings/check"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/lacentrale.listings.check.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/lacentrale.listings.check.Record"}}}},"lacentrale.listings.get.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","minLength":7,"maxLength":1000,"description":"A LaCentrale listing reference (E120356577), numeric URL id (69120356577), or public auto/moto/quad/scooter listing URL. Required; no default. Bare references and numeric ids use the auto route, which also serves motorcycle ids; the returned URL uses the actual vehicle family. Tracking query parameters are ignored.","examples":["E120356577","69120356577","https://www.lacentrale.fr/moto-occasion-annonce-69120223417.html"]}}},"lacentrale.listings.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","url","title","description","status","price","is_vat_recoverable","deal_rating","estimated_value","valuation_confidence","price_history","age_days","is_age_capped","publication_ends_at","vehicle","equipment","options","packs","equipment_highlights","equipment_by_ai","highlights","warranty","history","maintenance","declared_repairs","financing","photos","photo_groups","seller","location","valuation_url","technical_specifications_url","ids","source_url","observed_at"],"properties":{"object":{"const":"listing"},"id":{"type":"string","description":"LaCentrale reference, such as E120356577; the same id returned by listings/search."},"url":{"type":"string","format":"uri","description":"Canonical listing URL. A motorcycle id also works through the auto route; this URL uses its actual family."},"title":{"type":["string","null"]},"description":{"type":["string","null"],"description":"Complete seller comment, with line breaks preserved. Null when the seller supplied none."},"status":{"type":["string","null"],"description":"Source publication status in lower case, normally online."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"is_vat_recoverable":{"type":["boolean","null"]},"deal_rating":{"type":["string","null"]},"estimated_value":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}},"description":"LaCentrale estimated market value, when supplied; not the asking price."},"valuation_confidence":{"type":["integer","null"],"description":"Native reliabilityIndex of the valuation. Not a seller rating."},"price_history":{"type":"object","additionalProperties":false,"required":["initial","current","prices","change_percent","has_dropped","is_initial_crossed_out","dated_prices"],"properties":{"initial":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"current":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"prices":{"type":"array","items":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}}},"change_percent":{"type":["number","null"]},"has_dropped":{"type":["boolean","null"]},"is_initial_crossed_out":{"type":["boolean","null"]},"dated_prices":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","price"],"properties":{"date":{"type":["string","null"]},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}}}}}},"description":"Native price history. The prices array has no dates; dated_prices contains only source-dated events."},"age_days":{"type":["integer","null"],"description":"Displayed age in days from priceVariation; can be capped. Not converted into an inferred publication date."},"is_age_capped":{"type":["boolean","null"],"description":"Whether LaCentrale caps the displayed age."},"publication_ends_at":{"type":["string","null"],"format":"date-time","description":"Publication end supplied by LaCentrale. Its 2999 date denotes an open-ended publication."},"vehicle":{"type":"object","additionalProperties":false,"required":["make","model","commercial_name","version","exterior_color","interior_color","first_registration_date","doors","seats","engine_capacity_cm3","power_hp","fiscal_power_cv","length_mm","boot_capacity_l","owners_count","is_imported","detailed_model","motorization","trim","is_new_generation","registration_type","height_mm","width_mm","weight_kg","power_kw","family","category","energy","gearbox","year","mileage_km","is_first_hand","average_mileage_km","mileage_rating","equipment_level","test_standard","original_new_price","consumption","emissions","battery"],"properties":{"make":{"type":["string","null"]},"model":{"type":["string","null"]},"commercial_name":{"type":["string","null"]},"version":{"type":["string","null"],"description":"Full version/trim as supplied by the listing."},"exterior_color":{"type":["string","null"]},"interior_color":{"type":["string","null"]},"first_registration_date":{"type":["string","null"],"description":"First registration date, YYYY-MM-DD."},"doors":{"type":["integer","null"]},"seats":{"type":["integer","null"]},"engine_capacity_cm3":{"type":["integer","null"]},"power_hp":{"type":["integer","null"],"description":"DIN horsepower (ch)."},"fiscal_power_cv":{"type":["integer","null"],"description":"French fiscal horsepower (CV)."},"length_mm":{"type":["integer","null"]},"boot_capacity_l":{"type":["integer","null"],"description":"Boot volume in litres from maxTrunkVolume. Not asserted to be volume with seats folded."},"owners_count":{"type":["integer","null"],"description":"Number of owners shown on the page, not an inferred count from first-hand status."},"is_imported":{"type":["boolean","null"],"description":"The listing/reference-vehicle international flag; separate from the history report finding."},"detailed_model":{"type":["string","null"]},"motorization":{"type":["string","null"]},"trim":{"type":["string","null"]},"is_new_generation":{"type":["boolean","null"]},"registration_type":{"type":["string","null"],"description":"French registration-system code from the reference vehicle, such as SIV."},"height_mm":{"type":["integer","null"]},"width_mm":{"type":["integer","null"]},"weight_kg":{"type":["integer","null"]},"power_kw":{"type":["integer","null"],"description":"Maximum engine power in kilowatts in the reference specifications."},"family":{"type":["string","null"],"description":"auto, moto, quad or scooter. auto includes utility vehicles."},"category":{"type":["string","null"],"description":"Native category code, lower case; e.g. tous_chemins, berline or pick_up."},"energy":{"type":["string","null"],"description":"Native energy code, lower case; e.g. diesel, essence, electrique."},"gearbox":{"type":["string","null"],"description":"Native gearbox code, lower case; e.g. automatique or mecanique."},"year":{"type":["integer","null"]},"mileage_km":{"type":["integer","null"]},"is_first_hand":{"type":["boolean","null"]},"average_mileage_km":{"type":["integer","null"],"description":"LaCentrale expected mileage for a comparable vehicle of this age."},"mileage_rating":{"type":["string","null"]},"equipment_level":{"type":["integer","null"],"description":"Native equipment level code. The page also supplies equipment highlights."},"test_standard":{"type":["string","null"],"description":"Measurement standard supplied by the source, such as NEDC or WLTP."},"original_new_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}},"description":"Reference vehicle price when new, not the current asking price."},"consumption":{"type":"object","additionalProperties":false,"required":["highway_l_per_100km","road_l_per_100km","city_l_per_100km","combined_l_per_100km","low_l_per_100km","medium_l_per_100km","high_l_per_100km","extra_high_l_per_100km","is_reliable"],"properties":{"highway_l_per_100km":{"type":["number","null"]},"road_l_per_100km":{"type":["number","null"]},"city_l_per_100km":{"type":["number","null"]},"combined_l_per_100km":{"type":["number","null"]},"low_l_per_100km":{"type":["integer","null"]},"medium_l_per_100km":{"type":["number","null"]},"high_l_per_100km":{"type":["number","null"]},"extra_high_l_per_100km":{"type":["number","null"]},"is_reliable":{"type":["boolean","null"]}},"description":"Fuel consumption in L/100 km. Source zeros are retained; reliability is supplied separately."},"emissions":{"type":"object","additionalProperties":false,"required":["co2_g_per_km","is_reliable","eco_bonus_malus","euro_standard","critair_class","has_conversion_allowance"],"properties":{"co2_g_per_km":{"type":["integer","null"]},"is_reliable":{"type":["boolean","null"]},"eco_bonus_malus":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"euro_standard":{"type":["string","null"]},"critair_class":{"type":["string","null"]},"has_conversion_allowance":{"type":["boolean","null"]}}},"battery":{"type":"object","additionalProperties":false,"required":["capacity_kwh","consumption_kwh_per_100km","current_a","voltage_v","range_km","is_plug_in","is_included_in_price","statistical_health"],"properties":{"capacity_kwh":{"type":["integer","null"],"description":"Battery capacity as listed in kWh. The source does not specify whether this is gross or usable capacity."},"consumption_kwh_per_100km":{"type":["number","null"]},"current_a":{"type":["number","null"]},"voltage_v":{"type":["number","null"]},"range_km":{"type":["integer","null"],"description":"Listed electric range in kilometres. No measured range or adjustment for this vehicle's battery health is implied."},"is_plug_in":{"type":["boolean","null"],"description":"Whether it can be plugged in; true for a pure electric vehicle too. Does not mean plug-in hybrid."},"is_included_in_price":{"type":["boolean","null"]},"statistical_health":{"type":["object","null"],"additionalProperties":false,"required":["estimated_percent","lower_percent","upper_percent","is_near_new","is_range","displayed_percent","badge"],"properties":{"estimated_percent":{"type":["integer","null"]},"lower_percent":{"type":["integer","null"]},"upper_percent":{"type":["integer","null"]},"is_near_new":{"type":["boolean","null"],"description":"Source flag for a near-new battery-health label."},"is_range":{"type":["boolean","null"],"description":"Source flag for presenting the lower-to-upper range."},"displayed_percent":{"type":["integer","null"],"description":"Source display-value percentage. Can coexist with is_range; it must not be described as the only visible value when the range is shown."},"badge":{"type":["string","null"]}},"description":"Statistical state-of-health estimate, explicitly NOT a measured battery certificate. Bounds are percentages."}},"description":"Source electric specifications. Zero placeholders become null because the page calls them unavailable."}}},"equipment":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["category","name"],"properties":{"category":{"type":["string","null"]},"name":{"type":["string","null"]}}},"description":"Complete equipment list in source order, including repeated categories with the site’s own labels."},"options":{"type":"array","items":{"type":["string","null"]},"description":"Additional options explicitly supplied by the seller."},"packs":{"type":"array","items":{"type":["string","null"]},"description":"Equipment packs supplied by the listing."},"equipment_highlights":{"type":"array","items":{"type":["string","null"]},"description":"Short equipment selection shown prominently on the page."},"equipment_by_ai":{"type":"array","items":{"type":["string","null"]},"description":"Equipment labels selected by LaCentrale’s AI. Kept separate from the full seller/reference equipment list."},"highlights":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","value"],"properties":{"label":{"type":["string","null"]},"value":{"type":["string","null"]}}},"description":"The page’s labelled strengths, such as warranty duration or low mileage."},"warranty":{"type":"object","additionalProperties":false,"required":["details","months","label","description","summary","is_partner","manufacturer_months","manufacturer_max_km","manufacturer_ends_on","original_months","original_max_km","certification"],"properties":{"details":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","value","description"],"properties":{"label":{"type":["string","null"]},"value":{"type":["string","null"]},"description":{"type":["string","null"],"description":"Additional warranty terms displayed by the page."}}}},"months":{"type":["integer","null"],"description":"Advertised commercial/network warranty duration in MONTHS, including values such as 2 months."},"label":{"type":["string","null"]},"description":{"type":["string","null"]},"summary":{"type":["string","null"]},"is_partner":{"type":["boolean","null"]},"manufacturer_months":{"type":["integer","null"],"description":"Manufacturer warranty duration from reference data. Does not assert that it is still valid."},"manufacturer_max_km":{"type":["integer","null"]},"manufacturer_ends_on":{"type":["string","null"],"format":"date","description":"Explicit manufacturer-warranty expiry date supplied by the site; no expiry is inferred from duration alone."},"original_months":{"type":["integer","null"],"description":"Warranty duration in the vehicle’s original technical specifications, in months."},"original_max_km":{"type":["integer","null"],"description":"Mileage limit in original specifications. 999999 is the source’s unlimited sentinel."},"certification":{"type":["object","null"],"additionalProperties":false,"required":["name","label","value","logo_url","description","url","is_partner"],"properties":{"name":{"type":["string","null"]},"label":{"type":["string","null"]},"value":{"type":["string","null"]},"logo_url":{"type":["string","null"],"format":"uri"},"description":{"type":"array","items":{"type":["string","null"]}},"url":{"type":["string","null"],"format":"uri"},"is_partner":{"type":["boolean","null"]}},"description":"Certified-used programme, including its logo, description and programme page."}}},"history":{"type":"object","additionalProperties":false,"required":["has_report","has_claims","has_professional_use","has_atypical_operations","is_imported","report_url"],"properties":{"has_report":{"type":["boolean","null"]},"has_claims":{"type":["boolean","null"],"description":"Whether the preview reports expert assessments/claims. False is not a guarantee of no past accident."},"has_professional_use":{"type":["boolean","null"],"description":"Whether the history preview detects professional usage."},"has_atypical_operations":{"type":["boolean","null"],"description":"Whether the source history preview reports atypical operations."},"is_imported":{"type":["boolean","null"]},"report_url":{"type":["string","null"],"format":"uri"}},"description":"Findings shown in LaCentrale’s Autoviza preview; the linked full report is not fetched."},"maintenance":{"type":"object","additionalProperties":false,"required":["has_schedule","status","count","message","period","period_from","period_to","before","after"],"properties":{"has_schedule":{"type":["boolean","null"]},"status":{"type":["string","null"]},"count":{"type":["integer","null"]},"message":{"type":["string","null"]},"period":{"type":["string","null"]},"period_from":{"type":["string","null"],"description":"First month of the displayed maintenance period, YYYY-MM."},"period_to":{"type":["string","null"],"description":"Last month of the displayed maintenance period, YYYY-MM."},"before":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","reason","month","mileage_km","distance_since_due_km","months_since_due","is_next","interval","interval_unit","occurrence","labour_hours","status","labour_cost","parts_cost","total_cost","parts","oil_cost"],"properties":{"name":{"type":["string","null"]},"reason":{"type":["string","null"]},"month":{"type":["string","null"]},"mileage_km":{"type":["integer","null"]},"distance_since_due_km":{"type":["integer","null"]},"months_since_due":{"type":["number","null"]},"is_next":{"type":["boolean","null"]},"interval":{"type":["integer","null"]},"interval_unit":{"type":["string","null"]},"occurrence":{"type":["integer","null"]},"labour_hours":{"type":["number","null"]},"status":{"type":["string","null"]},"labour_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"parts_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"total_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"parts":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","cost"],"properties":{"name":{"type":["string","null"]},"cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}}}}},"oil_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}}}},"description":"Estimated maintenance operations in the source’s before group, in its order."},"after":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","reason","month","mileage_km","distance_since_due_km","months_since_due","is_next","interval","interval_unit","occurrence","labour_hours","status","labour_cost","parts_cost","total_cost","parts","oil_cost"],"properties":{"name":{"type":["string","null"]},"reason":{"type":["string","null"]},"month":{"type":["string","null"]},"mileage_km":{"type":["integer","null"]},"distance_since_due_km":{"type":["integer","null"]},"months_since_due":{"type":["number","null"]},"is_next":{"type":["boolean","null"]},"interval":{"type":["integer","null"]},"interval_unit":{"type":["string","null"]},"occurrence":{"type":["integer","null"]},"labour_hours":{"type":["number","null"]},"status":{"type":["string","null"]},"labour_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":["number","null"]},"currency":{"const":"EUR"}}},"parts_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":["number","null"]},"currency":{"const":"EUR"}}},"total_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":["number","null"]},"currency":{"const":"EUR"}}},"parts":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","cost"],"properties":{"name":{"type":["string","null"]},"cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":["number","null"]},"currency":{"const":"EUR"}}}}}},"oil_cost":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":["number","null"]},"currency":{"const":"EUR"}}}}},"description":"Estimated maintenance operations in the source’s after group, in its order."}},"description":"Manufacturer maintenance estimates shown by LaCentrale, not a service book or proof of completed work."},"declared_repairs":{"type":"array","items":{"type":["string","null"]},"description":"Repairs declared by the seller, not independently verified repairs."},"financing":{"type":"object","additionalProperties":false,"required":["has_loan","has_lease","loan_monthly_price","lease_monthly_price","loan_name","lease_name"],"properties":{"has_loan":{"type":["boolean","null"]},"has_lease":{"type":["boolean","null"]},"loan_monthly_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"lease_monthly_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number"},"currency":{"const":"EUR"}}},"loan_name":{"type":["string","null"]},"lease_name":{"type":["string","null"]}},"description":"Displayed monthly loan/lease teasers and availability, not a binding loan offer. Generic lender calculator settings are excluded."},"photos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","url","mobile_url","original_url","mobile_original_url","video_url","type","category","group_id","score"],"properties":{"id":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"mobile_url":{"type":["string","null"],"format":"uri"},"original_url":{"type":["string","null"],"format":"uri"},"mobile_original_url":{"type":["string","null"],"format":"uri"},"video_url":{"type":["string","null"],"format":"uri"},"type":{"type":["string","null"]},"category":{"type":["string","null"]},"group_id":{"type":["string","null"]},"score":{"type":["integer","null"],"description":"Native gallery ordering/selection score, not vehicle quality."}}},"description":"Gallery entries in display order. Video entries have type video, a thumbnail URL and video_url."},"photo_groups":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","first_photo_index"],"properties":{"id":{"type":["string","null"]},"label":{"type":["string","null"]},"first_photo_index":{"type":["integer","null"]}}},"description":"Gallery categories; first_photo_index is zero-based in photos."},"seller":{"type":"object","additionalProperties":false,"required":["type","name","kind","kind_label","company_created_at","is_verified","is_broker","is_distance_seller","listings_count","url","address","has_phone","has_email","has_whatsapp","whatsapp_phone","phones","services","presentation","logo_url","website_url","banners","contacts","opening_status","has_opening_hours","opening_hours","rating","reviews_url","reviews"],"properties":{"type":{"type":["string","null"]},"name":{"type":["string","null"]},"kind":{"type":["string","null"]},"kind_label":{"type":["string","null"]},"company_created_at":{"type":["string","null"],"format":"date-time"},"is_verified":{"type":["boolean","null"]},"is_broker":{"type":["boolean","null"]},"is_distance_seller":{"type":["boolean","null"]},"listings_count":{"type":["integer","null"]},"url":{"type":["string","null"],"format":"uri"},"address":{"type":"object","additionalProperties":false,"required":["street","postal_code","city","country","latitude","longitude"],"properties":{"street":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"city":{"type":["string","null"]},"country":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}},"description":"Seller/showroom address. Do not assume this is the vehicle’s exact position."},"has_phone":{"type":["boolean","null"]},"has_email":{"type":["boolean","null"]},"has_whatsapp":{"type":["boolean","null"]},"whatsapp_phone":{"type":["object","null"],"additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"]},"as_written":{"type":["string","null"]}}},"phones":{"type":"array","description":"Public phone numbers decoded from the page. Includes both displayed and forwarded numbers when supplied.","items":{"type":"object","additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"]},"as_written":{"type":["string","null"]}}}},"services":{"type":"array","items":{"type":["string","null"]}},"presentation":{"type":["string","null"]},"logo_url":{"type":["string","null"],"format":"uri"},"website_url":{"type":["string","null"],"format":"uri"},"banners":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["format","mobile_url","desktop_url"],"properties":{"format":{"type":["string","null"]},"mobile_url":{"type":["string","null"],"format":"uri"},"desktop_url":{"type":["string","null"],"format":"uri"}}}},"contacts":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["first_name","last_name","title","phone"],"properties":{"first_name":{"type":["string","null"]},"last_name":{"type":["string","null"]},"title":{"type":["string","null"]},"phone":{"type":"object","additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"]},"as_written":{"type":["string","null"]}}}}}},"opening_status":{"type":["string","null"],"description":"Status displayed when the page was fetched, in French."},"has_opening_hours":{"type":["boolean","null"]},"opening_hours":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["day","hours"],"properties":{"day":{"type":["string","null"]},"hours":{"type":"array","items":{"type":["string","null"]}}}},"description":"French local opening intervals as written, e.g. 09h00-12h00 or Fermé; weekday names are English."},"rating":{"type":["object","null"],"additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":["number","null"]},"scale":{"type":["integer","null"]},"count":{"type":["integer","null"]}},"description":"Seller rating shown on LaCentrale, out of 5, with the total review count."},"reviews_url":{"type":["string","null"],"format":"uri"},"reviews":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["author","published_at","rating","text"],"properties":{"author":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"rating":{"type":"object","additionalProperties":false,"required":["value","scale","count"],"properties":{"value":{"type":["integer","null"]},"scale":{"type":["integer","null"]},"count":{"type":["number","null"]}}},"text":{"type":["string","null"]}}},"description":"The review preview included in the listing page, not all seller reviews."}}},"location":{"type":"object","additionalProperties":false,"required":["department","postal_code","is_listing_location"],"properties":{"department":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"is_listing_location":{"type":["boolean","null"],"description":"Whether the page chooses the classified location rather than the seller’s location."}}},"valuation_url":{"type":["string","null"],"format":"uri"},"technical_specifications_url":{"type":["string","null"],"format":"uri"},"ids":{"type":"object","additionalProperties":false,"required":["listing_id","url_id","seller_reference","customer_reference","owner_correlation_id","version_id","warranty_id","vehicle_id","financing_siret"],"properties":{"listing_id":{"type":["string","null"]},"url_id":{"type":["string","null"]},"seller_reference":{"type":["string","null"]},"customer_reference":{"type":["string","null"]},"owner_correlation_id":{"type":["string","null"]},"version_id":{"type":["string","null"]},"warranty_id":{"type":["string","null"]},"vehicle_id":{"type":["string","null"]},"financing_siret":{"type":["string","null"],"description":"SIRET supplied with the financing input; not asserted to be the seller’s independently verified SIRET."}}},"source_url":{"type":"string","format":"uri","description":"Normalized URL actually requested, with tracking query parameters removed."},"observed_at":{"type":"string","format":"date-time","description":"When this listing was read, in UTC."}},"description":"One public LaCentrale vehicle listing, including its complete equipment and seller details."},"lacentrale.listings.get.Request":{"type":"object","required":["source","operation"],"description":"One complete LaCentrale vehicle listing: description, specifications, equipment, photos, history preview, warranties and public seller details.","properties":{"source":{"const":"lacentrale"},"operation":{"const":"listings/get"},"options":{"$ref":"#/components/schemas/lacentrale.listings.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"lacentrale.listings.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"lacentrale"},"operation":{"const":"listings/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/lacentrale.listings.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/lacentrale.listings.get.Record"}}}},"lacentrale.listings.search.Options":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","description":"A https://www.lacentrale.fr/listing search URL. Defaults: page 1, cars and utility vehicles (vertical=carTruck), the site’s relevance order, no other filters. Use makesModelsCommercialNames=RENAULT:CLIO (semicolon-separated choices), energies=dies,ess,elec,hyb,plug_hyb,not_plug_hyb,gpl,eth,alt; priceMin/Max in euros, yearMin/Max in calendar years and mileageMin/Max in kilometres. Sort with sortBy=firstOnlineDateDesc (newest), priceAsc/Desc, mileageAsc/Desc, firstTrafficDateAsc/Desc or proximityAsc/Desc. Supports the site’s other typed /listing filters; unknown parameters are refused. Page is one-based and limited to 347: at most 7,981 results. Narrow filters to retrieve more. Ranking uses the French proxy’s location unless continuing with next; it may differ from a personal browser with another location or seed.","format":"uri","pattern":"^https://(www\\.)?lacentrale\\.fr/listing/?(\\?.*)?$","examples":["https://www.lacentrale.fr/listing?energies=dies&sortBy=firstOnlineDateDesc","https://www.lacentrale.fr/listing?makesModelsCommercialNames=RENAULT:CLIO&energies=ess&priceMax=20000"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). It keeps the ranking of the first page (its seed and location) across pages. Leave it out to start at the URL's page."}}},"lacentrale.listings.search.Record":{"type":"object","description":"One standard search result; separately promoted slots are excluded.","additionalProperties":false,"required":["object","id","position","url","title","price","ranking_score","vehicle","is_new_listing","is_new_vehicle","deal_rating","has_vehicle_history","published_date","updated_at","recent_price_drop_until","location","seller","photos","warranty","financing","delivery","publication_options","ids","source_url","observed_at"],"properties":{"object":{"const":"listing"},"id":{"type":"string","description":"LaCentrale reference, such as W103592947."},"position":{"type":"integer","description":"One-based position across pages: 24 is the first result of page 2.","minimum":1},"url":{"type":"string","description":"Public listing URL on lacentrale.fr.","format":"uri"},"title":{"type":["string","null"],"description":"Card title: manufacturer and commercial model name."},"price":{"type":["object","null"],"description":"An amount in euros.","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number","description":"Amount in euros."},"currency":{"const":"EUR"}}},"ranking_score":{"type":["number","null"],"description":"Native ranking score, dependent on the search context; not a vehicle quality rating."},"vehicle":{"type":"object","description":"Vehicle specifications supplied by the search.","additionalProperties":false,"required":["make","model","commercial_name","detailed_model","version","trim","motorization","category","family","energy","gearbox","year","mileage_km","doors","exterior_color"],"properties":{"make":{"type":["string","null"],"description":"Manufacturer, in the site’s spelling: RENAULT, BMW."},"model":{"type":["string","null"],"description":"Model family: CLIO, X1."},"commercial_name":{"type":["string","null"],"description":"Commercial model name, including its generation where supplied: CLIO 5, X1 F48."},"detailed_model":{"type":["string","null"],"description":"Detailed model designation: BMW X1 F48 phase 2."},"version":{"type":["string","null"],"description":"Full version shown below the title, including engine and trim."},"trim":{"type":["string","null"],"description":"Trim level: XLINE, INTENS."},"motorization":{"type":["string","null"],"description":"Engine designation, as supplied; may combine displacement and power or electric power and battery capacity."},"category":{"type":["string","null"],"description":"Native category code: CITADINE, COMPACTE, SUV_4X4_CROSSOVER, SPORTIVE, etc."},"family":{"type":["string","null"],"description":"Native vehicle family: AUTO, UTILITY, MOTO, QUAD, SCOOTER."},"energy":{"type":["string","null"],"description":"Native fuel code: DIESEL, ESSENCE, ELECTRIC, HYBRID, PLUGIN_HYBRID, NOT_PLUGIN_HYBRID, etc."},"gearbox":{"type":["string","null"],"description":"MANUAL or AUTO, when supplied."},"year":{"type":["integer","null"],"description":"Vehicle year shown on the search card."},"mileage_km":{"type":["integer","null"],"description":"Odometer reading, in kilometres; zero is retained."},"doors":{"type":["integer","null"],"description":"Number of doors; the site supplies zero for some motorcycles."},"exterior_color":{"type":["string","null"],"description":"Exterior colour as written by the seller; may be a commercial colour name."}}},"is_new_listing":{"type":["boolean","null"],"description":"The Nouveauté badge: recently listed, distinct from a new vehicle."},"is_new_vehicle":{"type":["boolean","null"],"description":"The site’s neuf flag: the vehicle is advertised as new, distinct from a recently posted listing."},"deal_rating":{"type":["string","null"],"description":"Native price assessment: VERY_GOOD_DEAL, GOOD_DEAL, EQUITABLE_DEAL, BAD_DEAL; null when absent."},"has_vehicle_history":{"type":["boolean","null"],"description":"An Autoviza vehicle history report is available."},"published_date":{"type":["string","null"],"description":"First online date. The search supplies a date only, not a time.","format":"date"},"updated_at":{"type":["string","null"],"description":"The listing’s last update, converted from Unix seconds to UTC.","format":"date-time"},"recent_price_drop_until":{"type":["string","null"],"description":"Expiry of the recent price-drop badge, not the date of a price change; priceDropLimitDate.","format":"date-time"},"location":{"type":"object","description":"","additionalProperties":false,"required":["country","department","distance_km"],"properties":{"country":{"type":["string","null"],"description":"Country code, usually FR."},"department":{"type":["string","null"],"description":"Department code, not a postal code: 59, 2A."},"distance_km":{"type":["number","null"],"description":"Distance from the search location when the service supplies _distanceKm."}}},"seller":{"type":"object","description":"","additionalProperties":false,"required":["id","type","kind","name","phones"],"properties":{"id":{"type":["string","null"],"description":"Public seller reference."},"type":{"type":["string","null"],"description":"pro or private; null for an unknown source type."},"kind":{"type":["string","null"],"description":"Native seller category: CONCESSIONNAIRE, CENTRE_MULTIMARQUES, PART, DISTANCE, etc."},"name":{"type":["string","null"],"description":"Published seller name; null when none is given."},"phones":{"type":"array","description":"Public phone numbers present in the search payload, in order, without duplicates.","items":{"type":"object","description":"","additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"],"description":"Phone in international format when recognisable."},"as_written":{"type":"string","description":"Public phone as supplied, decoded from displayPhone1/2."}}}}}},"photos":{"type":"object","description":"","additionalProperties":false,"required":["urls","count","updated_at","has_exterior_360","has_photosphere"],"properties":{"urls":{"type":"array","description":"Main photo and mobile image URLs, in source order, without exact duplicates; includes size variants, not necessarily every listing photo.","items":{"type":"string","description":"Image URL.","format":"uri"}},"count":{"type":["integer","null"],"description":"Total photo count reported by the site; may exceed the supplied URLs."},"updated_at":{"type":["string","null"],"description":"Timestamp attached to the site’s photo count (picturesCountDate).","format":"date-time"},"has_exterior_360":{"type":["boolean","null"],"description":"An exterior 360-degree view is available."},"has_photosphere":{"type":["boolean","null"],"description":"A photosphere is available."}}},"warranty":{"type":"object","description":"","additionalProperties":false,"required":["months","manufacturer_until","has_extension"],"properties":{"months":{"type":["integer","null"],"description":"Warranty duration in months (manufacturerWarrantyDuration). Detail pages label it Garantie: verified 2 and 12 months; not necessarily a manufacturer warranty."},"manufacturer_until":{"type":["string","null"],"description":"End date of the manufacturer warranty (constructorWarrantyDate).","format":"date"},"has_extension":{"type":["boolean","null"],"description":"The site’s extendedWarranty flag."}}},"financing":{"type":["object","null"],"description":"Advertised monthly loan and lease (LOA) amounts; not a total cost or a binding finance quote.","additionalProperties":false,"required":["id","valid_until","loan_monthly_price","lease_monthly_price"],"properties":{"id":{"type":["string","null"],"description":"Financing offer identifier."},"valid_until":{"type":["string","null"],"description":"Validity limit supplied as limitDateV2.","format":"date-time"},"loan_monthly_price":{"type":["object","null"],"description":"An amount in euros.","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number","description":"Amount in euros."},"currency":{"const":"EUR"}}},"lease_monthly_price":{"type":["object","null"],"description":"An amount in euros.","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number","description":"Amount in euros."},"currency":{"const":"EUR"}}}}},"delivery":{"type":["object","null"],"description":"Delivery information when supplied.","additionalProperties":false,"required":["available","max_distance_km","prices"],"properties":{"available":{"type":["boolean","null"],"description":"Delivery is active on this listing."},"max_distance_km":{"type":["number","null"],"description":"Maximum delivery distance, in kilometres."},"prices":{"type":"array","description":"Delivery price bands in source order. The search does not label their distance brackets.","items":{"type":["object","null"],"description":"An amount in euros.","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"number","description":"Amount in euros."},"currency":{"const":"EUR"}}}}}},"publication_options":{"type":"array","description":"Publication options attached to the listing, such as DELIVERY, PHOTO_360 and STRENGTHS; an option is not proof a feature is filled.","items":{"type":"string","description":"Native option code."}},"ids":{"type":"object","description":"","additionalProperties":false,"required":["listing_id","url_id","customer_reference","owner_correlation_id"],"properties":{"listing_id":{"type":"string","description":"Same reference as id."},"url_id":{"type":"string","description":"Numeric identifier in the public listing URL."},"customer_reference":{"type":["string","null"],"description":"Public seller reference."},"owner_correlation_id":{"type":["string","null"],"description":"Owner reference supplied by the site."}}},"source_url":{"type":"string","description":"Canonical listing search URL for this page.","format":"uri"},"observed_at":{"type":"string","description":"Time the response was read, in UTC.","format":"date-time"}}},"lacentrale.listings.search.Request":{"type":"object","required":["source","operation"],"description":"One LaCentrale page: up to 23 vehicles with specifications and public seller phones, for 23 credits per nonempty call even when limit returns fewer records.","properties":{"source":{"const":"lacentrale"},"operation":{"const":"listings/search"},"options":{"$ref":"#/components/schemas/lacentrale.listings.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"lacentrale.listings.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"lacentrale"},"operation":{"const":"listings/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/lacentrale.listings.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/lacentrale.listings.search.Record"}}}},"leboncoin.listings.check.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","pattern":"^([0-9]+|https://www\\.leboncoin\\.fr/ad/[a-z_]+/[0-9]+)$","description":"The listing's id, or its URL as it appears in the browser.","examples":["3000000001","https://www.leboncoin.fr/ad/voitures/3000000001"]}}},"leboncoin.listings.check.Record":{"type":"object","required":["object","listing_id","url","status","status_code","published_at","republished_at","expires_at","source_url","observed_at"],"properties":{"object":{"const":"listing_status"},"listing_id":{"type":"string","description":"Leboncoin's listing id."},"url":{"type":["string","null"],"format":"uri","description":"The listing's address. Null for a listing gone that was given by its id alone: the id does not say its category, and Leboncoin no longer does."},"status":{"type":"string","description":"active: online, shown in searches. paused: its seller paused it; its page still shows it, searches no longer do. gone: no longer online, whether it expired, was deleted by its seller or by Leboncoin, was sold, or never existed: Leboncoin answers all of these the same way, so no one can tell them apart. Another word is Leboncoin's own for a state it adds, given as it is.","examples":["active","paused","gone"]},"status_code":{"type":"integer","description":"Leboncoin's HTTP status for the listing, 200 when it is online, 410 when it is gone."},"published_at":{"type":["string","null"],"format":"date-time","description":"When the listing was first published, UTC. Null when it is gone."},"republished_at":{"type":["string","null"],"format":"date-time","description":"When it last went back to the top of the searches (a renewal, an edit, a paid option), UTC."},"expires_at":{"type":["string","null"],"format":"date-time","description":"When Leboncoin will take it offline unless renewed, UTC, when Leboncoin says so (some listings only)."},"source_url":{"type":"string","format":"uri","description":"The page or address these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"leboncoin.listings.check.Request":{"type":"object","required":["source","operation"],"description":"Whether a leboncoin.fr listing is still online (active, paused by its seller, or gone), with its dates.","properties":{"source":{"const":"leboncoin"},"operation":{"const":"listings/check"},"options":{"$ref":"#/components/schemas/leboncoin.listings.check.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"leboncoin.listings.check.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"leboncoin"},"operation":{"const":"listings/check"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/leboncoin.listings.check.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/leboncoin.listings.check.Record"}}}},"leboncoin.listings.get.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","pattern":"^([0-9]+|https://www\\.leboncoin\\.fr/ad/[a-z_]+/[0-9]+)$","description":"The listing's id, or its URL as it appears in the browser.","examples":["3000000001","https://www.leboncoin.fr/ad/ventes_immobilieres/3000000001"]}}},"leboncoin.listings.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","featured","url","title","description","category","ad_type","status","price","buyer_fee","shipping","published_at","republished_at","expires_at","has_phone","is_boosted","paid_options","photos","photo_count","videos","location","seller","attributes","calendar","ids","favorites","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","pattern":"^[0-9]+$","description":"Leboncoin's listing id; repeated in ids.listing_id."},"featured":{"type":"boolean","description":"The listing has Leboncoin's \"À la une\" option (paid): searches show it with that badge, and at their top when sorted by date."},"url":{"type":"string","format":"uri","description":"The listing on leboncoin.fr."},"title":{"type":"string"},"description":{"type":["string","null"],"description":"The seller's text, as written (line breaks kept)."},"category":{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's category id: 2 cars, 9 property sales, 10 rentals..."},"name":{"type":"string","description":"As Leboncoin names it","in French.":null}}},"ad_type":{"type":"string","enum":["offer","demand"],"description":"An offer (selling, renting, hiring) or a demand (looking for)."},"status":{"type":"string","description":"Leboncoin's status of the listing: active on a search page."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the listing shows; null when it shows none (jobs, gifts).","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"buyer_fee":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"What Leboncoin adds for a buyer who pays on the site (its buyer protection); null when it does not apply.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"shipping":{"type":"array","description":"The ways the seller ships, each with its price; empty when the listing is hand to hand only.","items":{"type":"object","additionalProperties":false,"required":["type","price","base_price"],"properties":{"type":{"type":["string","null"],"description":"Leboncoin's name of the carrier or service: mondial_relay, shop2shop, colissimo, custom_shipping..."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the listing shows; null when it shows none (jobs, gifts).","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"base_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price before Leboncoin's discount, when it shows one.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}}}}},"published_at":{"type":"string","format":"date-time","description":"The first publication, UTC."},"republished_at":{"type":"string","format":"date-time","description":"The date the listing shows and \"Plus récentes\" sorts by, UTC: its first publication, or the last time it was put back on top (an option, an edit)."},"expires_at":{"type":["string","null"],"format":"date-time","description":"When the listing goes offline unless renewed, UTC; null when Leboncoin does not say."},"has_phone":{"type":"boolean","description":"The listing shows a \"Voir le numéro\" button: leboncoin/phones/get reads its number."},"is_boosted":{"type":"boolean","description":"Leboncoin's own flag for a listing pushed by an option."},"paid_options":{"type":"object","additionalProperties":false,"required":["urgent","gallery","photosup","sub_toplist","continuous_top_ads","highlight","booster","has_option"],"description":"The options the seller paid for, under Leboncoin's own names: urgent (the Urgent badge), photosup (more photos), booster and continuous_top_ads (put back on top), gallery, sub_toplist, highlight; has_option when any is on.","properties":{"urgent":{"type":"boolean"},"gallery":{"type":"boolean"},"photosup":{"type":"boolean"},"sub_toplist":{"type":"boolean"},"continuous_top_ads":{"type":"boolean"},"highlight":{"type":"boolean"},"booster":{"type":"boolean"},"has_option":{"type":"boolean"}}},"photos":{"type":"array","description":"Every photo, in the listing's order, at the largest size Leboncoin serves.","items":{"type":"object","additionalProperties":false,"required":["url","is_floor_plan"],"properties":{"url":{"type":"string","format":"uri"},"is_floor_plan":{"type":"boolean","description":"Leboncoin's own reading of the photo as a floor plan (property listings)."}}}},"photo_count":{"type":"integer","minimum":0},"videos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","provider","id"],"properties":{"url":{"type":"string","format":"uri"},"provider":{"type":["string","null"],"description":"youtube","...":null},"id":{"type":["string","null"],"description":"The video's id at its provider."}}}},"location":{"type":"object","additionalProperties":false,"required":["city","postal_code","district","department","region","country_code","latitude","longitude","precision","from_address"],"properties":{"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"district":{"type":["string","null"],"description":"The part of the city, when the seller gave an address: Golfe Juan in Vallauris."},"department":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's id: the department's number (13, 2A), or its own for a region."},"name":{"type":["string","null"]}}},"region":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's id: the department's number (13, 2A), or its own for a region."},"name":{"type":["string","null"]}},"description":"The region as Leboncoin files it (its former regions: Aquitaine, Rhône-Alpes)."},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2."},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"precision":{"type":["string","null"],"enum":["street_number","street","district","city",null],"description":"What the point stands for, as Leboncoin says; null when it does not say."},"from_address":{"type":"boolean","description":"The seller gave an address; otherwise only a city, and the point stands for the city."}}},"seller":{"type":"object","additionalProperties":false,"required":["type","id","name","store_id","siren","activity_sector","no_salesmen","fees_url"],"properties":{"type":{"type":"string","enum":["private","pro"]},"id":{"type":["string","null"],"description":"Leboncoin's user id."},"name":{"type":["string","null"],"description":"The seller's name as the listing shows it: a pseudonym, or the shop's name."},"store_id":{"type":["string","null"],"description":"The seller's store on Leboncoin (private sellers have one too)."},"siren":{"type":["string","null"],"description":"French company number","professional sellers who gave it.":null},"activity_sector":{"type":["string","null"],"description":"Leboncoin's id of a professional seller's sector."},"no_salesmen":{"type":"boolean","description":"The seller refuses canvassing."},"fees_url":{"type":["string","null"],"format":"uri","description":"A professional's page of fees (estate agents' scales)."}}},"attributes":{"type":"array","description":"Every attribute Leboncoin gives the listing, in its order and under its own key: the ones the page shows (brand, mileage, rooms, energy rating...), with their French labels, and the others (the seller's rating_score and rating_count, the car's price positioning...). Nothing a category adds is lost.","items":{"type":"object","additionalProperties":false,"required":["key","label","value","value_label","values","values_label"],"properties":{"key":{"type":"string"},"label":{"type":["string","null"],"description":"The French label the page shows, null for one it does not show."},"value":{"type":["string","null"]},"value_label":{"type":["string","null"]},"values":{"type":"array","items":{"type":"string"},"description":"Every value of a list (equipment","options).":null},"values_label":{"type":["array","null"],"items":{"type":"string"}}}}},"calendar":{"type":["object","null"],"additionalProperties":false,"required":["min_price","periods"],"description":"Holiday rentals only, null otherwise; the periods the seller set, open or closed, each with its price.","properties":{"min_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The lowest price of the calendar.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"periods":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["status","start_date","end_date","price"],"properties":{"status":{"type":["string","null"],"description":"open or closed."},"start_date":{"type":["string","null"],"format":"date"},"end_date":{"type":["string","null"],"format":"date"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the seller set for the period; null for a closed one.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}}}}}}},"ids":{"type":"object","additionalProperties":false,"required":["listing_id","user_id","store_id"],"description":"Every id Leboncoin gives with the listing.","properties":{"listing_id":{"type":"string"},"user_id":{"type":["string","null"]},"store_id":{"type":["string","null"]}}},"favorites":{"type":["integer","null"],"minimum":0,"description":"How many people saved the listing to their favorites, as Leboncoin counts them; given by a listing read alone, never by a search."},"source_url":{"type":"string","format":"uri","description":"The listing's page on leboncoin.fr these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"leboncoin.listings.get.Request":{"type":"object","required":["source","operation"],"description":"One leboncoin.fr listing, whole, by its id or URL, with a search's fields and how many people saved it.","properties":{"source":{"const":"leboncoin"},"operation":{"const":"listings/get"},"options":{"$ref":"#/components/schemas/leboncoin.listings.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"leboncoin.listings.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"leboncoin"},"operation":{"const":"listings/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/leboncoin.listings.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/leboncoin.listings.get.Record"}}}},"leboncoin.listings.search.Options":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","pattern":"^https://www\\.leboncoin\\.fr/recherche/?(\\?.*)?$","description":"A leboncoin.fr search, exactly as the browser shows it once the search is set up (category, place, filters, keywords, sort), its `page` the page to start at (page=2 is the second page). Sort by date, newest first, with sort=time&order=desc (\"Plus récentes\"). Every filter of the site is read; a parameter Leboncoin does not filter on is refused, never ignored.","examples":["https://www.leboncoin.fr/recherche?category=9&locations=Lyon__45.76_4.83_7308_5000__d69&real_estate_type=2&sort=time&order=desc","https://www.leboncoin.fr/recherche?category=2&price=min-3000&regdate=2016-max","https://www.leboncoin.fr/recherche?text=v%C3%A9lo+%C3%A9lectrique&shippable=1"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the search it was given with (otherwise `invalid_cursor`). Leave it out to start at the URL's page. It goes on where the previous page ended, as Leboncoin's own next page does: a page reached by its URL alone is read as a link to it shows it, and Leboncoin may skip the listings that the featured copies of the page before pushed down."}}},"leboncoin.listings.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","featured","url","title","description","category","ad_type","status","price","buyer_fee","shipping","published_at","republished_at","expires_at","has_phone","is_boosted","paid_options","photos","photo_count","videos","location","seller","attributes","calendar","ids","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","pattern":"^[0-9]+$","description":"Leboncoin's listing id; repeated in ids.listing_id."},"position":{"type":"integer","minimum":1,"description":"Its place among the cards the search shows, across pages (35 a page): 36 is the first of page 2. A featured copy has a place of its own, as on the page."},"featured":{"type":"boolean","description":"Shown with Leboncoin's \"À la une\" badge at this place (a paid option). Sorted by date, Leboncoin also puts such listings at the top of the page: the same listing then comes twice, featured at the top and in its own place by date, as the page shows it."},"url":{"type":"string","format":"uri","description":"The listing on leboncoin.fr."},"title":{"type":"string"},"description":{"type":["string","null"],"description":"The seller's text, as written (line breaks kept)."},"category":{"type":"object","additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's category id: 2 cars, 9 property sales, 10 rentals..."},"name":{"type":"string","description":"As Leboncoin names it","in French.":null}}},"ad_type":{"type":"string","enum":["offer","demand"],"description":"An offer (selling, renting, hiring) or a demand (looking for)."},"status":{"type":"string","description":"Leboncoin's status of the listing: active on a search page."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the listing shows; null when it shows none (jobs, gifts).","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"buyer_fee":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"What Leboncoin adds for a buyer who pays on the site (its buyer protection); null when it does not apply.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"shipping":{"type":"array","description":"The ways the seller ships, each with its price; empty when the listing is hand to hand only.","items":{"type":"object","additionalProperties":false,"required":["type","price","base_price"],"properties":{"type":{"type":["string","null"],"description":"Leboncoin's name of the carrier or service: mondial_relay, shop2shop, colissimo, custom_shipping..."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the listing shows; null when it shows none (jobs, gifts).","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"base_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price before Leboncoin's discount, when it shows one.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}}}}},"published_at":{"type":"string","format":"date-time","description":"The first publication, UTC."},"republished_at":{"type":"string","format":"date-time","description":"The date the listing shows and \"Plus récentes\" sorts by, UTC: its first publication, or the last time it was put back on top (an option, an edit)."},"expires_at":{"type":["string","null"],"format":"date-time","description":"When the listing goes offline unless renewed, UTC; null when Leboncoin does not say."},"has_phone":{"type":"boolean","description":"The listing shows a \"Voir le numéro\" button: leboncoin/phones/get reads its number."},"is_boosted":{"type":"boolean","description":"Leboncoin's own flag for a listing pushed by an option."},"paid_options":{"type":"object","additionalProperties":false,"required":["urgent","gallery","photosup","sub_toplist","continuous_top_ads","highlight","booster","has_option"],"description":"The options the seller paid for, under Leboncoin's own names: urgent (the Urgent badge), photosup (more photos), booster and continuous_top_ads (put back on top), gallery, sub_toplist, highlight; has_option when any is on.","properties":{"urgent":{"type":"boolean"},"gallery":{"type":"boolean"},"photosup":{"type":"boolean"},"sub_toplist":{"type":"boolean"},"continuous_top_ads":{"type":"boolean"},"highlight":{"type":"boolean"},"booster":{"type":"boolean"},"has_option":{"type":"boolean"}}},"photos":{"type":"array","description":"Every photo, in the listing's order, at the largest size Leboncoin serves.","items":{"type":"object","additionalProperties":false,"required":["url","is_floor_plan"],"properties":{"url":{"type":"string","format":"uri"},"is_floor_plan":{"type":"boolean","description":"Leboncoin's own reading of the photo as a floor plan (property listings)."}}}},"photo_count":{"type":"integer","minimum":0},"videos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","provider","id"],"properties":{"url":{"type":"string","format":"uri"},"provider":{"type":["string","null"],"description":"youtube","...":null},"id":{"type":["string","null"],"description":"The video's id at its provider."}}}},"location":{"type":"object","additionalProperties":false,"required":["city","postal_code","district","department","region","country_code","latitude","longitude","precision","from_address"],"properties":{"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"district":{"type":["string","null"],"description":"The part of the city, when the seller gave an address: Golfe Juan in Vallauris."},"department":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's id: the department's number (13, 2A), or its own for a region."},"name":{"type":["string","null"]}}},"region":{"type":["object","null"],"additionalProperties":false,"required":["id","name"],"properties":{"id":{"type":"string","description":"Leboncoin's id: the department's number (13, 2A), or its own for a region."},"name":{"type":["string","null"]}},"description":"The region as Leboncoin files it (its former regions: Aquitaine, Rhône-Alpes)."},"country_code":{"type":["string","null"],"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2."},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"precision":{"type":["string","null"],"enum":["street_number","street","district","city",null],"description":"What the point stands for, as Leboncoin says; null when it does not say."},"from_address":{"type":"boolean","description":"The seller gave an address; otherwise only a city, and the point stands for the city."}}},"seller":{"type":"object","additionalProperties":false,"required":["type","id","name","store_id","siren","activity_sector","no_salesmen","fees_url"],"properties":{"type":{"type":"string","enum":["private","pro"]},"id":{"type":["string","null"],"description":"Leboncoin's user id."},"name":{"type":["string","null"],"description":"The seller's name as the listing shows it: a pseudonym, or the shop's name."},"store_id":{"type":["string","null"],"description":"The seller's store on Leboncoin (private sellers have one too)."},"siren":{"type":["string","null"],"description":"French company number","professional sellers who gave it.":null},"activity_sector":{"type":["string","null"],"description":"Leboncoin's id of a professional seller's sector."},"no_salesmen":{"type":"boolean","description":"The seller refuses canvassing."},"fees_url":{"type":["string","null"],"format":"uri","description":"A professional's page of fees (estate agents' scales)."}}},"attributes":{"type":"array","description":"Every attribute Leboncoin gives the listing, in its order and under its own key: the ones the page shows (brand, mileage, rooms, energy rating...), with their French labels, and the others (the seller's rating_score and rating_count, the car's price positioning...). Nothing a category adds is lost.","items":{"type":"object","additionalProperties":false,"required":["key","label","value","value_label","values","values_label"],"properties":{"key":{"type":"string"},"label":{"type":["string","null"],"description":"The French label the page shows, null for one it does not show."},"value":{"type":["string","null"]},"value_label":{"type":["string","null"]},"values":{"type":"array","items":{"type":"string"},"description":"Every value of a list (equipment","options).":null},"values_label":{"type":["array","null"],"items":{"type":"string"}}}}},"calendar":{"type":["object","null"],"additionalProperties":false,"required":["min_price","periods"],"description":"Holiday rentals only, null otherwise; the periods the seller set, open or closed, each with its price.","properties":{"min_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The lowest price of the calendar.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}},"periods":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["status","start_date","end_date","price"],"properties":{"status":{"type":["string","null"],"description":"open or closed."},"start_date":{"type":["string","null"],"format":"date"},"end_date":{"type":["string","null"],"format":"date"},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price the seller set for the period; null for a closed one.","properties":{"amount":{"type":"number"},"currency":{"const":"EUR","description":"ISO 4217."}}}}}}}},"ids":{"type":"object","additionalProperties":false,"required":["listing_id","user_id","store_id"],"description":"Every id Leboncoin gives with the listing.","properties":{"listing_id":{"type":"string"},"user_id":{"type":["string","null"]},"store_id":{"type":["string","null"]}}},"source_url":{"type":"string","format":"uri","description":"The search page these values were read from, its page included."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"leboncoin.listings.search.Request":{"type":"object","required":["source","operation"],"description":"One page of a leboncoin.fr search, 35 listings at most, exactly as the page shows them, descriptions included.","properties":{"source":{"const":"leboncoin"},"operation":{"const":"listings/search"},"options":{"$ref":"#/components/schemas/leboncoin.listings.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"leboncoin.listings.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"leboncoin"},"operation":{"const":"listings/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/leboncoin.listings.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/leboncoin.listings.search.Record"}}}},"leboncoin.phones.get.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","pattern":"^([0-9]+|https://www\\.leboncoin\\.fr/ad/[a-z_]+/[0-9]+)$","description":"The listing's id, or its URL as it appears in the browser.","examples":["3000000001","https://www.leboncoin.fr/ad/locations/3000000001"]},"account":{"type":"string","pattern":"^acc_[A-Za-z0-9]+$","description":"The connected Leboncoin account to read with (GET /v2/accounts). Left out, the platform takes the first of your Leboncoin accounts with a free slot."}}},"leboncoin.phones.get.Record":{"type":"object","required":["object","listing_id","listing_url","phone","account","source_url","observed_at"],"properties":{"object":{"const":"phone"},"listing_id":{"type":"string","description":"Leboncoin's listing id."},"listing_url":{"type":["string","null"],"format":"uri","description":"The listing's address when it was given as a URL; null for an id alone (it does not say the category)."},"phone":{"type":"object","required":["status","number","tracking_number","is_mobile"],"properties":{"status":{"type":"string","enum":["found","none"],"description":"found; none when Leboncoin gave no number: the listing has no \"Voir le numéro\" button (a seller who does not want calls shows none, `has_phone` false), or it is no longer online. Leboncoin answers both the same way; whether a listing is still online is leboncoin/listings/check's question."},"number":{"type":["string","null"],"description":"The seller's own number, E.164 (+33...)."},"tracking_number":{"type":["string","null"],"description":"The relay number Leboncoin shows instead when the seller has call tracking (a call to it reaches the seller and is counted for them), E.164; null when the listing shows the seller's own number."},"is_mobile":{"type":["boolean","null"]}}},"account":{"type":"string","description":"The connected account the number was read with."},"source_url":{"type":"string","format":"uri","description":"The page these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"leboncoin.phones.get.Request":{"type":"object","required":["source","operation"],"description":"The phone number a seller shows on one leboncoin.fr listing, read with a connected Leboncoin account.","properties":{"source":{"const":"leboncoin"},"operation":{"const":"phones/get"},"options":{"$ref":"#/components/schemas/leboncoin.phones.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"leboncoin.phones.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"leboncoin"},"operation":{"const":"phones/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/leboncoin.phones.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/leboncoin.phones.get.Record"}}}},"realtor.listings.get.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","minLength":6,"maxLength":300,"description":"The listing: its realtor.com property id (`id` in realtor/listings/search, 6113301329), or its address on realtor.com (https://www.realtor.com/realestateandhomes-detail/..._M61133-01329; a builder's plan: ..._P417000943857).","examples":["6113301329","https://www.realtor.com/realestateandhomes-detail/335-S-Biscayne-Blvd-Apt-3400_Miami_FL_33131_M61133-01329"]}}},"realtor.listings.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","url","status","mls_status","property_type","property_subtype","style","plan_name","description","price","last_sold","hoa_fee","tax_amount","beds","baths","baths_full","baths_half","living_area_sqft","lot_sqft","stories","garage_spaces","year_built","listed_at","days_on_mls","address","location","neighborhoods","features","tags","photos","photo_count","tours","open_houses","flags","agents","buyer_agents","contact_phone","mls","builder","community","price_history","tax_history","permits","schools","environmental_risk","estimates","mortgage","other_listings","ai_distribution_suppressed","display_suppressed","ids","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","description":"realtor.com's property id (6113301329); repeated in ids.property_id."},"url":{"type":"string","description":"The listing on realtor.com."},"status":{"type":"string","description":"realtor.com's status: for_sale, sold, off_market, ready_to_build..."},"mls_status":{"type":["string","null"],"description":"The status as the MLS writes it (Active, Pending, Closed)."},"property_type":{"type":"string","description":"single_family, condos, townhomes, multi_family, coop, land..."},"property_subtype":{"type":["string","null"]},"style":{"type":["string","null"]},"plan_name":{"type":["string","null"],"description":"A builder's plan's name; null for a home."},"description":{"type":"string","description":"The listing's description, as its agent wrote it."},"price":{"type":"object","additionalProperties":false,"required":["amount","currency","per_sqft","last_change"],"properties":{"amount":{"type":"number"},"currency":{"type":"string"},"per_sqft":{"type":["number","null"]},"last_change":{"type":["number","null"]}},"description":"The asking price, its price per square foot, and its last change (negative: a cut)."},"last_sold":{"type":"object","additionalProperties":false,"required":["date","price"],"properties":{"date":{"type":["string","null"]},"price":{"type":["number","null"]}},"description":"The property's last sale, when realtor.com shows it."},"hoa_fee":{"type":["number","null"],"description":"The HOA fee, USD a month."},"tax_amount":{"type":["number","null"],"description":"The yearly property tax the MLS states, USD."},"beds":{"type":"number"},"baths":{"type":"number","description":"Bathrooms, a half bath counting 0.5."},"baths_full":{"type":"number"},"baths_half":{"type":["number","null"]},"living_area_sqft":{"type":"number","description":"Square feet."},"lot_sqft":{"type":["number","null"],"description":"Square feet."},"stories":{"type":["number","null"]},"garage_spaces":{"type":["number","null"],"description":"Garage spaces."},"year_built":{"type":["number","null"]},"listed_at":{"type":"string","description":"When it was listed on realtor.com, UTC."},"days_on_mls":{"type":["number","null"],"description":"Days on its MLS, as the MLS counts them."},"address":{"type":"object","additionalProperties":false,"required":["line","street_number","street_direction","street_name","street_suffix","unit","city","state","state_code","postal_code","country","county","county_fips"],"properties":{"line":{"type":"string"},"street_number":{"type":["string","null"]},"street_direction":{"type":["string","null"]},"street_name":{"type":["string","null"]},"street_suffix":{"type":["string","null"]},"unit":{"type":["string","null"]},"city":{"type":"string"},"state":{"type":"string"},"state_code":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"},"county":{"type":"string"},"county_fips":{"type":"string"}},"description":"The home's address; a builder's plan's is its sales office. Null parts when the MLS hides them."},"location":{"type":"object","additionalProperties":false,"required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"neighborhoods":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","slug_id","type","center"],"properties":{"name":{"type":"string"},"slug_id":{"type":"string"},"type":{"type":"string"},"center":{"type":"object","additionalProperties":false,"required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}}}},"description":"The neighbourhoods the home is in, with their centre."},"features":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["category","group","items"],"properties":{"category":{"type":"string"},"group":{"type":"string"},"items":{"type":"array","items":{"type":"string"}}}},"description":"Every feature the listing states, by category (Appliances, Heating, Exterior...), as its MLS writes them."},"tags":{"type":"array","items":{"type":"string"},"description":"realtor.com's tags for the listing, most telling first (Breathtaking views)."},"photos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","description","tags"],"properties":{"url":{"type":"string"},"description":{"type":["string","null"]},"tags":{"type":"array","items":{"type":"string"}}}},"description":"Every photo of the listing, with realtor.com's labels (kitchen, highrise...)."},"photo_count":{"type":"number"},"tours":{"type":"object","additionalProperties":false,"required":["virtual","matterport","videos","floor_plans"],"properties":{"virtual":{"type":"array","items":{"type":"string"}},"matterport":{"type":"array","items":{"type":"string"}},"videos":{"type":"array","items":{"type":"string"}},"floor_plans":{"type":"array","items":{"type":"string"}}},"description":"Virtual tours, Matterport tours, videos and floor plans."},"open_houses":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["start","end","time_zone","description"],"properties":{"start":{"type":"string"},"end":{"type":"string"},"time_zone":{"type":"string"},"description":{"type":["string","null"]}}},"description":"Coming open houses, in the home's local time (time_zone)."},"flags":{"type":"object","additionalProperties":false,"required":["new_construction","new_listing","pending","contingent","foreclosure","price_reduced","coming_soon","plan","usda_eligible"],"properties":{"new_construction":{"type":"boolean"},"new_listing":{"type":"boolean"},"pending":{"type":"boolean"},"contingent":{"type":"boolean"},"foreclosure":{"type":"boolean"},"price_reduced":{"type":"boolean"},"coming_soon":{"type":"boolean"},"plan":{"type":"boolean"},"usda_eligible":{"type":"boolean"}}},"agents":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["role","name","email","phones","website","photo_url","slogan","state_license","nrds_id","mls_set","realtor_url","office","broker","builder","id"],"properties":{"role":{"type":"string"},"name":{"type":"string"},"email":{"type":["string","null"]},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written","type","extension","primary"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"},"type":{"type":["string","null"]},"extension":{"type":["string","null"]},"primary":{"type":"boolean"}}}},"website":{"type":["string","null"]},"photo_url":{"type":["string","null"]},"slogan":{"type":["string","null"]},"state_license":{"type":["string","null"]},"nrds_id":{"type":["string","null"]},"mls_set":{"type":["string","null"]},"realtor_url":{"type":["string","null"]},"office":{"type":["object","null"],"additionalProperties":false,"required":["name","email","phones","website","address","hours","photo_url","mls_set","id"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written","type","extension","primary"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"},"type":{"type":"string"},"extension":{"type":["string","null"]},"primary":{"type":"boolean"}}}},"website":{"type":["string","null"]},"address":{"type":"object","additionalProperties":false,"required":["line","city","state_code","postal_code","country"],"properties":{"line":{"type":"string"},"city":{"type":"string"},"state_code":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":["string","null"]}}},"hours":{"type":["string","null"]},"photo_url":{"type":["string","null"]},"mls_set":{"type":"string"},"id":{"type":"string"}}},"broker":{"type":["object","null"],"additionalProperties":false,"required":["name","logo_url","id"],"properties":{"name":{"type":"string"},"logo_url":{"type":["string","null"]},"id":{"type":"string"}}},"builder":{"type":["object","null"],"additionalProperties":false,"required":["name","website","logo_url","id"],"properties":{"name":{"type":"string"},"website":{"type":"string"},"logo_url":{"type":"string"},"id":{"type":"string"}}},"id":{"type":"string"}}},"description":"The listing's agents (the seller's side): name, email, phones, licence, office and broker; the builder for a new home."},"buyer_agents":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["role","name","email","phones","website","photo_url","slogan","state_license","nrds_id","mls_set","realtor_url","office","broker","builder","id"],"properties":{"role":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written","type","extension","primary"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"},"type":{"type":"string"},"extension":{"type":["string","null"]},"primary":{"type":"boolean"}}}},"website":{"type":"string"},"photo_url":{"type":"string"},"slogan":{"type":["string","null"]},"state_license":{"type":["string","null"]},"nrds_id":{"type":"string"},"mls_set":{"type":"string"},"realtor_url":{"type":["string","null"]},"office":{"type":"object","additionalProperties":false,"required":["name","email","phones","website","address","hours","photo_url","mls_set","id"],"properties":{"name":{"type":"string"},"email":{"type":"string"},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written","type","extension","primary"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"},"type":{"type":"string"},"extension":{"type":["string","null"]},"primary":{"type":"boolean"}}}},"website":{"type":"string"},"address":{"type":"object","additionalProperties":false,"required":["line","city","state_code","postal_code","country"],"properties":{"line":{"type":"string"},"city":{"type":"string"},"state_code":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"}}},"hours":{"type":["string","null"]},"photo_url":{"type":"string"},"mls_set":{"type":"string"},"id":{"type":"string"}}},"broker":{"type":"object","additionalProperties":false,"required":["name","logo_url","id"],"properties":{"name":{"type":"string"},"logo_url":{"type":["string","null"]},"id":{"type":"string"}}},"builder":{"type":["object","null"],"additionalProperties":false,"required":["name","website","logo_url","id"],"properties":{"name":{"type":"string"},"website":{"type":"string"},"logo_url":{"type":"string"},"id":{"type":"string"}}},"id":{"type":"string"}}},"description":"The buyer's agents of a sold home, when realtor.com names them."},"contact_phone":{"type":["object","null"],"additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"}},"description":"The line realtor.com's contact button calls, when it gives one."},"mls":{"type":"object","additionalProperties":false,"required":["id","name","type","listing_id","updated_at","disclaimer","agents"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"listing_id":{"type":"string"},"updated_at":{"type":["string","null"]},"disclaimer":{"type":["string","null"]},"agents":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["role","name","id","email","phone","office_name","office_id","office_phone"],"properties":{"role":{"type":"string"},"name":{"type":["string","null"]},"id":{"type":"string"},"email":{"type":["string","null"]},"phone":{"type":["string","null"]},"office_name":{"type":"string"},"office_id":{"type":"string"},"office_phone":{"type":["string","null"]}}}}},"description":"The MLS the listing comes from, its id there, and the agents it names with their direct lines."},"builder":{"type":["object","null"],"additionalProperties":false,"required":["name","website","logo_url","id"],"properties":{"name":{"type":"string"},"website":{"type":"string"},"logo_url":{"type":"string"},"id":{"type":"string"}},"description":"A new home's builder."},"community":{"type":["object","null"],"additionalProperties":false,"required":["id","name","description","url","price_min","price_max","unit_count","amenities","sales_office","photos"],"properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"description":{"type":["string","null"]},"url":{"type":"string"},"price_min":{"type":["number","null"]},"price_max":{"type":["number","null"]},"unit_count":{"type":["number","null"]},"amenities":{"type":"array","items":{"type":"string"}},"sales_office":{"type":["object","null"],"additionalProperties":false,"required":["name","email","phones","website","address","hours","photo_url","mls_set","id"],"properties":{"name":{"type":"string"},"email":{"type":["string","null"]},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written","type","extension","primary"],"properties":{"number":{"type":"string"},"as_written":{"type":"string"},"type":{"type":"string"},"extension":{"type":["string","null"]},"primary":{"type":"boolean"}}}},"website":{"type":["string","null"]},"address":{"type":["object","null"],"additionalProperties":false,"required":["line","city","state_code","postal_code","country"],"properties":{"line":{"type":"string"},"city":{"type":"string"},"state_code":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":["string","null"]}}},"hours":{"type":"string"},"photo_url":{"type":["string","null"]},"mls_set":{"type":["string","null"]},"id":{"type":["string","null"]}}},"photos":{"type":"array","items":{"type":"string"}}},"description":"A new home's community: its price range, units, amenities, sales office and photos."},"price_history":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","event","price","price_change","price_change_percent","price_per_sqft","source","source_listing_id","days_after_listed"],"properties":{"date":{"type":"string"},"event":{"type":"string"},"price":{"type":"number"},"price_change":{"type":"number"},"price_change_percent":{"type":["number","null"]},"price_per_sqft":{"type":["number","null"]},"source":{"type":"string"},"source_listing_id":{"type":["string","null"]},"days_after_listed":{"type":["number","null"]}}},"description":"Every event of the property realtor.com knows: listed, price changed, sold, removed, with its source."},"tax_history":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["year","tax","assessment","market"],"properties":{"year":{"type":"number"},"tax":{"type":"number"},"assessment":{"type":"object","additionalProperties":false,"required":["building","land","total"],"properties":{"building":{"type":["number","null"]},"land":{"type":["number","null"]},"total":{"type":"number"}}},"market":{"type":"object","additionalProperties":false,"required":["building","land","total"],"properties":{"building":{"type":["number","null"]},"land":{"type":["number","null"]},"total":{"type":"number"}}}}},"description":"The yearly tax, and the assessed and market values, building and land."},"permits":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","status","work","project_types"],"properties":{"date":{"type":"string"},"status":{"type":"string"},"work":{"type":"string"},"project_types":{"type":"array","items":{"type":"string"}}}},"description":"Building permits on record."},"schools":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","name","rating","parent_rating","review_count","distance_miles","assigned","funding_type","levels","grades","students","students_per_teacher","location","url"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"rating":{"type":["number","null"]},"parent_rating":{"type":["number","null"]},"review_count":{"type":"number"},"distance_miles":{"type":"number"},"assigned":{"type":"boolean"},"funding_type":{"type":"string"},"levels":{"type":"array","items":{"type":"string"}},"grades":{"type":"array","items":{"type":"string"}},"students":{"type":["number","null"]},"students_per_teacher":{"type":["number","null"]},"location":{"type":"object","additionalProperties":false,"required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"url":{"type":"string"}}},"description":"The schools near the home, rated by GreatSchools, and whether the home is assigned to them."},"environmental_risk":{"type":"object","additionalProperties":false,"required":["flood","wildfire","heat","wind","air"],"properties":{"flood":{"type":"object","additionalProperties":false,"required":["score","severity","trend"],"properties":{"score":{"type":"number"},"severity":{"type":"string"},"trend":{"type":"string"}}},"wildfire":{"type":"object","additionalProperties":false,"required":["score","severity","trend"],"properties":{"score":{"type":"number"},"severity":{"type":"string"},"trend":{"type":"string"}}},"heat":{"type":"object","additionalProperties":false,"required":["score","severity","trend"],"properties":{"score":{"type":"number"},"severity":{"type":"string"},"trend":{"type":"string"}}},"wind":{"type":"object","additionalProperties":false,"required":["score","severity","trend"],"properties":{"score":{"type":"number"},"severity":{"type":"string"},"trend":{"type":"string"}}},"air":{"type":"object","additionalProperties":false,"required":["score","severity","trend"],"properties":{"score":{"type":"number"},"severity":{"type":"string"},"trend":{"type":"string"}}}},"description":"First Street's risks, scored 1 to 10: flood, wildfire, heat, wind, air."},"estimates":{"type":"object","additionalProperties":false,"required":["current","history","forecast"],"properties":{"current":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source","source_type","value","low","high","date","best"],"properties":{"source":{"type":["string","null"]},"source_type":{"type":["string","null"]},"value":{"type":"number"},"low":{"type":["number","null"]},"high":{"type":["number","null"]},"date":{"type":["string","null"]},"best":{"type":"boolean"}}}},"history":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source","source_type","values"],"properties":{"source":{"type":"string"},"source_type":{"type":"string"},"values":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","value"],"properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}}},"forecast":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["source","source_type","values"],"properties":{"source":{"type":"string"},"source_type":{"type":"string"},"values":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["date","value"],"properties":{"date":{"type":"string"},"value":{"type":"number"}}}}}}}},"description":"Value estimates by provider: the current ones with their range, five years back, and the forecast."},"mortgage":{"type":["object","null"],"additionalProperties":false,"required":["monthly_payment","payment_details","rate","term_years","closing_cost","closing_cost_percent","due_at_close","property_tax_rate","insurance_rate","fha_eligible","jumbo_loan","county_fha_loan_limit"],"properties":{"monthly_payment":{"type":"number"},"payment_details":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["type","label","amount"],"properties":{"type":{"type":"string"},"label":{"type":"string"},"amount":{"type":"number"}}}},"rate":{"type":"number"},"term_years":{"type":"number"},"closing_cost":{"type":"number"},"closing_cost_percent":{"type":"number"},"due_at_close":{"type":"number"},"property_tax_rate":{"type":"number"},"insurance_rate":{"type":"number"},"fha_eligible":{"type":"boolean"},"jumbo_loan":{"type":"boolean"},"county_fha_loan_limit":{"type":"number"}},"description":"realtor.com's monthly payment estimate for the asking price, and its parts."},"other_listings":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["listing_id","status","sold_date","primary"],"properties":{"listing_id":{"type":"string"},"status":{"type":"string"},"sold_date":{"type":["string","null"]},"primary":{"type":"boolean"}}},"description":"The other listings of the same property on realtor.com (earlier sales, rentals)."},"ai_distribution_suppressed":{"type":"boolean","description":"The listing's MLS asks that it not be given to AI (realtor.com's suppression flag). It is delivered as the page has it; honouring that wish is the caller's responsibility."},"display_suppressed":{"type":"array","items":{"type":"string"},"description":"What realtor.com hides of the listing at its MLS's request: sold_price, last_sold_price, schools, avm..."},"ids":{"type":"object","additionalProperties":false,"required":["property_id","listing_id","mls_listing_id","community_id","builder_id","z_pals_id","z_property_id"],"properties":{"property_id":{"type":"string"},"listing_id":{"type":["string","null"]},"mls_listing_id":{"type":"string"},"community_id":{"type":["string","null"]},"builder_id":{"type":["string","null"]},"z_pals_id":{"type":["string","null"],"description":"realtor.com's `source.z_pals_id`, under its own name, when it gives one (30044001_Z000005139); the site says nothing of its meaning."},"z_property_id":{"type":["string","null"],"description":"realtor.com's `source.z_property_id`, under its own name, when it gives one (64777770); the site says nothing of its meaning."}},"description":"Every id realtor.com gives with the listing."},"source_url":{"type":"string","description":"The listing page these values were read from."},"observed_at":{"type":"string","description":"When they were read, UTC."}}},"realtor.listings.get.Request":{"type":"object","required":["source","operation"],"description":"One realtor.com listing, whole, as its page shows it read to the end: agents, history, taxes, schools, risks, estimates.","properties":{"source":{"const":"realtor"},"operation":{"const":"listings/get"},"options":{"$ref":"#/components/schemas/realtor.listings.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"realtor.listings.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"realtor"},"operation":{"const":"listings/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/realtor.listings.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/realtor.listings.get.Record"}}}},"realtor.listings.search.Options":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","pattern":"^https://(www\\.)?realtor\\.com/realestateandhomes-search/.+","description":"A realtor.com search of homes for sale or sold, exactly as the browser shows it once set up: the place, then its filters as the page writes them in the path (beds-3, price-300000-600000, type-condo, show-recently-sold, sby-6 for newest first), its page the page to start at (pg-2 is the second page). A filter realtor.com does not read is refused, never ignored. realtor.com serves the first 10,000 results of a search (238 pages): narrow it (a price range, a smaller place) for more.","examples":["https://www.realtor.com/realestateandhomes-search/Austin_TX","https://www.realtor.com/realestateandhomes-search/Miami_FL/type-condo/sby-6","https://www.realtor.com/realestateandhomes-search/Austin_TX/show-recently-sold"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the search it was given with (otherwise `invalid_cursor`). Leave it out to start at the URL's page."}}},"realtor.listings.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","url","status","status_label","property_type","plan_name","price","price_reduced_by","sold_price","beds","baths","living_area_sqft","lot_sqft","address","location","listed_at","photos","photo_count","tours","open_house","flags","builder","community","brokerage","attribution","contact","listing_source","ai_distribution_suppressed","display_suppressed","ids","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","description":"realtor.com's property id (9229990651); repeated in ids.property_id."},"position":{"type":"integer","minimum":1,"description":"Its place in the search, across pages (page 2 starts at 43)."},"url":{"type":["string","null"],"format":"uri","description":"The listing on realtor.com."},"status":{"type":["string","null"],"description":"realtor.com's status: for_sale, sold, ready_to_build (a builder's plan)."},"status_label":{"type":["string","null"],"description":"The status as the card says it: House for sale, Pending, Sold, Condo for sale."},"property_type":{"type":["string","null"],"description":"single_family, condos, townhomes, multi_family, coop, condop, land, mobile..."},"plan_name":{"type":["string","null"],"description":"A builder's plan's name (Plan 1908 Modeled); null for a home."},"price":{"type":"object","additionalProperties":false,"required":["amount","currency","from","hidden"],"properties":{"amount":{"type":["number","null"],"description":"The asking price; null when realtor.com hides it."},"currency":{"const":"USD"},"from":{"type":"boolean","description":"A starting price (a plan's: From $407,775)."},"hidden":{"type":"boolean","description":"realtor.com hides the price (sold homes in some states)."}}},"price_reduced_by":{"type":["number","null"],"description":"The last price cut, in USD, when the card shows one."},"sold_price":{"type":["number","null"],"description":"The sale price of a sold home, when realtor.com shows it."},"beds":{"type":["number","null"]},"baths":{"type":["number","null"],"description":"Bathrooms, a half bath counting 0.5 (2.5)."},"living_area_sqft":{"type":["number","null"],"description":"The living area, in square feet."},"lot_sqft":{"type":["number","null"],"description":"The lot, in square feet."},"address":{"type":"object","additionalProperties":false,"required":["line","unit","city","state_code","postal_code","county_fips"],"description":"The home's address; a plan's is its builder's sales office. Null parts when the MLS hides them.","properties":{"line":{"type":["string","null"]},"unit":{"type":["string","null"],"description":"Unit 1601."},"city":{"type":["string","null"]},"state_code":{"type":["string","null"],"description":"TX."},"postal_code":{"type":["string","null"]},"county_fips":{"type":["string","null"],"description":"The county's FIPS code (48453, Travis)."}}},"location":{"type":["object","null"],"additionalProperties":false,"required":["lat","lng"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"listed_at":{"type":["string","null"],"format":"date-time","description":"When it was listed on realtor.com, UTC."},"photos":{"type":"array","items":{"type":"string"},"description":"The photos the card holds (1 to 3); the listing has photo_count."},"photo_count":{"type":["number","null"]},"tours":{"type":"object","additionalProperties":false,"required":["three_d","video","virtual"],"properties":{"three_d":{"type":"boolean"},"video":{"type":"boolean"},"virtual":{"type":"boolean"}}},"open_house":{"type":["string","null"],"description":"The next open house as the card says it: Open house 11/14."},"flags":{"type":"object","additionalProperties":false,"required":["new_construction","new_listing","pending","contingent","foreclosure","price_reduced","plan","to_be_built","builder_promotion","promoted","spotlight","verified"],"properties":{"new_construction":{"type":"boolean"},"new_listing":{"type":"boolean"},"pending":{"type":"boolean"},"contingent":{"type":"boolean"},"foreclosure":{"type":"boolean"},"price_reduced":{"type":"boolean"},"plan":{"type":"boolean","description":"A builder's plan, not a built home."},"to_be_built":{"type":"boolean"},"builder_promotion":{"type":"boolean","description":"The builder runs a promotion (a credit, a rate)."},"promoted":{"type":"boolean","description":"A placement paid on realtor.com."},"spotlight":{"type":"boolean","description":"realtor.com's Spotlight placement."},"verified":{"type":"boolean","description":"realtor.com's verified badge."}}},"builder":{"type":["object","null"],"additionalProperties":false,"required":["name","logo_url"],"properties":{"name":{"type":["string","null"]},"logo_url":{"type":["string","null"]}}},"community":{"type":["object","null"],"additionalProperties":false,"required":["id","name","promotions"],"description":"A new-home community the listing belongs to.","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"promotions":{"type":"array","items":{"type":"string"},"description":"Its promotions by kind: flex_cash..."}}},"brokerage":{"type":"object","additionalProperties":false,"required":["name","logo_url"],"properties":{"name":{"type":["string","null"]},"logo_url":{"type":["string","null"]}}},"attribution":{"type":["string","null"],"description":"As the card credits it: Brokered by Cervera Real Estate Inc., Built by D.R. Horton."},"contact":{"type":"object","additionalProperties":false,"required":["label","phone"],"properties":{"label":{"type":["string","null"],"description":"The card's contact button: Contact agent, Contact builder."},"phone":{"type":["object","null"],"additionalProperties":false,"required":["number","as_written"],"description":"The line that button calls, when realtor.com gives one: a lead line of the office, not always its own.","properties":{"number":{"type":["string","null"],"description":"E.164: +18662776005."},"as_written":{"type":"string"}}}}},"listing_source":{"type":"object","additionalProperties":false,"required":["type","id","listing_id"],"properties":{"type":{"type":["string","null"],"description":"mls, or new_home for a builder."},"id":{"type":["string","null"],"description":"The MLS's or the builder feed's code (AUTX)."},"listing_id":{"type":["string","null"],"description":"The listing's id in that MLS or feed."}}},"ai_distribution_suppressed":{"type":"boolean","description":"The listing's MLS asks that it not be given to AI (realtor.com's suppression flag). It is delivered as the page has it; honouring that wish is the caller's responsibility."},"display_suppressed":{"type":"array","items":{"type":"string"},"description":"What realtor.com hides of the listing at its MLS's request: address, sold_price, last_sold_price, schools, avm, foreclosure..."},"ids":{"type":"object","additionalProperties":false,"required":["property_id","listing_id","plan_id","spec_id","community_id","mls_listing_id","z_pals_id","z_property_id"],"description":"Every id realtor.com gives with the listing.","properties":{"property_id":{"type":"string"},"listing_id":{"type":["string","null"]},"plan_id":{"type":["string","null"]},"spec_id":{"type":["string","null"]},"community_id":{"type":["string","null"]},"mls_listing_id":{"type":["string","null"]},"z_pals_id":{"type":["string","null"],"description":"realtor.com's `source.z_pals_id`, under its own name, when it gives one (30044001_Z000005139); the site says nothing of its meaning."},"z_property_id":{"type":["string","null"],"description":"realtor.com's `source.z_property_id`, under its own name, when it gives one (64777770); the site says nothing of its meaning."}}},"source_url":{"type":"string","format":"uri","description":"The search page these values were read from, its page included."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"realtor.listings.search.Request":{"type":"object","required":["source","operation"],"description":"One page of a realtor.com search, 42 homes for sale or sold, as the page shows them, with the MLS's wishes on AI use.","properties":{"source":{"const":"realtor"},"operation":{"const":"listings/search"},"options":{"$ref":"#/components/schemas/realtor.listings.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"realtor.listings.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"realtor"},"operation":{"const":"listings/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/realtor.listings.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/realtor.listings.search.Record"}}}},"seloger.listings.get.Options":{"type":"object","required":["listing"],"additionalProperties":false,"properties":{"listing":{"type":"string","minLength":12,"maxLength":400,"description":"The listing's id (26IBQQJTVUFB, the `id` of a seloger/listings/search record), or its address as the browser shows it (https://www.seloger.com/annonce/...), or a former address (https://www.seloger.com/annonces/... /285758851.htm). A listing shown on bellesdemeures.com or selogerneuf.com is on another site.","examples":["26IBQQJTVUFB","https://www.seloger.com/annonce/achat/ile-de-france/paris-75/paris-75000/26IBQQJTVUFB"]}}},"seloger.listings.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","url","transaction","transaction_subtype","property_type","property_label","title","title_additions","headline","description","language","reference","price","price_period","price_note","charges_included","price_details","price_messages","rooms","bedrooms","living_area","plot_area","facts","features","features_by_ai","energy_class","energy","building_state","year_built","co_ownership","is_new","is_exclusive","has_3d_visit","has_brokerage_fee","photos","floor_plans","videos","virtual_tours","location","area_price_per_m2","published_at","updated_at","seller","ids","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","description":"SeLoger's listing id (26IBQQJTVUFB); repeated in ids.listing_id."},"url":{"type":"string","format":"uri","description":"The listing's page read."},"transaction":{"type":["string","null"],"description":"buy or rent."},"transaction_subtype":{"type":["string","null"],"description":"SeLoger's kind of sale or rent: resale, new_build, life_annuity, classic..."},"property_type":{"type":["string","null"],"description":"SeLoger's type, in its own words: apartment, house, parking..."},"property_label":{"type":["string","null"],"description":"The type as the page names it, in French: Appartement."},"title":{"type":["string","null"],"description":"Appartement à vendre, Maison en viager."},"title_additions":{"type":"array","items":{"type":"string"},"description":"What the title adds: occupé (a life annuity's owner stays)."},"headline":{"type":["string","null"],"description":"The seller's line above the description."},"description":{"type":["string","null"],"description":"The seller's text, whole, as written (line breaks kept)."},"language":{"type":["string","null"],"description":"The description's language, as SeLoger says: fr."},"reference":{"type":["string","null"],"description":"The seller's own reference of the listing (Référence annonce)."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price: a sale's, a month's rent, a life annuity's lump sum (its rent in price_details).","properties":{"amount":{"type":"number"},"currency":{"type":"string","description":"ISO 4217","EUR.":null}}},"price_period":{"type":["string","null"],"enum":["month",null],"description":"month for a rent; null for a sale."},"price_note":{"type":["string","null"],"description":"What the page writes under the price: 12 294 €/m², charges comprises, et 596 €/mois."},"charges_included":{"type":["boolean","null"],"description":"A rent with its charges (cc) or without (hc); null for a sale."},"price_details":{"type":"array","description":"Each line of the price section, in its order and words: the price with or without fees, the fees and who pays them, a deposit, a life annuity's rent, the estimated energy bill, a rent's legal cap.","items":{"type":"object","additionalProperties":false,"required":["kind","label","note","value","per_m2"],"properties":{"kind":{"type":["string","null"],"description":"primary (the price and what it holds), secondary (what comes besides), additional."},"label":{"type":["string","null"],"description":"As written: Honoraires TTC à la charge de l'acquéreur (6,25% du prix du bien hors honoraires)."},"note":{"type":["string","null"],"description":"What the label adds: honoraires inclus."},"value":{"type":["string","null"],"description":"As written: 22 500 €, 596 €/mois, entre 740 et 1049 €/an."},"per_m2":{"type":["string","null"],"description":"The line per m², as written."}}}},"price_messages":{"type":"array","items":{"type":"string"},"description":"What the price section says besides: Les honoraires sont à la charge du vendeur."},"rooms":{"type":["integer","null"]},"bedrooms":{"type":["integer","null"]},"living_area":{"type":["number","null"],"description":"m²."},"plot_area":{"type":["number","null"],"description":"m², a house's land."},"facts":{"type":"array","description":"The facts the page lists at its top, in its words.","items":{"type":"object","additionalProperties":false,"required":["type","text"],"properties":{"type":{"type":["string","null"],"description":"numberOfRooms, numberOfBedrooms, livingSpace, numberOfFloors, plotSpace, availability..."},"text":{"type":["string","null"]}}}},"features":{"type":"array","description":"Every feature the seller gave, by the page's categories: Informations générales, Accessibilité, Intérieur, Extérieur, Équipements, Sécurité et services.","items":{"type":"object","additionalProperties":false,"required":["category","items"],"properties":{"category":{"type":["string","null"]},"items":{"type":"array","items":{"type":["string","null"]},"description":"As written: Ascenseur, Terrasse (Total 5 m²), Exposition: est."}}}},"features_by_ai":{"type":"array","items":{"type":["string","null"]},"description":"Features SeLoger's own AI read in the listing and the page shows as such (Ascenseur), not the seller's."},"energy_class":{"type":["string","null"],"description":"The energy performance class (DPE), A to G."},"energy":{"type":"object","additionalProperties":false,"required":["details","certificates"],"properties":{"details":{"type":"array","description":"The energy section's facts: year of construction, state, heating, energy source.","items":{"type":"object","additionalProperties":false,"required":["type","label","value"],"properties":{"type":{"type":["string","null"],"description":"yearOfConstruction, state, heatingSystem, energySource..."},"label":{"type":["string","null"]},"value":{"type":["string","null"]}}}},"certificates":{"type":"array","description":"The energy performance (DPE) and greenhouse gas (GES) certificates, each with its rating and values.","items":{"type":"object","additionalProperties":false,"required":["type","name","rating","values","date"],"properties":{"type":{"type":["string","null"],"description":"fr_energy_after_2021, fr_ghg_after_2021, their before_2021 forms."},"name":{"type":["string","null"]},"rating":{"type":["string","null"],"description":"A to G."},"values":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["label","value"],"properties":{"label":{"type":["string","null"],"description":"Consommation (énergie primaire), Émissions."},"value":{"type":["string","null"],"description":"45 kWh/m².an, 3 kg CO₂/m².an."}}}},"date":{"type":["string","null"],"description":"When the diagnosis was made, as written: Après le 1er juillet 2021."}}}}}},"building_state":{"type":["string","null"],"description":"SeLoger's state of the building: first_time_use, mint_condition, well_kept, refurbished, need_of_renovation, to_refurbish."},"year_built":{"type":["integer","null"]},"co_ownership":{"type":"array","description":"The co-ownership the listing is in: its number of lots, annual charges, an ongoing procedure.","items":{"type":"object","additionalProperties":false,"required":["type","label","value"],"properties":{"type":{"type":["string","null"],"description":"numberOfUnits..."},"label":{"type":["string","null"]},"value":{"type":["string","null"]}}}},"is_new":{"type":"boolean","description":"SeLoger's Nouveau badge: put online recently."},"is_exclusive":{"type":"boolean"},"has_3d_visit":{"type":"boolean"},"has_brokerage_fee":{"type":"boolean","description":"SeLoger's flag of an agency fee shown apart."},"photos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","room","caption"],"properties":{"url":{"type":"string","format":"uri"},"room":{"type":["string","null"],"description":"SeLoger's reading of the photo: living_room, kitchen, exterior_view..."},"caption":{"type":["string","null"],"description":"The photo's caption on the page: Salon, Vue extérieure."}}}},"floor_plans":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"}}}},"videos":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","title"],"properties":{"url":{"type":["string","null"]},"title":{"type":["string","null"]}}}},"virtual_tours":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","title"],"properties":{"url":{"type":["string","null"]},"title":{"type":["string","null"]}}}},"location":{"type":"object","additionalProperties":false,"required":["city","postal_code","district","department","region","country","address_published","latitude","longitude","geometry","place_ids","transport","schools"],"properties":{"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"district":{"type":["string","null"]},"department":{"type":["string","null"]},"region":{"type":["string","null"],"description":"As SeLoger's page data names it (its names are not all French)."},"country":{"type":["string","null"]},"address_published":{"type":"boolean","description":"The seller shows the street on the page."},"latitude":{"type":["number","null"],"description":"The property's own point, when the seller published its address; else null."},"longitude":{"type":["number","null"]},"place_ids":{"type":"array","description":"SeLoger's places the listing is in, from the smallest: each id can be a search's `locations=`.","items":{"type":"object","additionalProperties":false,"required":["id","level"],"properties":{"id":{"type":["string","null"]},"level":{"type":["string","null"]}}}},"geometry":{"type":["object","null"],"description":"GeoJSON, as the page's map has it: a Point, the property itself, when the seller published its address (3 listings of 8 on 12/11); else a MultiPolygon, the neighbourhood or the city it is drawn in."},"transport":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["type","lines"],"properties":{"type":{"type":["string","null"]},"lines":{"type":"array","items":{"type":["string","null"]}}}}},"schools":{"type":"array","description":"The schools nearby the page lists, with the times to reach them it shows.","items":{"type":"object","additionalProperties":false,"required":["name","sector","level","distance","walk","bike","transit","car"],"properties":{"name":{"type":["string","null"]},"sector":{"type":"string","enum":["public","private"]},"level":{"type":["string","null"],"description":"primary, secondary..."},"distance":{"type":["string","null"],"description":"As written: 362 m."},"walk":{"type":["string","null"],"description":"As written: 5 min."},"bike":{"type":["string","null"]},"transit":{"type":["string","null"]},"car":{"type":["string","null"]}}}}}},"area_price_per_m2":{"type":["object","null"],"additionalProperties":false,"required":["average","low","high","accuracy","place","place_id"],"description":"SeLoger's price per m² of the listing's area, from its own market data (for a rent, per month), with the range it shows; SeLoger's estimate, never an evaluation of this listing.","properties":{"average":{"type":["number","null"]},"low":{"type":["number","null"]},"high":{"type":["number","null"]},"accuracy":{"type":["integer","null"],"description":"SeLoger's confidence in it, 1 to 5."},"place":{"type":["string","null"]},"place_id":{"type":["string","null"]}}},"published_at":{"type":["string","null"],"format":"date-time","description":"When the listing was put online on SeLoger, UTC."},"updated_at":{"type":["string","null"],"format":"date-time","description":"Its last change, UTC."},"seller":{"type":"object","additionalProperties":false,"required":["type","kind","id","name","contact_name","phones","address","website","profile_url","logo_url","fees_url","siren","siret","legal"],"properties":{"type":{"type":"string","enum":["private","pro"]},"kind":{"type":["string","null"],"description":"agency, real_estate_agent, real_estate_developer; null for a private owner."},"id":{"type":["string","null"],"description":"SeLoger's id of the seller: RC-1887530."},"name":{"type":["string","null"]},"contact_name":{"type":["string","null"]},"phones":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"],"description":"E.164; a national number is French."},"as_written":{"type":"string"}}}},"address":{"type":["string","null"]},"website":{"type":["string","null"]},"profile_url":{"type":["string","null"],"format":"uri"},"logo_url":{"type":["string","null"],"format":"uri"},"fees_url":{"type":["string","null"]},"siren":{"type":["string","null"],"pattern":"^[0-9]{9}$"},"siret":{"type":["string","null"],"pattern":"^[0-9]{14}$"},"legal":{"type":"array","items":{"type":"string"}}}},"ids":{"type":"object","additionalProperties":false,"required":["listing_id","legacy_id","client_id"],"properties":{"listing_id":{"type":"string"},"legacy_id":{"type":["string","null"],"description":"The listing's former numeric id."},"client_id":{"type":["string","null"],"description":"The seller's id: seller.id."}}},"source_url":{"type":"string","format":"uri","description":"The page these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"seloger.listings.get.Request":{"type":"object","required":["source","operation"],"description":"One seloger.com listing, whole, as its page shows it, the agency's phone included.","properties":{"source":{"const":"seloger"},"operation":{"const":"listings/get"},"options":{"$ref":"#/components/schemas/seloger.listings.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"seloger.listings.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"seloger"},"operation":{"const":"listings/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/seloger.listings.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/seloger.listings.get.Record"}}}},"seloger.listings.search.Options":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","pattern":"^https://(www\\.)?seloger\\.com/classified-search/?(\\?.*)?$","description":"A seloger.com search, exactly as the browser shows it once the search is set up (place, property types, filters, sort), its `page` the page to start at (page=2 is the second page). Sort by date, newest first, with order=DateDesc. Every filter SeLoger reads is read; a parameter SeLoger does not filter on is refused, never ignored. SeLoger serves the first 9,990 results of a search (333 pages): narrow it (a price range, a smaller place) for more.","examples":["https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=House,Apartment&locations=AD08FR31096&order=DateDesc","https://www.seloger.com/classified-search?distributionTypes=Rent&estateTypes=Apartment&locations=AD08FR28808&priceMax=1500","https://www.seloger.com/classified-search?distributionTypes=Buy&estateTypes=Apartment&projectTypes=New_Build&locations=AD08FR13100"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the search it was given with (otherwise `invalid_cursor`). Leave it out to start at the URL's page."}}},"seloger.listings.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","url","transaction","property_type","property_subtype","property_label","title","headline","description","status","price","price_period","price_note","price_per_m2","previous_price","price_change_percent","charges_included","rooms","bedrooms","living_area","plot_area","facts","energy_class","building_state","year_built","is_new","is_exclusive","has_3d_visit","has_brokerage_fee","new_build","photos","floor_plans","location","published_at","updated_at","seller","ids","source_url","observed_at"],"properties":{"object":{"const":"listing","description":"The kind of record: a listing, whichever site it comes from."},"id":{"type":"string","description":"SeLoger's listing id (26IBQQJTVUFB); repeated in ids.listing_id."},"position":{"type":"integer","minimum":1,"description":"Its place among the results, across pages (30 a page): 31 is the first of page 2."},"url":{"type":"string","format":"uri","description":"The listing on seloger.com."},"transaction":{"type":["string","null"],"description":"buy or rent, as SeLoger files the listing."},"property_type":{"type":["string","null"],"description":"SeLoger's type, in its own words: apartment, house, parking, plot, building, gastronomy_hotel..."},"property_subtype":{"type":["string","null"],"description":"studio, multi_storey, villa, restaurant...; null when SeLoger gives none."},"property_label":{"type":["string","null"],"description":"The type as the page names it, in French: Appartement."},"title":{"type":["string","null"],"description":"The card's title: Appartement à vendre."},"headline":{"type":["string","null"],"description":"The line under it: T3 neuf de 69 m² avec extérieur de 5 m²."},"description":{"type":["string","null"],"description":"The listing's text as the search shows it; SeLoger cuts it at about 500 characters (it ends with \"...\")."},"status":{"type":["string","null"],"description":"SeLoger's status: published on a search page."},"price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price: a sale's, a month's rent, a life annuity's lump sum (its monthly rent in price_note).","properties":{"amount":{"type":"number"},"currency":{"type":"string","description":"ISO 4217","EUR.":null}}},"price_period":{"type":["string","null"],"enum":["month",null],"description":"month for a rent; null for a sale."},"price_note":{"type":["string","null"],"description":"What the card writes under the price, as written: the price per m² (12 294 €/m²), charges comprises or hors charges for a rent, a life annuity's monthly rent (et 596 €/mois)."},"price_per_m2":{"type":["number","null"],"description":"The price per m² the card shows, in the price's currency."},"previous_price":{"type":["object","null"],"additionalProperties":false,"required":["amount","currency"],"description":"The price before its last change, when SeLoger shows one (a crossed-out price).","properties":{"amount":{"type":"number"},"currency":{"type":"string","description":"ISO 4217","EUR.":null}}},"price_change_percent":{"type":["number","null"],"description":"The change from previous_price, in percent of it: -8.55 is a drop (SeLoger's down arrow)."},"charges_included":{"type":["boolean","null"],"description":"A rent with its charges (cc) or without (hc); null for a sale."},"rooms":{"type":["integer","null"]},"bedrooms":{"type":["integer","null"]},"living_area":{"type":["number","null"],"description":"m²."},"plot_area":{"type":["number","null"],"description":"m², a house's land."},"facts":{"type":"array","description":"The facts the card lists, in its order and words: the floor (4ème étage, Étage 3/5), the availability (disponible dès maintenant), the rooms and surfaces said as text.","items":{"type":"object","additionalProperties":false,"required":["type","text"],"properties":{"type":{"type":["string","null"],"description":"numberOfRooms, numberOfBedrooms, livingSpace, numberOfFloors, availability, overallSpace, plotSpace..."},"text":{"type":["string","null"]}}}},"energy_class":{"type":["string","null"],"description":"The energy performance class (DPE), A to G."},"building_state":{"type":["string","null"],"description":"SeLoger's state of the building: first_time_use, mint_condition, well_kept, refurbished, need_of_renovation, to_refurbish."},"year_built":{"type":["integer","null"],"description":"The year of construction SeLoger gives (a new build's: its completion year)."},"is_new":{"type":"boolean","description":"SeLoger's Nouveau badge: put online recently."},"is_exclusive":{"type":"boolean","description":"Offered by this seller alone (the Exclusivité badge)."},"has_3d_visit":{"type":"boolean","description":"The listing has a 3D or virtual visit."},"has_brokerage_fee":{"type":"boolean","description":"SeLoger's flag of an agency fee shown apart; false on every listing of the 11/11 captures."},"new_build":{"type":["object","null"],"additionalProperties":false,"required":["name","description","url"],"description":"The new-build programme a lot belongs to (a developer's listing); null otherwise.","properties":{"name":{"type":["string","null"]},"description":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri","description":"The programme on selogerneuf.com."}}},"photos":{"type":"array","description":"Every photo, in the listing's order.","items":{"type":"object","additionalProperties":false,"required":["url","room"],"properties":{"url":{"type":"string","format":"uri"},"room":{"type":["string","null"],"description":"SeLoger's reading of the photo: living_room, kitchen, bedroom, bathroom, balcony, building_facade, logo (the agency's)..."}}}},"floor_plans":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url"],"properties":{"url":{"type":"string","format":"uri"}}}},"location":{"type":"object","additionalProperties":false,"required":["city","postal_code","district","department","region","country","address_published","place_ids","transport"],"properties":{"city":{"type":["string","null"],"description":"As SeLoger names it: Paris 18ème arrondissement."},"postal_code":{"type":["string","null"]},"district":{"type":["string","null"],"description":"The neighbourhood: Raspail-Montparnasse."},"department":{"type":["string","null"],"description":"Rhône, Paris."},"region":{"type":["string","null"]},"country":{"type":["string","null"]},"address_published":{"type":"boolean","description":"The seller shows the street on the listing's page (a search never gives it)."},"place_ids":{"type":"array","description":"SeLoger's places the listing is in, from the smallest: each id can be a search's `locations=`.","items":{"type":"object","additionalProperties":false,"required":["id","level"],"properties":{"id":{"type":["string","null"],"description":"AD08FR31096: Paris."},"level":{"type":["string","null"],"description":"SeLoger's level of the place: AD08 a city, AD06 a department, AD02 the country, NBH2 a neighbourhood..."}}}},"transport":{"type":"array","description":"The lines nearby the card shows, by kind.","items":{"type":"object","additionalProperties":false,"required":["type","lines"],"properties":{"type":{"type":["string","null"],"description":"metro, rer, tram, bus, train."},"lines":{"type":"array","items":{"type":["string","null"]},"description":"Their names: 4, 6, B."}}}}}},"published_at":{"type":["string","null"],"format":"date-time","description":"When the listing was put online on SeLoger, UTC."},"updated_at":{"type":["string","null"],"format":"date-time","description":"Its last change, UTC."},"seller":{"type":"object","additionalProperties":false,"required":["type","kind","id","name","contact_name","phones","address","city","postal_code","website","profile_url","logo_url","fees_url","siren","siret","legal"],"properties":{"type":{"type":"string","enum":["private","pro"]},"kind":{"type":["string","null"],"description":"agency, real_estate_agent, real_estate_developer; null for a private owner."},"id":{"type":["string","null"],"description":"SeLoger's id of the seller: RC-1887530."},"name":{"type":["string","null"],"description":"The agency's or developer's name; null for a private owner."},"contact_name":{"type":["string","null"],"description":"The person to contact the card names (an agent, a private owner's first name)."},"phones":{"type":"array","description":"The seller's numbers the listing gives (an agency's; a private owner's number is not in a search).","items":{"type":"object","additionalProperties":false,"required":["number","as_written"],"properties":{"number":{"type":["string","null"],"description":"E.164 (+33626412481); a national number is French."},"as_written":{"type":"string"}}}},"address":{"type":["string","null"],"description":"The seller's address."},"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"website":{"type":["string","null"],"format":"uri"},"profile_url":{"type":["string","null"],"format":"uri","description":"The seller's page on seloger.com."},"logo_url":{"type":["string","null"],"format":"uri"},"fees_url":{"type":["string","null"],"format":"uri","description":"An agency's scale of fees."},"siren":{"type":["string","null"],"pattern":"^[0-9]{9}$","description":"The RCS number the seller gives: its SIREN."},"siret":{"type":["string","null"],"pattern":"^[0-9]{14}$"},"legal":{"type":"array","items":{"type":"string"},"description":"The legal lines the listing shows, as text: the company's name and capital, its seat, RCS, SIRET, its financial guarantee."}}},"ids":{"type":"object","additionalProperties":false,"required":["listing_id","legacy_id","client_id"],"description":"Every id SeLoger gives with the listing.","properties":{"listing_id":{"type":"string"},"legacy_id":{"type":["string","null"],"description":"The listing's former numeric id (SeLoger's older addresses)."},"client_id":{"type":["string","null"],"description":"The seller's id: seller.id."}}},"source_url":{"type":"string","format":"uri","description":"The search page these values were read from, its page included."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"seloger.listings.search.Request":{"type":"object","required":["source","operation"],"description":"One page of a seloger.com search, 30 listings, as the page shows them, the agency's phone included.","properties":{"source":{"const":"seloger"},"operation":{"const":"listings/search"},"options":{"$ref":"#/components/schemas/seloger.listings.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"seloger.listings.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"seloger"},"operation":{"const":"listings/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/seloger.listings.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/seloger.listings.search.Record"}}}},"websites.contacts.get.Options":{"type":"object","required":["website"],"additionalProperties":false,"properties":{"website":{"type":"string","minLength":4,"maxLength":300,"description":"The site's address (https://www.acme.fr/), or its domain alone (acme.fr, read as https://acme.fr/).","examples":["https://www.example-plumber.fr/","example-dentist.com"]},"max_pages":{"type":"integer","minimum":1,"maximum":10,"default":4,"description":"The pages read at most: the home page, then those its links name as contact, legal notice (mentions légales, Impressum) or about, in that order. 4 by default. A home page that only frames another address, or refreshes to it (a domain its registrar forwards), is read at that address."},"country":{"type":"string","pattern":"^[a-z]{2}$","description":"The country to read a national phone number in (fr: 06 12 34 56 78 is +33612345678). Left out, a number is given as E.164 only when it says its country (+33, 0033); always as written too.","examples":["fr","de","us"]}}},"websites.contacts.get.Record":{"type":"object","additionalProperties":false,"required":["object","website","domain","emails","phones","profiles","pages","source_url","observed_at"],"properties":{"object":{"const":"website_contacts"},"website":{"type":"string","format":"uri","description":"The home page read","after its redirects.":null},"domain":{"type":"string","description":"The site's registrable domain: acme.fr for https://www.acme.fr/."},"emails":{"type":"array","description":"Every address the pages show: their mailto links (those a site builder keeps in the page's scripts too), the addresses Cloudflare hides from bots (decoded), their schema.org data and their text (name [at] acme.fr read too); any other address inside a page's scripts, only on the site's own domain; never a theme's sample (info@yourcompany.com).","items":{"type":"object","additionalProperties":false,"required":["address","domain","own_domain","free_provider","generic","found_on"],"properties":{"address":{"type":"string","description":"Lower-cased."},"domain":{"type":"string"},"own_domain":{"type":"boolean","description":"On the site's own domain (or one of its subdomains)."},"free_provider":{"type":"boolean","description":"At a free mailbox: Gmail, Outlook, Orange, GMX..."},"generic":{"type":"boolean","description":"A role address, not a person: contact@, info@, accueil@..."},"found_on":{"type":"array","items":{"type":"string","format":"uri"},"description":"The pages that show it."}}}},"phones":{"type":"array","description":"The numbers the pages give to call: their tel: links (those a site builder keeps in the page's scripts too), their schema.org `telephone`, and a number written right after a phone label (Tél., Phone:, Telefon, Teléfono, Mobile...); never another number of the text (a SIRET, a VAT number, opening hours), nor a theme's sample (123-456-7890).","items":{"type":"object","additionalProperties":false,"required":["number","as_written","found_on"],"properties":{"number":{"type":["string","null"],"description":"E.164 (+33612345678), when the number says its country or `country` was given and the number is written that country's way; else null. A 0 kept after the country (+33 0 1..., +49 (0)89...) is dropped."},"as_written":{"type":"string"},"found_on":{"type":"array","items":{"type":"string","format":"uri"}}}}},"profiles":{"type":"array","description":"The company's pages on other sites the pages link to: social networks and the directories people book or read reviews on; never a share button, a post, a video or a site's home.","items":{"type":"object","additionalProperties":false,"required":["site","url","found_on"],"properties":{"site":{"enum":["facebook","instagram","linkedin","x","youtube","tiktok","pinterest","whatsapp","threads","bluesky","snapchat","telegram","discord","github","medium","substack","reddit","twitch","vimeo","xing","google_maps","yelp","trustpilot","tripadvisor"]},"url":{"type":"string","format":"uri"},"found_on":{"type":"array","items":{"type":"string","format":"uri"}}}}},"pages":{"type":"array","description":"Each page read, with the status it answered (0 when it did not answer).","items":{"type":"object","additionalProperties":false,"required":["url","status"],"properties":{"url":{"type":"string","format":"uri"},"status":{"type":"integer"}}}},"source_url":{"type":"string","format":"uri","description":"The home page these values were read from."},"observed_at":{"type":"string","format":"date-time","description":"When they were read","UTC.":null}}},"websites.contacts.get.Request":{"type":"object","required":["source","operation"],"description":"The emails, phone numbers and profiles (social networks, directories) a company's website shows, each with its page.","properties":{"source":{"const":"websites"},"operation":{"const":"contacts/get"},"options":{"$ref":"#/components/schemas/websites.contacts.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"websites.contacts.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"websites"},"operation":{"const":"contacts/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/websites.contacts.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/websites.contacts.get.Record"}}}},"x.profiles.get.Options":{"type":"object","required":["profile"],"additionalProperties":false,"properties":{"profile":{"type":"string","minLength":1,"maxLength":200,"description":"The profile: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa). Not its display name.","examples":["nasa","@nasa","https://x.com/nasa"]},"account":{"type":"string","description":"The connected X account to read with (GET /v2/accounts). Left out, the platform takes the first of your X accounts with a free slot.","examples":["acc_7Hq2Kd9mX4pL"]}}},"x.profiles.get.Record":{"type":"object","additionalProperties":false,"required":["object","id","handle","name","url","description","description_language","description_urls","location","website_url","created_at","follower_count","following_count","tweet_count","media_count","like_count","is_blue_verified","is_verified","verified_type","is_protected","is_possibly_sensitive","professional","avatar_url","banner_url","avatar_shape","pinned_tweet_ids","affiliation","is_identity_verified","verified_since","verification_reason","affiliate_count","parody_label","interstitial","highlighted_tweet_count","subscription_count","has_hidden_subscriptions","is_subscribable","birthdate","observed_at"],"properties":{"object":{"const":"profile"},"id":{"type":"string","description":"The account's id: it stays when the handle changes."},"handle":{"type":["string","null"],"description":"Its @handle, without the @, in the case the account wrote it."},"name":{"type":["string","null"],"description":"The display name."},"url":{"type":["string","null"],"format":"uri","description":"The profile's page."},"description":{"type":["string","null"],"description":"The bio, as X gives it: its links are t.co addresses."},"description_language":{"type":["string","null"],"description":"The bio's language, as X detects it."},"description_urls":{"type":"array","items":{"type":["string","null"]},"description":"The links of the bio","in full.":null},"location":{"type":["string","null"],"description":"As the account wrote it."},"website_url":{"type":["string","null"],"description":"The profile's link, in full."},"created_at":{"type":["string","null"],"format":"date-time","description":"When the account joined X."},"follower_count":{"type":["integer","null"]},"following_count":{"type":["integer","null"]},"tweet_count":{"type":["integer","null"],"description":"Its posts, reposts and replies."},"media_count":{"type":["integer","null"],"description":"Its tweets with a photo or a video."},"like_count":{"type":["integer","null"],"description":"The tweets the account liked."},"is_blue_verified":{"type":["boolean","null"],"description":"The check mark next to the name, whatever its colour."},"is_verified":{"type":["boolean","null"],"description":"X's earlier verification."},"verified_type":{"type":["string","null"],"description":"business (gold check) or government (grey check), when X says so."},"is_protected":{"type":["boolean","null"],"description":"Whether only its followers see its posts."},"is_possibly_sensitive":{"type":["boolean","null"]},"professional":{"type":["object","null"],"description":"The professional profile the account declared; null when it declared none.","additionalProperties":false,"required":["type","categories"],"properties":{"type":{"type":["string","null"],"description":"business or creator."},"categories":{"type":"array","items":{"type":["string","null"]},"description":"As X names them (Media Personality)."}}},"avatar_url":{"type":["string","null"]},"banner_url":{"type":["string","null"]},"avatar_shape":{"type":["string","null"],"description":"circle, square (organizations), hexagon."},"pinned_tweet_ids":{"type":"array","items":{"type":"string"},"description":"The tweet pinned at the top of its posts."},"is_identity_verified":{"type":["boolean","null"],"description":"Whether X checked an identity document."},"verified_since":{"type":["string","null"],"format":"date-time","description":"Since when it is verified; null when it is not, or when X writes a date outside the calendar."},"verification_reason":{"type":["string","null"],"description":"Why it is verified, in X's words, as the page writes it under the check mark."},"affiliation":{"type":["object","null"],"description":"The organization whose badge the account carries next to its name; null without one.","additionalProperties":false,"required":["name","url","badge_url","type"],"properties":{"name":{"type":["string","null"],"description":"The organization's name on the badge."},"url":{"type":["string","null"],"description":"The organization's profile, as X links it."},"badge_url":{"type":["string","null"],"description":"The badge's image."},"type":{"type":["string","null"],"description":"business_label on every badge seen."}}},"affiliate_count":{"type":["integer","null"],"description":"For an organization, the accounts affiliated to it; null for others."},"parody_label":{"type":["string","null"],"description":"parody, commentary or fan, when the account carries that label."},"interstitial":{"type":["string","null"],"description":"The warning X puts before the profile, when any."},"highlighted_tweet_count":{"type":["integer","null"],"description":"The tweets of its Highlights tab."},"subscription_count":{"type":["integer","null"],"description":"The creators the account subscribes to."},"has_hidden_subscriptions":{"type":["boolean","null"],"description":"Whether it hides them on its profile."},"is_subscribable":{"type":["boolean","null"],"description":"Whether the account sells subscriptions."},"birthdate":{"type":["object","null"],"description":"The birth date the profile shows; null when it shows none.","additionalProperties":false,"required":["day","month","year"],"properties":{"day":{"type":["integer","null"]},"month":{"type":["integer","null"]},"year":{"type":["integer","null"],"description":"Null when the profile hides the year."}}},"observed_at":{"type":"string","format":"date-time","description":"When we read it."}}},"x.profiles.get.Request":{"type":"object","required":["source","operation"],"description":"A profile on X (Twitter) by its handle: its name, bio, links, follower and tweet counts, verification, affiliation and images, read with your connected X account.","properties":{"source":{"const":"x"},"operation":{"const":"profiles/get"},"options":{"$ref":"#/components/schemas/x.profiles.get.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."}}},"x.profiles.get.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"x"},"operation":{"const":"profiles/get"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/x.profiles.get.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/x.profiles.get.Record"}}}},"x.tweets.list.Options":{"type":"object","required":["profile"],"additionalProperties":false,"properties":{"profile":{"type":"string","minLength":1,"maxLength":200,"description":"The profile: its handle, with or without the @ (nasa, @nasa), or its address on x.com (https://x.com/nasa). Not its display name.","examples":["nasa","@nasa","https://x.com/nasa"]},"tab":{"type":"string","enum":["posts","replies","reposts","videos","photos"],"default":"posts","description":"The tab of the profile's page: posts, replies, reposts, or one of the two lists of its Media tab, videos or photos."},"account":{"type":"string","description":"The connected X account to read with (GET /v2/accounts). Left out, the platform takes the first of your X accounts with a free slot.","examples":["acc_7Hq2Kd9mX4pL"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the profile and tab it was given with (otherwise `invalid_cursor`). Leave it out to start at the newest tweets."}}},"x.tweets.list.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","is_pinned","url","text","language","created_at","reply_count","retweet_count","quote_count","like_count","bookmark_count","view_count","author","in_reply_to","is_quote","quoted_tweet","retweeted_tweet","urls","hashtags","symbols","mentions","media","card","article","place","posted_with","is_paid_promotion","has_ai_generated_media","is_possibly_sensitive","is_long","edit","ids","source_url","observed_at"],"properties":{"object":{"const":"tweet"},"id":{"type":"string","description":"The tweet's id."},"position":{"type":"integer","minimum":1,"description":"Its rank in the profile's tab, across pages."},"is_pinned":{"type":"boolean","description":"Whether the profile pinned it at the top of its Posts tab (the page writes Pinned above it)."},"url":{"type":"string","format":"uri","description":"The tweet on x.com."},"text":{"type":["string","null"],"description":"The whole text, a long tweet's included (is_long). Links are X's short ones (t.co), given in full in `urls` and `media`."},"language":{"type":["string","null"],"description":"The language X detected: ISO 639-1, or X's own codes (und, zxx, qme...)."},"created_at":{"type":["string","null"],"format":"date-time","description":"When it was posted, UTC."},"reply_count":{"type":["integer","null"]},"retweet_count":{"type":["integer","null"],"description":"Reposts."},"quote_count":{"type":["integer","null"]},"like_count":{"type":["integer","null"]},"bookmark_count":{"type":["integer","null"]},"view_count":{"type":["integer","null"],"description":"Null when X shows no view count for it."},"author":{"type":["object","null"],"additionalProperties":false,"required":["id","handle","name","url","description","description_language","description_urls","location","website_url","created_at","follower_count","following_count","tweet_count","media_count","like_count","is_blue_verified","is_verified","verified_type","is_protected","is_possibly_sensitive","professional","avatar_url","banner_url","avatar_shape","pinned_tweet_ids","affiliation"],"properties":{"id":{"type":"string","description":"The account's id."},"handle":{"type":["string","null"],"description":"Its @handle, without the @."},"name":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"description":{"type":["string","null"],"description":"The bio."},"description_language":{"type":["string","null"]},"description_urls":{"type":"array","items":{"type":["string","null"]},"description":"The links of the bio","in full.":null},"location":{"type":["string","null"],"description":"As the account wrote it."},"website_url":{"type":["string","null"],"description":"The profile's link, in full."},"created_at":{"type":["string","null"],"format":"date-time"},"follower_count":{"type":["integer","null"]},"following_count":{"type":["integer","null"]},"tweet_count":{"type":["integer","null"]},"media_count":{"type":["integer","null"]},"like_count":{"type":["integer","null"],"description":"The tweets the account liked."},"is_blue_verified":{"type":["boolean","null"],"description":"The blue check of a paying subscriber."},"is_verified":{"type":["boolean","null"],"description":"X's earlier verification."},"verified_type":{"type":["string","null"],"description":"business or government, when X says so."},"is_protected":{"type":["boolean","null"]},"is_possibly_sensitive":{"type":["boolean","null"]},"professional":{"type":["object","null"],"additionalProperties":false,"required":["type","categories"],"properties":{"type":{"type":["string","null"],"description":"business or creator."},"categories":{"type":"array","items":{"type":["string","null"]}}}},"avatar_url":{"type":["string","null"]},"banner_url":{"type":["string","null"]},"avatar_shape":{"type":["string","null"],"description":"circle, square (organizations), hexagon."},"pinned_tweet_ids":{"type":"array","items":{"type":"string"}},"affiliation":{"type":["object","null"],"description":"The organization whose badge the account carries next to its name; null without one.","additionalProperties":false,"required":["name","url","badge_url","type"],"properties":{"name":{"type":["string","null"],"description":"The organization's name on the badge."},"url":{"type":["string","null"],"description":"The organization's profile, as X links it."},"badge_url":{"type":["string","null"],"description":"The badge's image."},"type":{"type":["string","null"],"description":"business_label on every badge seen."}}}}},"in_reply_to":{"type":["object","null"],"additionalProperties":false,"required":["tweet_id","user_id","handle"],"description":"The tweet it replies to; null when it is not a reply.","properties":{"tweet_id":{"type":["string","null"]},"user_id":{"type":["string","null"]},"handle":{"type":["string","null"]}}},"is_quote":{"type":["boolean","null"]},"quoted_tweet":{"type":["object","null"],"description":"The tweet it quotes, with a tweet's fields but position, quoted_tweet, retweeted_tweet, source_url and observed_at. Null when it quotes none, or one X no longer shows (ids.quoted_tweet_id still says which)."},"retweeted_tweet":{"type":["object","null"],"description":"The tweet it reposts, with the same fields as quoted_tweet."},"urls":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","display","short_url"],"properties":{"url":{"type":["string","null"],"description":"The link in full."},"display":{"type":["string","null"],"description":"As the page shows it."},"short_url":{"type":["string","null"],"description":"X's t.co link, as it stands in the text."}}}},"hashtags":{"type":"array","items":{"type":["string","null"]},"description":"Without the #."},"symbols":{"type":"array","items":{"type":["string","null"]},"description":"Cashtags, without the $."},"mentions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","handle","name"],"properties":{"id":{"type":["string","null"]},"handle":{"type":["string","null"]},"name":{"type":["string","null"]}}}},"media":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","type","url","page_url","width","height","alt_text","duration_ms","video_url","view_count"],"properties":{"id":{"type":["string","null"]},"type":{"type":["string","null"],"description":"photo, video or animated_gif."},"url":{"type":["string","null"],"description":"The image, or a video's poster."},"page_url":{"type":["string","null"]},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]},"alt_text":{"type":["string","null"]},"duration_ms":{"type":["integer","null"]},"video_url":{"type":["string","null"],"description":"The video's file of the highest bitrate."},"view_count":{"type":["integer","null"]}}}},"card":{"type":["object","null"],"additionalProperties":false,"required":["type","url","title","description","domain","image_url"],"description":"The preview X draws under a tweet for a link, a poll or a player.","properties":{"type":{"type":["string","null"],"description":"X's name of the card: summary, summary_large_image, player..."},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"domain":{"type":["string","null"]},"image_url":{"type":["string","null"]}}},"article":{"type":["object","null"],"additionalProperties":false,"required":["id","title","preview_text","cover_url","published_at","modified_at"],"description":"An X Article attached to the tweet (its title and preview, not its text).","properties":{"id":{"type":["string","null"]},"title":{"type":["string","null"]},"preview_text":{"type":["string","null"]},"cover_url":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"modified_at":{"type":["string","null"],"format":"date-time"}}},"place":{"type":["object","null"],"additionalProperties":false,"required":["id","name","full_name","type","country","country_code","bounding_box"],"description":"The place its author tagged it with (Ozuoba, Nigeria); null without one, which is most tweets. X gives the place and the box around it, never the point it was posted from.","properties":{"id":{"type":["string","null"],"description":"X's id of the place."},"name":{"type":["string","null"]},"full_name":{"type":["string","null"],"description":"The name with its region or country, as the page writes it."},"type":{"type":["string","null"],"description":"city, admin, country, neighborhood, poi."},"country":{"type":["string","null"]},"country_code":{"type":["string","null"],"description":"Two letters."},"bounding_box":{"type":"array","description":"The corners of the box around the place, each longitude then latitude.","items":{"type":"array","items":{"type":"number"}}}}},"posted_with":{"type":["string","null"],"description":"The app it was posted with, when X says it: Twitter Web App."},"is_paid_promotion":{"type":["boolean","null"],"description":"The author's own disclosure of a paid partnership."},"has_ai_generated_media":{"type":["boolean","null"],"description":"X's label of media made with AI."},"is_possibly_sensitive":{"type":["boolean","null"]},"is_long":{"type":"boolean","description":"A tweet longer than 280 characters; text holds it whole."},"edit":{"type":["object","null"],"additionalProperties":false,"required":["tweet_ids","editable_until","edits_remaining"],"properties":{"tweet_ids":{"type":"array","items":{"type":"string"},"description":"Its versions, the first to the last."},"editable_until":{"type":["string","null"],"format":"date-time"},"edits_remaining":{"type":["integer","null"]}}},"ids":{"type":"object","additionalProperties":false,"required":["tweet_id","conversation_id","author_id","quoted_tweet_id"],"properties":{"tweet_id":{"type":"string"},"conversation_id":{"type":["string","null"],"description":"The first tweet of its thread."},"author_id":{"type":["string","null"]},"quoted_tweet_id":{"type":["string","null"]}}},"source_url":{"type":"string","format":"uri","description":"The profile's tab on x.com."},"observed_at":{"type":"string","format":"date-time","description":"When it was read, UTC."}}},"x.tweets.list.Request":{"type":"object","required":["source","operation"],"description":"The tweets of a profile on X (Twitter), tab by tab (posts, replies, reposts, videos, photos), newest first, 20 or so a page, with their text, counts, media and author, read with your connected X account.","properties":{"source":{"const":"x"},"operation":{"const":"tweets/list"},"options":{"$ref":"#/components/schemas/x.tweets.list.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"x.tweets.list.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"x"},"operation":{"const":"tweets/list"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/x.tweets.list.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/x.tweets.list.Record"}}}},"x.tweets.search.Options":{"type":"object","required":["query"],"additionalProperties":false,"properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"The search, as typed in X's search box, passed to X as it is. X's own operators, the ones its advanced search form writes: words (all of them), \"an exact phrase\", either OR other, -without, #hashtag, lang:fr, from:account, to:account, @mention, filter:replies or -filter:replies, filter:links or -filter:links, min_replies:10, min_faves:100, min_retweets:50, since:2026-11-01, until:2026-11-15 (dates in UTC).","examples":["web scraping","from:nasa since:2026-11-01","\"data extraction\" lang:fr min_faves:10"]},"tab":{"type":"string","enum":["top","latest"],"default":"top","description":"The tab of X's results: top, X's own selection (it can show a few tweets of one conversation together), or latest, newest first. The page's People and Media tabs are other operations."},"account":{"type":"string","description":"The connected X account to search with (GET /v2/accounts). Left out, the platform takes the first of your X accounts with a free slot.","examples":["acc_7Hq2Kd9mX4pL"]},"cursor":{"type":"string","pattern":"^[A-Za-z0-9_=-]{40,8000}$","description":"Where to go on, from `next` in an answer, as it is: opaque, and only for the search it was given with (otherwise `invalid_cursor`). Leave it out to start at the first page."}}},"x.tweets.search.Record":{"type":"object","additionalProperties":false,"required":["object","id","position","url","text","language","created_at","reply_count","retweet_count","quote_count","like_count","bookmark_count","view_count","author","in_reply_to","is_quote","quoted_tweet","retweeted_tweet","urls","hashtags","symbols","mentions","media","card","article","place","posted_with","is_paid_promotion","has_ai_generated_media","is_possibly_sensitive","is_long","edit","ids","source_url","observed_at"],"properties":{"object":{"const":"tweet"},"id":{"type":"string","description":"The tweet's id."},"position":{"type":"integer","minimum":1,"description":"Its rank in the search","across pages.":null},"url":{"type":"string","format":"uri","description":"The tweet on x.com."},"text":{"type":["string","null"],"description":"The whole text, a long tweet's included (is_long). Links are X's short ones (t.co), given in full in `urls` and `media`."},"language":{"type":["string","null"],"description":"The language X detected: ISO 639-1, or X's own codes (und, zxx, qme...)."},"created_at":{"type":["string","null"],"format":"date-time","description":"When it was posted, UTC."},"reply_count":{"type":["integer","null"]},"retweet_count":{"type":["integer","null"],"description":"Reposts."},"quote_count":{"type":["integer","null"]},"like_count":{"type":["integer","null"]},"bookmark_count":{"type":["integer","null"]},"view_count":{"type":["integer","null"],"description":"Null when X shows no view count for it."},"author":{"type":["object","null"],"additionalProperties":false,"required":["id","handle","name","url","description","description_language","description_urls","location","website_url","created_at","follower_count","following_count","tweet_count","media_count","like_count","is_blue_verified","is_verified","verified_type","is_protected","is_possibly_sensitive","professional","avatar_url","banner_url","avatar_shape","pinned_tweet_ids","affiliation"],"properties":{"id":{"type":"string","description":"The account's id."},"handle":{"type":["string","null"],"description":"Its @handle, without the @."},"name":{"type":["string","null"]},"url":{"type":["string","null"],"format":"uri"},"description":{"type":["string","null"],"description":"The bio."},"description_language":{"type":["string","null"]},"description_urls":{"type":"array","items":{"type":["string","null"]},"description":"The links of the bio","in full.":null},"location":{"type":["string","null"],"description":"As the account wrote it."},"website_url":{"type":["string","null"],"description":"The profile's link, in full."},"created_at":{"type":["string","null"],"format":"date-time"},"follower_count":{"type":["integer","null"]},"following_count":{"type":["integer","null"]},"tweet_count":{"type":["integer","null"]},"media_count":{"type":["integer","null"]},"like_count":{"type":["integer","null"],"description":"The tweets the account liked."},"is_blue_verified":{"type":["boolean","null"],"description":"The blue check of a paying subscriber."},"is_verified":{"type":["boolean","null"],"description":"X's earlier verification."},"verified_type":{"type":["string","null"],"description":"business or government, when X says so."},"is_protected":{"type":["boolean","null"]},"is_possibly_sensitive":{"type":["boolean","null"]},"professional":{"type":["object","null"],"additionalProperties":false,"required":["type","categories"],"properties":{"type":{"type":["string","null"],"description":"business or creator."},"categories":{"type":"array","items":{"type":["string","null"]}}}},"avatar_url":{"type":["string","null"]},"banner_url":{"type":["string","null"]},"avatar_shape":{"type":["string","null"],"description":"circle, square (organizations), hexagon."},"pinned_tweet_ids":{"type":"array","items":{"type":"string"}},"affiliation":{"type":["object","null"],"description":"The organization whose badge the account carries next to its name; null without one.","additionalProperties":false,"required":["name","url","badge_url","type"],"properties":{"name":{"type":["string","null"],"description":"The organization's name on the badge."},"url":{"type":["string","null"],"description":"The organization's profile, as X links it."},"badge_url":{"type":["string","null"],"description":"The badge's image."},"type":{"type":["string","null"],"description":"business_label on every badge seen."}}}}},"in_reply_to":{"type":["object","null"],"additionalProperties":false,"required":["tweet_id","user_id","handle"],"description":"The tweet it replies to; null when it is not a reply.","properties":{"tweet_id":{"type":["string","null"]},"user_id":{"type":["string","null"]},"handle":{"type":["string","null"]}}},"is_quote":{"type":["boolean","null"]},"quoted_tweet":{"type":["object","null"],"description":"The tweet it quotes, with a tweet's fields but position, quoted_tweet, retweeted_tweet, source_url and observed_at. Null when it quotes none, or one X no longer shows (ids.quoted_tweet_id still says which)."},"retweeted_tweet":{"type":["object","null"],"description":"The tweet it reposts, with the same fields as quoted_tweet."},"urls":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["url","display","short_url"],"properties":{"url":{"type":["string","null"],"description":"The link in full."},"display":{"type":["string","null"],"description":"As the page shows it."},"short_url":{"type":["string","null"],"description":"X's t.co link, as it stands in the text."}}}},"hashtags":{"type":"array","items":{"type":["string","null"]},"description":"Without the #."},"symbols":{"type":"array","items":{"type":["string","null"]},"description":"Cashtags, without the $."},"mentions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","handle","name"],"properties":{"id":{"type":["string","null"]},"handle":{"type":["string","null"]},"name":{"type":["string","null"]}}}},"media":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","type","url","page_url","width","height","alt_text","duration_ms","video_url","view_count"],"properties":{"id":{"type":["string","null"]},"type":{"type":["string","null"],"description":"photo, video or animated_gif."},"url":{"type":["string","null"],"description":"The image, or a video's poster."},"page_url":{"type":["string","null"]},"width":{"type":["integer","null"]},"height":{"type":["integer","null"]},"alt_text":{"type":["string","null"]},"duration_ms":{"type":["integer","null"]},"video_url":{"type":["string","null"],"description":"The video's file of the highest bitrate."},"view_count":{"type":["integer","null"]}}}},"card":{"type":["object","null"],"additionalProperties":false,"required":["type","url","title","description","domain","image_url"],"description":"The preview X draws under a tweet for a link, a poll or a player.","properties":{"type":{"type":["string","null"],"description":"X's name of the card: summary, summary_large_image, player..."},"url":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"domain":{"type":["string","null"]},"image_url":{"type":["string","null"]}}},"article":{"type":["object","null"],"additionalProperties":false,"required":["id","title","preview_text","cover_url","published_at","modified_at"],"description":"An X Article attached to the tweet (its title and preview, not its text).","properties":{"id":{"type":["string","null"]},"title":{"type":["string","null"]},"preview_text":{"type":["string","null"]},"cover_url":{"type":["string","null"]},"published_at":{"type":["string","null"],"format":"date-time"},"modified_at":{"type":["string","null"],"format":"date-time"}}},"place":{"type":["object","null"],"additionalProperties":false,"required":["id","name","full_name","type","country","country_code","bounding_box"],"description":"The place its author tagged it with (Ozuoba, Nigeria); null without one, which is most tweets. X gives the place and the box around it, never the point it was posted from.","properties":{"id":{"type":["string","null"],"description":"X's id of the place."},"name":{"type":["string","null"]},"full_name":{"type":["string","null"],"description":"The name with its region or country, as the page writes it."},"type":{"type":["string","null"],"description":"city, admin, country, neighborhood, poi."},"country":{"type":["string","null"]},"country_code":{"type":["string","null"],"description":"Two letters."},"bounding_box":{"type":"array","description":"The corners of the box around the place, each longitude then latitude.","items":{"type":"array","items":{"type":"number"}}}}},"posted_with":{"type":["string","null"],"description":"The app it was posted with, when X says it: Twitter Web App."},"is_paid_promotion":{"type":["boolean","null"],"description":"The author's own disclosure of a paid partnership."},"has_ai_generated_media":{"type":["boolean","null"],"description":"X's label of media made with AI."},"is_possibly_sensitive":{"type":["boolean","null"]},"is_long":{"type":"boolean","description":"A tweet longer than 280 characters; text holds it whole."},"edit":{"type":["object","null"],"additionalProperties":false,"required":["tweet_ids","editable_until","edits_remaining"],"properties":{"tweet_ids":{"type":"array","items":{"type":"string"},"description":"Its versions, the first to the last."},"editable_until":{"type":["string","null"],"format":"date-time"},"edits_remaining":{"type":["integer","null"]}}},"ids":{"type":"object","additionalProperties":false,"required":["tweet_id","conversation_id","author_id","quoted_tweet_id"],"properties":{"tweet_id":{"type":"string"},"conversation_id":{"type":["string","null"],"description":"The first tweet of its thread."},"author_id":{"type":["string","null"]},"quoted_tweet_id":{"type":["string","null"]}}},"source_url":{"type":"string","format":"uri","description":"The search on x.com."},"observed_at":{"type":"string","format":"date-time","description":"When it was read, UTC."}}},"x.tweets.search.Request":{"type":"object","required":["source","operation"],"description":"The tweets of a search on X (Twitter), 20 a page, with their text, counts, media and author, read with your connected X account.","properties":{"source":{"const":"x"},"operation":{"const":"tweets/search"},"options":{"$ref":"#/components/schemas/x.tweets.search.Options"},"timeout_s":{"type":"integer","minimum":1},"fields":{"type":"array","items":{"type":"string"},"description":"The record fields to keep, by path; `object`, `id` and `position` always come. Left out: every field."},"limit":{"type":"integer","minimum":1,"maximum":1000,"description":"Only the first N records of this call; the call costs the same, and `next` keeps the limit. Left out: every record."}}},"x.tweets.search.Answer":{"type":"object","required":["object","id","source","operation","version","status","count","has_more","next","cost","request_id","results"],"properties":{"object":{"const":"run"},"id":{"type":"string"},"created_at":{"type":"string"},"livemode":{"type":"boolean"},"source":{"const":"x"},"operation":{"const":"tweets/search"},"version":{"type":"string"},"schema_url":{"type":"string"},"options":{"type":"object"},"status":{"type":"string"},"count":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"oneOf":[{"$ref":"#/components/schemas/x.tweets.search.Request"},{"type":"null"}],"description":"The whole call for the following page: send it as it is."},"cost":{"type":"object","properties":{"credits":{"type":"number"}}},"balance":{"type":"object","properties":{"credits":{"type":"number"}}},"duration_ms":{"type":"integer"},"request_id":{"type":"string"},"results":{"type":"array","items":{"$ref":"#/components/schemas/x.tweets.search.Record"}}}}}}}