logoPandorLabs
Sign inBook a demo
Lead Generation

Angi Service Professionals

Home-service contractors listed on Angi by trade and postal code, with phone, email and address.

angi-prosangilead-generationdirectoryhome-servicescontractorslocal-businessusa

5 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/angi-pros/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 5 rows, this download costs 1 credit when the data is fresh enough, or 2 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/angi-pros/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "categoryIds": [        "51",        "119",        "157",        "196"      ],      "zipCodes": [        "10001",        "90001",        "60601",        "77001",        "85001",        "19101",        "78201",        "92101",        "75201",        "95101",        "78701",        "32099",        "43085",        "28201",        "46201",        "98101",        "80201",        "20001",        "02101",        "37201"      ],      "zipBatchSize": 100,      "enrichProfiles": true    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

  • categoryIds

    string[]

    Service category ids

    Angi's `alCategoryId` values. One sweep per id. The full known list is in `angi-categories.data.ts`; the default is five high-volume trades because a full sweep is 749 of them.

    Default
    ["51","119","157","196"]
    Example
    12, 51, 119
  • zipCodes

    string[]

    Postal codes

    Sent to the endpoint in batches, which returns pros serving any code in a batch. The default is one code per major metro; paste a larger list to widen coverage.

    Default
    ["10001","90001","60601","77001","85001","19101","78201","92101","75201","95101","78701","32099","43085","28201","46201","98101","80201","20001","02101","37201"]
    Example
    10001, 90001, 60601
  • zipBatchSize

    number

    Postal codes per request

    Larger batches mean far fewer requests against a rate-limited endpoint.

    Default
    100
    Range
    1 to 200
  • enrichProfiles

    boolean

    Fetch profile pages

    The listing endpoint returns no contact details. Turning this off gives you a fast inventory of who exists, and nothing to contact them with.

    Default
    true
  • requireContact

    boolean

    Require an email or phone

    Drops pros whose profile publishes neither. Ignored when profile fetching is off.

    Default
    false

Advanced

  • maxPros

    number

    Max pros per run

    Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.

    Default
    5000
    Range
    1 to 500000
  • maxPagesPerQuery

    number

    Max pages per category/batch

    Default
    20
    Range
    1 to 1000
  • pageSize

    number

    Listings per page

    The endpoint rejects anything above 20.

    Default
    10
    Range
    1 to 20
  • categoryBatchSize

    number

    Categories per request

    The endpoint takes several category ids at once and returns the union. Batching cuts requests but blurs which category matched.

    Default
    1
    Range
    1 to 25
  • enrichConcurrency

    number

    Concurrent profile fetches

    Angi is behind Cloudflare; pushing this up trades throughput for challenge pages.

    Default
    5
    Range
    1 to 25
  • requestDelayMs

    number

    Delay between requests (ms)

    Default
    750
    Range
    0 to 60000
  • haCategoryId

    string

    HomeAdvisor category id

    v2 required this; v3 does not, so it is sent only if set.

    Default
    none
  • traffic

    string

    Traffic type

    Required by the endpoint. `SEO` is what the public site sends.

    Default
    SEO
  • brand

    string

    Brand

    Default
    ANGI
Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema
{  "type": "object",  "additionalProperties": false,  "properties": {    "categoryIds": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Service category ids",      "description": "Angi's `alCategoryId` values. One sweep per id. The full known list is in `angi-categories.data.ts`; the default is five high-volume trades because a full sweep is 749 of them.",      "default": [        "51",        "119",        "157",        "196"      ],      "examples": [        "12, 51, 119"      ]    },    "zipCodes": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Postal codes",      "description": "Sent to the endpoint in batches, which returns pros serving any code in a batch. The default is one code per major metro; paste a larger list to widen coverage.",      "default": [        "10001",        "90001",        "60601",        "77001",        "85001",        "19101",        "78201",        "92101",        "75201",        "95101",        "78701",        "32099",        "43085",        "28201",        "46201",        "98101",        "80201",        "20001",        "02101",        "37201"      ],      "examples": [        "10001, 90001, 60601"      ]    },    "zipBatchSize": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Postal codes per request",      "description": "Larger batches mean far fewer requests against a rate-limited endpoint.",      "default": 100    },    "enrichProfiles": {      "type": "boolean",      "title": "Fetch profile pages",      "description": "The listing endpoint returns no contact details. Turning this off gives you a fast inventory of who exists, and nothing to contact them with.",      "default": true    },    "requireContact": {      "type": "boolean",      "title": "Require an email or phone",      "description": "Drops pros whose profile publishes neither. Ignored when profile fetching is off.",      "default": false    },    "maxPros": {      "type": "number",      "minimum": 1,      "maximum": 500000,      "title": "Max pros per run",      "description": "Rows persist and re-runs upsert, so a ceiling here bounds one run, not the dataset.",      "default": 5000    },    "maxPagesPerQuery": {      "type": "number",      "minimum": 1,      "maximum": 1000,      "title": "Max pages per category/batch",      "default": 20    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Listings per page",      "description": "The endpoint rejects anything above 20.",      "default": 10    },    "categoryBatchSize": {      "type": "number",      "minimum": 1,      "maximum": 25,      "title": "Categories per request",      "description": "The endpoint takes several category ids at once and returns the union. Batching cuts requests but blurs which category matched.",      "default": 1    },    "enrichConcurrency": {      "type": "number",      "minimum": 1,      "maximum": 25,      "title": "Concurrent profile fetches",      "description": "Angi is behind Cloudflare; pushing this up trades throughput for challenge pages.",      "default": 5    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 750    },    "haCategoryId": {      "type": "string",      "maxLength": 2000,      "title": "HomeAdvisor category id",      "description": "v2 required this; v3 does not, so it is sent only if set."    },    "traffic": {      "type": "string",      "maxLength": 2000,      "title": "Traffic type",      "description": "Required by the endpoint. `SEO` is what the public site sends.",      "default": "SEO"    },    "brand": {      "type": "string",      "maxLength": 2000,      "title": "Brand",      "default": "ANGI"    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/angi-pros/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "categoryIds": [        "51",        "119",        "157",        "196"      ],      "zipCodes": [        "10001",        "90001",        "60601",        "77001",        "85001",        "19101",        "78201",        "92101",        "75201",        "95101",        "78701",        "32099",        "43085",        "28201",        "46201",        "98101",        "80201",        "20001",        "02101",        "37201"      ],      "zipBatchSize": 100,      "enrichProfiles": true    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

FieldTypeCoverage
amenitiesarray100%
business_typestring100%
citystring100%
countrystring100%
descriptionstring100%
found_via_category_idsarray100%
is_advertiserboolean100%
is_sponsoredboolean100%
logo_urlstring100%
namestring100%
postal_codestring100%
pro_idstring100%
profile_pathstring100%
recent_lead_countnumber100%
recommended_ratenumber100%
response_ratenumber100%
response_time_secondsnumber100%
review_countnumber100%
serves_postal_codesarray100%
star_ratingnumber100%
statestring100%
street1string100%
tasks_offeredarray100%
created_atdate100%
first_seen_atdate100%
last_seen_atdate100%
updated_atdate100%
_idstring100%
logoPandorLabs

© 2026 PandorLabs LLC. All rights reserved.

WhatsApp BusinessTelegram