> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuralverge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Product Hunt leaderboards

> Launches of a Product Hunt leaderboard (day, week, month or year): rank, name, tagline, votes, comments, topics and product link, beyond the first page. 1 point per returned record.



## OpenAPI

````yaml /openapi.json post /functions/v1/run-producthunt-leaderboards
openapi: 3.0.0
info:
  title: NeuralVerge API
  version: 1.0.0
  description: >-
    NeuralVerge API for AI research, search, extraction, and structured data
    source execution.
servers:
  - url: https://api.neuralverge.ai
    description: NeuralVerge API
security:
  - BearerAuth: []
tags:
  - name: AI Research
    description: Multi-step research workflows and the sessions they run in.
  - name: AI Extract
    description: Schema-driven extraction workflows.
  - name: Search
    description: Fast, synchronous web search with no session or polling.
  - name: Company intelligence
    description: Company profile lookups from company databases.
  - name: E-commerce & Marketplaces
    description: >-
      Product, seller, and review lookups on Amazon, eBay, Walmart, AliExpress,
      and Alibaba.
  - name: Enrichment
    description: Email and phone enrichment, validation, and discovery.
  - name: Product reviews
    description: >-
      Software and business reviews from Capterra, Gartner Peer Insights, and
      Trustpilot.
  - name: Social media
    description: LinkedIn profile, company, and people lookups.
  - name: Company Registries
    description: Company Registries data sources.
  - name: Startup & Funding Data
    description: Startup & Funding Data data sources.
paths:
  /functions/v1/run-producthunt-leaderboards:
    post:
      tags:
        - Startup & Funding Data
      summary: Product Hunt leaderboards
      description: >-
        Launches of a Product Hunt leaderboard (day, week, month or year): rank,
        name, tagline, votes, comments, topics and product link, beyond the
        first page. 1 point per returned record.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                period:
                  description: >-
                    Period. Options: daily = Daily, weekly = Weekly, monthly =
                    Monthly, yearly = Yearly
                  type: string
                  enum:
                    - daily
                    - weekly
                    - monthly
                    - yearly
                date:
                  description: >-
                    Date (daily 2024/1/15, weekly 2024/3, monthly 2024/3, yearly
                    2024). e.g. 2024/1/15
                  type: string
                featured:
                  description: Featured only
                  type: boolean
                max_items:
                  description: Max items (up to 250)
                  type: integer
                  minimum: 1
                  maximum: 250
                  default: 25
                start_page:
                  description: Starting page
                  type: integer
                  minimum: 1
              required:
                - date
            example:
              date: 2024/1/15
              max_items: 2
      responses:
        '200':
          description: Run completed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Session identifier for this run.
                  kind:
                    type: string
                    description: Data source identifier for this endpoint.
                  period:
                    type: string
                  date:
                    type: string
                  max_items:
                    type: integer
                  start_page:
                    type: integer
                  partial:
                    type: boolean
                    description: >-
                      True when the scrape stopped early and returned the
                      records collected so far.
                  human:
                    type: string
                    description: Markdown summary of the result, for display.
                  machine:
                    type: object
                    properties:
                      total_items:
                        type: integer
                      first_item:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          url:
                            type: string
                          alias:
                            type: string
                          launch_id:
                            type: string
                          rank:
                            type: integer
                          tagline:
                            type: string
                          votes_count:
                            type: integer
                          comments_count:
                            type: integer
                          topics:
                            type: array
                            items:
                              type: object
                              properties:
                                name:
                                  type: string
                                slug:
                                  type: string
                                url:
                                  type: string
                          image:
                            type: string
                          product_slug:
                            type: string
                          product_url:
                            type: string
                          featured_at:
                            type: string
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            url:
                              type: string
                            alias:
                              type: string
                            launch_id:
                              type: string
                            rank:
                              type: integer
                            tagline:
                              type: string
                            votes_count:
                              type: integer
                            comments_count:
                              type: integer
                            topics:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                  slug:
                                    type: string
                                  url:
                                    type: string
                            image:
                              type: string
                            product_slug:
                              type: string
                            product_url:
                              type: string
                            featured_at:
                              type: string
                      total_found: {}
                      page_count:
                        type: integer
                      blocked:
                        type: boolean
                      proxy_traffic_bytes:
                        type: integer
                    description: Structured result payload.
                  total_points:
                    type: integer
                    description: Points charged for this run.
              example:
                session_id: 11111111-1111-1111-1111-111111111111
                kind: producthunt_leaderboards
                period: daily
                date: 2024/1/15
                max_items: 2
                start_page: 1
                partial: false
                human: |-
                  # Product Hunt — leaderboards

                  - **Query:** period=daily, date=2024/1/15
                  - **Results:** 2
                  - **Proxy traffic:** 31.4 KB
                machine:
                  total_items: 2
                  first_item:
                    id: ai-picasso-ai-dance
                    name: AI Picasso - AI dance
                    url: https://www.producthunt.com/posts/ai-picasso-ai-dance
                    alias: ai-picasso-ai-dance
                    launch_id: '434214'
                    rank: 1
                    tagline: Full body AI dance from photos
                    votes_count: 314
                    comments_count: 275
                    topics:
                      - name: Android
                        slug: android
                        url: https://www.producthunt.com/topics/android
                      - name: iOS
                        slug: ios
                        url: https://www.producthunt.com/topics/ios
                    image: >-
                      https://ph-files.imgix.net/6fac80c0-fafa-4033-9374-9c7d1e30437d.png?auto=format&fit=crop&w=128&h=128
                    product_slug: ai-picasso
                    product_url: https://www.producthunt.com/products/ai-picasso
                    featured_at: '2024-01-15T00:23:23-08:00'
                  items:
                    - id: ai-picasso-ai-dance
                      name: AI Picasso - AI dance
                      url: https://www.producthunt.com/posts/ai-picasso-ai-dance
                      alias: ai-picasso-ai-dance
                      launch_id: '434214'
                      rank: 1
                      tagline: Full body AI dance from photos
                      votes_count: 314
                      comments_count: 275
                      topics:
                        - name: Android
                          slug: android
                          url: https://www.producthunt.com/topics/android
                        - name: iOS
                          slug: ios
                          url: https://www.producthunt.com/topics/ios
                      image: >-
                        https://ph-files.imgix.net/6fac80c0-fafa-4033-9374-9c7d1e30437d.png?auto=format&fit=crop&w=128&h=128
                      product_slug: ai-picasso
                      product_url: https://www.producthunt.com/products/ai-picasso
                      featured_at: '2024-01-15T00:23:23-08:00'
                    - id: team-analytics-by-codemonk-ai
                      name: Team Analytics by CodeMonk.ai
                      url: >-
                        https://www.producthunt.com/posts/team-analytics-by-codemonk-ai
                      alias: team-analytics-by-codemonk-ai
                      launch_id: '434333'
                      rank: 2
                      tagline: >-
                        Uncover gaps in your tech team and hire the best fit
                        with AI
                      votes_count: 279
                      comments_count: 264
                      topics:
                        - name: Hiring
                          slug: hiring
                          url: https://www.producthunt.com/topics/hiring
                        - name: Freelance
                          slug: freelance
                          url: https://www.producthunt.com/topics/freelance
                      image: >-
                        https://ph-files.imgix.net/34c51888-34fb-4b51-b6e9-9ec03661319d.png?auto=format&fit=crop&w=128&h=128
                      product_slug: codemonk
                      product_url: https://www.producthunt.com/products/codemonk
                      featured_at: '2024-01-15T03:59:30-08:00'
                  total_found: null
                  page_count: 1
                  blocked: false
                  proxy_traffic_bytes: 32196
                total_points: 2
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '402':
          description: Payment Required
        '500':
          description: Internal Error
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.