Storapulse API v1

A read-only API that returns the results already computed for your stores. A call never triggers a computation: for a fresh result, submit a request and it will be processed by the usual queue.

Authentication

Create a key in your account, then send it in the header:

Authorization: Bearer VOTRE_CLE

Example

curl -H "Authorization: Bearer VOTRE_CLE" \
  "https://storapulse.com/api/v1/positions?domaine=ma-boutique.fr&limite=50"

Response: { "data": …, "meta": { "genere_le", "source": "storapulse", "limite", "offset" } }. Pagination: limite (50 by default, 200 max) and offset (10,000 max). The X-Quota-Restant header shows the calls left this month.

Endpoints

`GET`	`/api/v1/sites`	Your stores and domains.
`GET`	`/api/v1/scans?domaine=`	Latest AI visibility scans and latest GEO audit.
`GET`	`/api/v1/positions?domaine=`	Tracked keywords, ranking history and search volume.
`GET`	`/api/v1/pages?domaine=`	Crawled pages: URL, title, status, H1, issues.
`GET`	`/api/v1/citations?domaine=`	Mentions of your brand by AI assistants.
`GET`	`/api/v1/visites?domaine=&jours=30`	Visits aggregated by day and by source (90 days max).
`GET`	`/api/v1/reputation?domaine=`	Reputation score and backlinks (any domain).
`GET`	`/api/v1/demandes`	Your computation requests and their status.
`POST`	`/api/v1/demandes`	Request a fresh computation: `{"type":"scan"\|"positions"\|"recolte","domaine":"…"}` (20 pending max).

Quotas by plan (calls per month)

Measure	1,000
Fix	3,000
Steer	5,000
Agencies	15,000
Agency+	30,000
Agency Max	50,000

Extra call packs

One-time payment, valid for 12 months, used once the plan's monthly quota runs out. The MCP connector counts toward the same quota.

10,000 calls	€9
50,000 calls	€29
200,000 calls	€79

Errors

Errors return { "erreur": "code" }.

`400`	Invalid parameter (domain, body).
`401`	Missing or invalid key.
`403`	Domain that does not belong to you, or plan without API access.
`429`	Monthly quota or rate limit exceeded, or too many pending requests.

Personal data (emails, phone numbers) is masked in every response.

MCP connector

Plug Storapulse into your AI assistant and ask questions about your stores in plain language ("which pages have defects?", "am I cited by AI?"). The connector only reads your results; it changes nothing.

Connector address :

https://storapulse.com/api/mcp

Claude: Settings › Connectors › Add custom connector, then paste the address and your API key.
ChatGPT: Settings › Connectors (developer mode on) › Create, then paste the address and your API key.
Cursor: add this to your mcp.json file:

{
  "mcpServers": {
    "storapulse": {
      "url": "https://storapulse.com/api/mcp",
      "headers": { "Authorization": "Bearer VOTRE_CLE" }
    }
  }
}

Included from the Measure plan, at no extra cost. Each tool call counts as 1 API call in your monthly quota.

Available tools

`list_sites`	List the stores (domains, names, platforms) owned by this API key's account.
`get_scans`	Latest AI-visibility scans (cited or not by each AI engine, competitors) and the latest GEO audit with suggested fixes for one store.
`get_positions`	Tracked Google keywords for one store: current position, history and search volume.
`get_pages`	Crawled pages of one store: URL, status, title, H1, word count and detected SEO defects.
`get_citations`	Times AI assistants cited the store's brand: engine, question, rank, reason.
`get_visits`	Aggregated visits per day and per source, including visits from AI engines (up to 90 days).
`get_reputation`	Host reputation score and inbound links (public Common Crawl data) for any domain.
`get_ranking`	Latest stored ranking-factor model for one store: which factors weigh most on its Google positions.
`get_local_seo`	Latest stored local SEO report for one store (score and details).
`list_requests`	Fresh-computation requests already submitted by this account and their status (read only).