Skip to main content
Fetch a real-estate agency’s full profile by its numeric id (from a listing’s agency.id or its portal URL). Pair with /agencies/{id}/listings to pull the agency’s active inventory.

​
Path Parameters

​
id
integer
required
Immobiliare agency id, e.g. 41235.

​
Query Parameters

​
market
string
default:"it"
Market the agency belongs to. One of it, es, gr, lu.

​
Response

The full AgencyProfile:
​
id
integer
Agency id.
​
type
string
e.g. agency, builder.
​
name
string
​
url
string
Agency profile URL on the portal.
​
address
string
Street address of the office.
​
description
string
Agency self-description.
​
website
string
Agency’s own website.
​
image
string
Agency logo URL.
​
is_paid
boolean
Paid portal customer.
​
partnership
string
Franchise / network affiliation, e.g. tecnocasa.
​
real_estate_ads
integer
Active listings count.
​
real_estate_sales
integer
Completed sales count.
​
region
string
​
province
string
​
city
string
​
macrozone
string
​
latitude
number
​
longitude
number
​
phones
string[]
Office phone numbers.
​
opening_hours
string[]
Opening-hours lines.
​
agents
Agent[]
Agent roster.
​
market
string
Echo of the requested market.

​
Example

const res = await fetch(
  "https://api.scrapebadger.com/v1/immobiliare/agencies/41235?market=it",
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const agency = await res.json();
Response
{
  "id": 41235,
  "type": "agency",
  "name": "Tecnocasa Milano Crescenzago",
  "url": "https://www.immobiliare.it/agenzie-immobiliari/41235/tecnocasa-milano/",
  "address": "Via Padova 130, 20127 Milano",
  "description": "Affiliato Tecnocasa attivo dal 2003 nella zona Cimiano-Crescenzago. Compravendite e locazioni residenziali, valutazioni gratuite.",
  "website": "https://milano-crescenzago.tecnocasa.it",
  "image": "https://pic.im-cdn.it/agency/41235/large.png",
  "is_paid": true,
  "partnership": "tecnocasa",
  "real_estate_ads": 48,
  "real_estate_sales": 312,
  "region": "Lombardia",
  "province": "Milano",
  "city": "Milano",
  "macrozone": "Cimiano, Crescenzago, Adriano",
  "latitude": 45.498,
  "longitude": 9.2301,
  "phones": ["+39 02 2846120", "+39 02 2846121"],
  "opening_hours": [
    "Mon-Fri 09:00-13:00, 14:30-19:00",
    "Sat 09:00-12:30"
  ],
  "agents": [
    {
      "id": 998877,
      "name": "Marco",
      "surname": "Rossi",
      "gender": "male",
      "thumbnail": "https://pic.im-cdn.it/agent/998877/thumb.jpg"
    },
    {
      "id": 998878,
      "name": "Giulia",
      "surname": "Bianchi",
      "gender": "female",
      "thumbnail": "https://pic.im-cdn.it/agent/998878/thumb.jpg"
    }
  ],
  "market": "it"
}
Each agency-profile request costs 5 credits. Failed requests are not charged.