Datos de referencia

Listas de referencia estáticas — sitios de directorios y categorías.

• Readlist_sitesList the directory/publisher catalog OS can submit listings to (Google, Facebook, Apple, Bing + long-tail directories). Global reference data — no clientId. Filter by search (name or url), active, siteType, or country (ISO-2; includes worldwide sites). Ordered by priority (GABF first).
• Readlist_categoriesSearch the general business category taxonomy (mirrors Google's, thousands of entries). Global reference data — no clientId. Pass a `search` query; returns id + name. The id is a Category id (cuid) to set as a location's general category. For a specific publisher's own catalog, use list_publisher_categories.
• Readlist_publisher_categoriesSearch a single publisher's OWN category catalog — GABF: google, apple, bing, facebook. Global reference data. Returns that publisher's native category ids + display names. Apple categories are country-specific — pass country (ISO-2). Use the returned ids for a location's publisher categories (primaryCategoryGoogle / facebookCategoryId / appleCategoryId / bingCategoryId).
• Readlist_countriesList the countries a location can belong to (all ISO 3166-1 countries). Global reference data — no clientId. Returns each country's two-letter code (what create_location's countryIso takes), name, dial code, whether it has states/regions, and whether a postal address there uses a state at all. Optionally filter by `search` (code, name or alias, e.g. "usa") or `hasRegions`.
• Readlist_statesList the states / provinces / regions a location's stateIso can be. Global reference data — no clientId. Pass `country` (two-letter code, e.g. US) to get that country's complete list (the value to send is each entry's `code`). Without `country` all states are returned in pages: pass the previous `nextCursor` as `cursor` to continue. Filter with `search` or `type`.
• Readresolve_geo_valueAsk what code OS would store for a country or state value, BEFORE creating or editing a location. Global reference data — no clientId. field=country with a name or code returns its two-letter code; field=state needs `country` and returns the state code. Pass Google Places' short and long names as `value` and `valueLong` — they must agree. Returns { resolved: false } when the value is not in the reference list (OS never guesses); in that case pick from list_countries / list_states.