geodirectory/get-directory-overview returns every GeoDirectory listing type on this site with its REST base and listing count, plus which add-ons are active.
Start here. Two assumptions people make about GeoDirectory are wrong often enough to be worth checking every time.
At a glance
| Ability | geodirectory/get-directory-overview |
| Toolset | GeoDirectory — toolset/geodirectory |
| Group | GeoDirectory › Directory & Pages |
| Requires | AcrossAI Pro, plus GeoDirectory active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
The first is that the listing type is gd_place. It is on a default install and it is not on a site that has added a second directory — restaurants and events, venues and suppliers — and the wrong post type produces a 404 rather than an empty result.
The second is that location and proximity parameters work. They are part of the Location Manager add-on, and on a site without it a near or distance parameter is ignored rather than refused. The search returns results; they are simply not filtered by location.
Both are reported here in one call, along with the listing counts — which are the fastest way to tell an empty directory from one where nothing was published.
The REST bases matter for anything going through GeoDirectory’s own API rather than these abilities, since they are derived from the listing type rather than fixed.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
listing_types | array | Each listing type with its slug, label, REST base and listing count. |
addons | object | Which GeoDirectory add-ons are active. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
What directories does this site run?
It resolves to one call:
{
"ability": "geodirectory/get-directory-overview",
"parameters": {}
}Worth knowing
- The listing type is not always
gd_place. - Location parameters are silently ignored without Location Manager.
- Listing counts distinguish an empty directory from an unpublished one.
- Read-only.
Related abilities
- GeoDirectory List Listing Fields — the schema for a type
- GeoDirectory List Listings — the listings themselves
- GeoDirectory List Locations — if Location Manager is active
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category