What you get
| Field | Type |
|---|---|
title |
string |
currency |
string |
rating |
number |
url |
string |
image_url |
string |
address_country |
string |
address_region |
string |
award |
string |
All 72 fields
Key fields
titlecurrencyratingurlimage_urladdress_countryaddress_regionawardis_prolicensepractice_areasprice_rangereview_scoretagline_labelwebsite_urlreview_countbiographyfees_and_ratescostseller_descriptiongalleryonline_presenceavvo_review_scoredescription_introlegal_answerscategorylocalitycountryexperience_backgroundlegal_community_recognitionlegal_thought_leadershipfacebook_urlactivity_urlawardsalternate_nameprofile_urllanguageslicense_namelicensing_organizationlicense_dateprofessional_membershipsrating_scale_maximumrating_scale_minimumrating_sourcelegal_answers_countpeer_endorsements_countservice_areaaccepted_payment_methodsconsultation_offerrelated_linksimage_description
Technical fields
aggregated_review_tooltipbiocta_textlawyer_idremotecategory_pathregiondetail_ratingdetail_review_countexternal_urlrating_breakdownmedialinkedin_urldetail_practice_areastyped_detail_ratingtyped_detail_review_counttyped_legal_answers_counttyped_peer_endorsements_counttyped_rating_scale_maximumtyped_rating_scale_minimumtyped_review_score
Sample records
1 of 2 saved records. This is a saved sample, not a live run.
title |
currency |
rating |
url |
image_url |
address_country |
|---|---|---|---|---|---|
| Bobby Shamuilian | USD | 10 | avvo.com/attorneys/91730-ca-bobby-shamuil… | images.avvo.com/avvo/ugc/images/head_shot… | U.S.A |
Scroll sideways to see more columns.
Inputs
-
locationtext · requiredFree text: any location the site serves, written with letters, digits, underscores and hyphens, up to 32 characters. A name the site does not serve is refused.
-
searchstring | array of stringOptional. Text for the site's search box. Leave it out to read everything.
-
categorytextOptional. Free text: any category the site serves, written with letters, digits, underscores and hyphens, up to 58 characters. A name the site does not serve is refused. Leave it out to use the default: personal-injury-lawyer.
-
sortchoiceOrder of the collection, as the site's own sort control offers it; omitted keeps the site's default order.
-
has_free_consultationbooleanFilters by has free consultation.
2 more inputs
-
langchoiceOptional. Filters by lang.
-
specialty_nameschoiceOptional. Filters by specialty names.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_27cb9d9295b4f7ca1a4ff06b/endpoints/generated_27cb9d9295b4f7ca1a4ff06b_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_27cb9d9295b4f7ca1a4ff06b/endpoints/generated_27cb9d9295b4f7ca1a4ff06b_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"location": "ca",
"lang": "Arabic"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Avvo Lawyer Directory API.
The agent finds the API, runs it and reads the records. Runs are charged like any other run.
Coverage
- Category
- Businesses & places
A run stops when the source has no more records, or when it reaches a limit you set: the number of records, the time, or your budget.
CleanedWeb is not affiliated with Avvo.