API

Citation building as an API

Plan listings for your clients from your own tools. JSON over HTTPS, CORS enabled, no key needed for the read-only endpoints.

https://heycite.me/api/v1

REST · JSON

/api/v1

v1

GET /directories

POST /plan

GET /pricing

CORS enabled

No key for read-only

Open

GET/directories

The platforms we know well; each order adds platforms researched for the business. Optional query parameters: country (ISO code), businessType (software, local, b2b_service, ecommerce), kind (citation, software, startup).

Request
curl "https://heycite.me/api/v1/directories?country=CH&businessType=software"

POST/plan

Which known platforms fit a business, how many the agent can create, the owner's to-dos and the suggested package. The order itself researches more.

Request
curl -X POST https://heycite.me/api/v1/plan \
  -H 'content-type: application/json' \
  -d '{"country":"DE","businessType":"local","markets":["DE","AT"]}'

GET/pricing

Packages with one-time prices in USD and the maximum listings per package.

Request
curl https://heycite.me/api/v1/pricing

Example

Plan response

200 OK
{
  "country": "CH",
  "markets": ["CH"],
  "listingsByAgent": 27,
  "ownerTodos": 6,
  "suggestedPackage": { "id": "growth", "name": "Growth", "price": 99, "currency": "USD" },
  "directories": [
    { "id": "local-ch", "name": "local.ch", "kind": "citation", "submission": "agent", ... },
    { "id": "google-business", "name": "Google Business Profile", "submission": "owner_todo", ... }
  ]
}

Ordering

Creating orders

Orders start on heycite.me so the business owner can check the profile and pay. Link people to https://heycite.me/?url=example.com&country=CH and the form is ready. API keys with credit-based ordering for agencies are planned; write to team@heycite.me for early access. Prefer agents? Use the MCP server.

New entry · heycite.me

Put your business on file.

Enter your website, check the profile we build, and pick a package. We find the directories that matter for you and file only on reputable platforms.