List Citation Taxonomy

Example request

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.mentionbird.ai/api/v1/citations/tags"

Example response

Recorded from a live call against a demo workspace, so the shape is exactly what the endpoint returns.

{
  "has_more": false,
  "items": [
    {
      "description": "Brand story or results-driven narrative about a specific company.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "case_study"
    },
    {
      "description": "Forums, Q&A threads, discussions — user-generated content pages.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "community"
    },
    {
      "description": "Side-by-side comparison of two or more products — 'X vs Y'.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "comparison"
    },
    {
      "description": "API docs, help centers, knowledge bases, FAQs, changelogs.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "documentation"
    },
    {
      "description": "General blog posts, articles, written content not matching a specific format above.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "editorial"
    },
    {
      "description": "Step-by-step tutorials, setup guides, walkthroughs — 'How to X'.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "how_to"
    },
    {
      "description": "About, team, contact, careers — company identity pages.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "identity"
    },
    {
      "description": "Campaign pages, lead capture, signup flows, demos.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "landing"
    },
    {
      "description": "Ranked or curated list articles — 'Top 10', 'Best X for Y', 'X alternatives'.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "listicle"
    },
    {
      "description": "",
      "dimension": "content_type",
      "is_misc": false,
      "name": "Listicle"
    },
    {
      "description": "Video pages, podcasts, galleries, portfolios.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "media"
    },
    {
      "description": "Page type could not be determined.",
      "dimension": "content_type",
      "is_misc": true,
      "name": "misc_content"
    },
    {
      "description": "Reporting on a specific event, announcement, launch, or funding round.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "news"
    },
    {
      "description": "Product pages, pricing, features, commercial/service pages.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "product"
    },
    {
      "description": "Wikipedia-style entries, glossaries, definitions, data tables.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "reference"
    },
    {
      "description": "White papers, academic papers, surveys, data-driven reports.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "research"
    },
    {
      "description": "In-depth evaluation of a product or service.",
      "dimension": "content_type",
      "is_misc": false,
      "name": "review"
    },
    {
      "description": "Academic papers and research platforms — arXiv, Google Scholar, PubMed.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "academic_research"
    },
    {
      "description": "Blog platforms and publication subdomains — Medium, Substack, blog.hubspot.com.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "blog_publication"
    },
    {
      "description": "Company primary websites, product and pricing pages — stripe.com, shopify.com.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "corporate_commercial"
    },
    {
      "description": "Technical docs and developer resources — GitHub, docs.stripe.com, MDN.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "documentation_developer"
    },
    {
      "description": "Wiki-style and reference sites — Wikipedia, Britannica, Investopedia.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "encyclopedia_reference"
    },
    {
      "description": "Discussion platforms and Q&A sites — Reddit, StackExchange, Quora.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "forum_community"
    },
    {
      "description": "Government, education, and institutional sites — .gov, .edu, WHO.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "government_institutional"
    },
    {
      "description": "Help centers and support portals — help.shopify.com, support.google.com.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "help_support"
    },
    {
      "description": "App stores, directories, and listing sites — apps.shopify.com, Product Hunt.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "marketplace_aggregator"
    },
    {
      "description": "Domain type could not be determined.",
      "dimension": "source_type",
      "is_misc": true,
      "name": "misc_source"
    },
    {
      "description": "News outlets and media publications — NYT, TechCrunch, BBC.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "news_media"
    },
    {
      "description": "Review aggregators and comparison platforms — G2, Capterra, Trustpilot.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "review_comparison"
    },
    {
      "description": "Social media platforms — LinkedIn, X/Twitter, YouTube.",
      "dimension": "source_type",
      "is_misc": false,
      "name": "social"
    }
  ],
  "returned_count": 30,
  "total_count": 30
}

Responses

200

Citation taxonomy.

400

Validation error — check the message in `error.message`.

401

Unauthorized — missing, invalid or revoked bearer token.

403

Forbidden — plan lacks API access, or key is read-only.

404

Not found — the brand, prompt or resource does not exist.

405

Method not allowed.

500

Internal error — logged; retry is safe for reads.