canonical: https://jentic.com/apis/justidea.agency/justidea # JustIdea Agency public API The JustIdea Agency public API serves the published website of JustIdea Agency, a Kraków e-commerce and performance marketing agency that builds PrestaShop and WooCommerce stores and runs SEO, paid ads, analytics, content, and branding work. It searches the site's services, pricing, case studies, city pages, and blog posts in Polish and English, lists pages by type with cursor paging, and returns any page as clean Markdown. A services endpoint returns each service category with its published net starting price, in PLN on Polish pages and EUR on English pages, and a batch call runs up to 10 reads as one request. It is read-only and never submits forms, books meetings, or sends messages. ## For AI agents Search and read JustIdea Agency's public website as Markdown in Polish or English, list its services with published net starting prices, and fetch contact options to pass to the user. Read-only, with an optional OAuth token for a higher rate limit. ## Scope Does not handle form submission, meeting booking, quotes, or messaging. Use for reading JustIdea Agency's public website content, published service prices, and contact options only. ## Capabilities - Search JustIdea Agency's public pages by q, filtered by lang (pl or en) and type such as service, pricing, case_studies, or blog - List public pages by type and language, paging with next_cursor until it is null - Read any public page as clean Markdown by full URL, path, or .md address - List service categories with their published net starting prices and packages in PLN or EUR - Fetch the agency's e-mail, phone, and contact page in Polish or English to hand to the user - Run 1 to 10 GET reads in one batch request that counts once against the rate limit ## Use cases ### Agency Shortlisting Through Jentic An AI agent helping a store owner compare e-commerce agencies searches JustIdea Agency's site for services and case studies that match the owner's platform, reads the most relevant pages as Markdown, and lists the published starting prices. Through Jentic the agent discovers these read operations by intent and calls them directly, then hands the user the contact options rather than contacting the agency itself. Example prompt: Search JustIdea Agency for 'sklep prestashop' with type 'case_studies', read the top two pages, list services with lang 'en', and return a summary with the contact options ### Price Answers Grounded in Published Figures A buyer asks what an online store or SEO retainer costs at JustIdea Agency. The agent lists services and quotes only the net starting prices the endpoint returns, together with the page URL, and says a price is quoted individually when from_price is null. Polish pages give PLN and English pages give EUR, so the agent picks the language that matches the buyer. Example prompt: List services with lang 'pl', find the online stores category, and report its net starting price in PLN with the page URL, noting any package whose from_price is null ### Batch Content Collection An agent preparing a briefing on the agency's offer sends one batch request that reads the services list, the contact options, and several pages at once. The batch runs the GET operations in order and counts as one request against the rate limit, and since it has no side effects it is always safe to retry. Example prompt: Send a batch request with reads of the services list, the contact options in 'en', and the page '/pl/uslugi/sklepy-internetowe/', then summarise the store-building offer ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/search` | Search the website | | GET | `/api/v1/page` | Read a page as Markdown | | GET | `/api/v1/pages` | List pages | | GET | `/api/v1/services` | List services and starting prices | | GET | `/api/v1/contact` | Get contact options | | POST | `/api/v1/batch` | Run several reads in one request | ## Key resources - **Pages** — Public website pages by type and language, searchable and readable as Markdown. - **Services** — Service categories with published net starting prices and packages. - **Contact options** — E-mail, phone, and contact page in Polish or English. ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 82 / 100 - **Maturity:** AI-Ready - **Dimensions:** - Foundational Compliance: 87 / 100 - Developer Experience & Jentic Compatibility: 69 / 100 - AI-Readiness & Agent Experience: 76 / 100 - Agent Usability: 94 / 100 - Security: 90 / 100 - AI Discoverability: 86 / 100 - **View full report:** https://jentic.com/apis/justidea.agency/justidea/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Calling JustIdea Agency by hand means handling its cursor paging, its batch request shape, its problem+json errors, and, for the higher rate limit, its OAuth 2.1 client registration and token refresh. Through Jentic you install once, import the JustIdea Agency public API from the API Directory, add a token only if you want the higher limit, and your agent calls it. - **Permission scoping:** The JustIdea Agency public API is read-only and carries its targets as query parameters such as url and q, so rules bound which operations your agent may call, such as search and page reads, not which page. You choose the operations it may call, so the batch and identity endpoints are not included unless you add them. - **Credential handling:** If you add the optional OAuth token, it is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'find JustIdea Agency case studies' or 'get e-commerce agency prices', and Jentic returns the matching JustIdea Agency operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **JustAutomate public API** — JustAutomate is a Polish automation agency whose site is readable through the same style of read-only API. - **Firecrawl** — Firecrawl turns any website into Markdown; the JustIdea Agency API serves its own site's content in that form natively. - **Semrush** — Semrush gives SEO and search visibility data to check alongside an agency's published SEO offer. ## FAQ ### What authentication does the JustIdea Agency public API use? Per its OpenAPI spec, the JustIdea Agency public API needs no credential for its read endpoints. An optional OAuth 2.1 bearer token with the site:read scope identifies your agent and raises the rate limit, and the two identity endpoints (GET `/api/v1/identity` and GET `/agent/identity`) require that token. If you add one through Jentic, it is stored encrypted by your own Jentic One instance and injected at call time. ### Is there a JustIdea Agency MCP server? Yes - JustIdea Agency offers an official MCP server at justidea.agency/mcp with the same public data. You can also connect the REST API directly through Jentic: your agent gets the full 10-endpoint surface from the spec without loading another server's tool definitions into its context, any token is injected at call time by your self-hosted instance instead of living in an MCP config, and your rules decide which operations the agent may call. ### Can I limit what my agent is allowed to do with the JustIdea Agency public API? Yes. Even though the API is read-only, you can write a rule that allows only the search, page read, and services operations, so a pricing agent answers questions without calling the batch or identity endpoints. Every call it makes is logged, giving you a record of which pages it read. ### Can my agent request a quote through the JustIdea Agency public API? No. Per its OpenAPI spec, the API never submits forms, books meetings, or sends messages. GET `/api/v1/contact` returns the e-mail, phone, and contact page in Polish or English for your agent to pass to the user, and GET `/api/v1/services` gives the published starting prices to cite before they get in touch. ### What are the rate limits for the JustIdea Agency public API? Per the JustIdea Agency OpenAPI spec, the limit is 120 requests per 60 seconds per IP address, or 600 per agent with an OAuth token. A batch counts as one request, and a 429 response carries a Retry-After header in seconds. ### How do I read JustIdea Agency's service prices through Jentic? Search Jentic for an intent like 'list JustIdea Agency service prices', import the JustIdea Agency public API from the API Directory, and your agent calls GET `/api/v1/services` with lang set to pl for PLN or en for EUR. Use GET `/api/v1/page` with the returned page URL to read the full service description. To run it on your own infrastructure, install Jentic One from its GitHub repo.