primary_rubric
Optional
The category 2GIS marks as primary, lifted out for convenience.
2GIS Business Scraper — Phones, Sites & Emails
Pricing
from $8.50 / 1,000 business records
Read a 2GIS organisation in full from its id: the phone numbers, websites and email addresses a search row never carries, plus the street address with its city, coordinates, every category, opening hours, the chain it belongs to and 2GIS's own structured attributes.
Pricing
from $8.50 / 1,000 business records
Rating
0.0
(0)
Developer
The Netaji
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
query
Optional
The search term this row answered, so a run over several terms splits back apart.
requested_city
Optional
The city slug this row was searched in.
requested_id
Optional
The branch id this row was read for, echoed back after cleaning.
page
Optional
Which page of results this row was on.
is_partial_match
Optional
The field that tells you whether these rows answer your query at all. True means 2GIS could not match the term and returned unrelated real businesses anyway, under a healthy response with identical row shapes. Measured over 15 queries in 5 cities it separated them perfectly: false on 10 of 10 real queries, true on 5 of 5 nonsense ones. Filter on this before anything else.
match_type
Optional
Which search mode answered — not how well it did. discovery means 2GIS resolved the term to one of its own categories and browsed it; recovery means it ran a literal text search instead. recovery is not a warning: measured, four brand and category terms took that path and every one answered well. Branch on is_partial_match, not on this.
relevance
Optional
2GIS's own relevance for this row against the query, and the numeric corroboration for is_partial_match. Real matches measured 10.98 to 8,827.83 and unmatched ones 4.8e-16 to 2.9e-06 — seven orders of magnitude apart, with no overlap.
max_relevance
Optional
The best relevance anywhere in the page this row came from.
total_results
Optional
How many results 2GIS says the query has in this city. Unlike most sources this one is reachable: pages run to ceil(total / page size) and the last one is short rather than the walk dying early.
id
Optional
The branch id, and the exact value the Business and Reviews Actors take. 2GIS's own search response does not publish this: its id is this value plus a 130-character per-request context blob that works nowhere else on the site. The tail is stripped here and kept as search_context_id.
search_context_id
Optional
2GIS's undecorated search id, kept rather than discarded. It is per-request and carries the ad and ranking context; null on a business-detail row, which has no such tail.
name
Optional
The organisation's name, as 2GIS files it.
type
Optional
2GIS's own object type. These Actors ask for branches.
url
Optional
The organisation's public 2GIS page. Open it and you see the same record.
street_address
Optional
2GIS's own address line, which is the STREET only — the city is not in it, and comes from the administrative division published beside it.
address_comment
Optional
How to find the entrance once you are at the address.
building_name
Optional
The building's own name, where it has one.
postcode
Optional
Postal code.
country
Optional
Country, as 2GIS names it.
region
Optional
The administrative region.
address_city
Optional
The city, lifted out of 2GIS's administrative division list — which is where it actually lives, because the street line does not contain it.
district
Optional
The district within the city.
settlement
Optional
The settlement, where 2GIS files one.
latitude
Optional
Latitude.
longitude
Optional
Longitude.
region_id
Optional
2GIS's internal id for the city. Not derivable from anything a caller has — Moscow is 32, Novosibirsk is 1, Dubai is 99 — which is why the city input is a slug and this is published rather than expected.
city_alias
Optional
The city slug this branch sits in.
primary_rubric
Optional
The category 2GIS marks as primary, lifted out for convenience.
rubrics
Optional
Every category 2GIS files the organisation under, each with its id, name, slug and whether it is the primary one.
schedule
Optional
Opening hours per weekday in 2GIS's own shape, including its own keys for round-the-clock and closed. Republished rather than renamed, because there is no measured field list to rename it into.
attribute_groups
Optional
2GIS's own structured attributes — average cheque, cuisine, amenities — grouped as it groups them. Rich on a business-detail row and sparse on a search row.
phones
Optional
Dialable phone numbers. Empty on every search row and populated on every business-detail row — that is a property of which lookup produced the row rather than of the business, because 2GIS's own search request omits contact fields entirely. No amount of paging a search produces a phone number.
websites
Optional
The organisation's real websites. 2GIS puts its own click-tracking redirector where the website should be; the real address is published here and the redirector is kept separately, so this column never hands you a tracking link as a business's site.
emails
Optional
Email addresses, where the organisation publishes any.
contacts
Optional
Every contact in full: the real value, 2GIS's formatted rendering of it, the comment naming which department a number belongs to, and its click-tracking redirector where there is one.
chain_id
Optional
The chain this branch belongs to, where it belongs to one.
chain_name
Optional
That chain's name.
chain_branch_count
Optional
How many branches the chain has in this city's catalogue.
rating
Optional
This branch's own rating. Published beside the chain's on purpose: a branch frequently disagrees with its parent, and quoting either alone misstates the other.
review_count
Optional
How many ratings this branch has. Larger than the number of reviews the Reviews Actor will serve, because that one returns written reviews only.
org_rating
Optional
The whole chain's rating, where this is a chain branch.
org_review_count
Optional
The whole chain's rating count.
is_reviewable
Optional
Whether 2GIS accepts reviews for this branch.
is_advertisement
Optional
True when this row is a paid placement. 2GIS mixes advertised organisations into the ranked list, so a caller measuring ranking has to be able to exclude them.
region_name
Optional
The name of the region the city slug resolved to.
country_code
Optional
The country the city sits in.
locale
Optional
The locale this record was returned in.