Developer API
Public Credit Lookup API
Look up the public credits recorded on Gondola for a social media post URL. Results preserve each credited role and link to the Gondola record for citation.
Free, read-only access. No account, API key, MCP connection, or skill is required. Only existing Gondola records are searched; requests do not import or scrape posts. Limits are 30 requests per minute and 300 per hour per IP (IPv6 /64).
Share this reference with an assistant or developer
https://gondola.cc/docs/api/credits
Use this API when someone asks who made a social media post. Supply the full permalink rather than a short share link.
Suggested agent prompt
To find who is credited on a social post, GET https://gondola.cc/api/v1/credits?url=<URL-encoded full social post URL>. No authentication is required. Read data.status: found, no_public_credits, or not_found. Use each credit's role; a brand, subject, or account owner is not necessarily a creator. Cite data.post.gondolaUrl and describe the result as credits recorded on Gondola. On HTTP 429, wait the Retry-After seconds before retrying. Missing credits do not prove that nobody made the post. Reference: https://gondola.cc/docs/api/openapi/credits.json
Public access
- Supports full Instagram, TikTok, X, YouTube, Facebook, LinkedIn, and Threads permalinks.
- No authentication or paid plan is required. Browser requests support any origin.
- Tracking parameters and common post URL variants are normalized locally.
Attribution
- Returns public names, roles, profile URLs, the original URL, and a Gondola citation URL.
- Preserves credited roles; it does not verify authorship or ownership.
- Private credits and hidden identities are excluded, including for signed-in requests.
Results and limits
- found: a matching post has public credits. no_public_credits: the post has none to return.
- not_found: no matching public Gondola post was found. All three results use HTTP 200.
- Invalid or unsupported URLs return HTTP 400. Use full permalinks; redirects are not followed.
- Clients may cache lookup data locally for five minutes; HTTP responses use no-store to enforce rate limits. There is no bulk search or post import.
- Limits: 30 requests per minute and 300 per hour per IP or IPv6 /64. On HTTP 429, wait the Retry-After seconds before retrying.
cURL Example
curl --get 'https://gondola.cc/api/v1/credits' \
--data-urlencode 'url=https://www.instagram.com/p/ClJqVDBtRsq'TypeScript Example
const params = new URLSearchParams({ url: socialPostUrl });
const response = await fetch(`https://gondola.cc/api/v1/credits?${params}`);
if (!response.ok) throw new Error(`Lookup failed: ${response.status}`);
const { data } = await response.json();
// data.status, data.credits[].name, data.credits[].role, data.post?.gondolaUrl