facebook pixel

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