Calling the search endpoint now returns a feed object with a categories property. This

Categories documentation about docs-api HOT 5 CLOSED

podcastindex-org commented on July 20, 2024

Categories documentation

from docs-api.

Comments (5)

daveajones commented on July 20, 2024 1

Bingo. That's the idea. I'm working on the category filtering code now. So those values will come in useful once that work is complete.

from docs-api.

RyanHirsch commented on July 20, 2024 1

The endpoint https://api.podcastindex.org/api/1.0/categories/list returns all categories.

This is the current (11/16/2020) return of that endpoint:

{
  "status": "true",
  "feeds": [
    { "id": 1, "name": "Arts" },
    { "id": 2, "name": "Books" },
    { "id": 3, "name": "Design" },
    { "id": 4, "name": "Fashion" },
    { "id": 5, "name": "Beauty" },
    { "id": 6, "name": "Food" },
    { "id": 7, "name": "Performing" },
    { "id": 8, "name": "Visual" },
    { "id": 9, "name": "Business" },
    { "id": 10, "name": "Careers" },
    { "id": 11, "name": "Entrepreneurship" },
    { "id": 12, "name": "Investing" },
    { "id": 13, "name": "Management" },
    { "id": 14, "name": "Marketing" },
    { "id": 15, "name": "Non-Profit" },
    { "id": 16, "name": "Comedy" },
    { "id": 17, "name": "Interviews" },
    { "id": 18, "name": "Improv" },
    { "id": 19, "name": "Stand-Up" },
    { "id": 20, "name": "Education" },
    { "id": 21, "name": "Courses" },
    { "id": 22, "name": "How-To" },
    { "id": 23, "name": "Language" },
    { "id": 24, "name": "Learning" },
    { "id": 25, "name": "Self-Improvement" },
    { "id": 26, "name": "Fiction" },
    { "id": 27, "name": "Drama" },
    { "id": 28, "name": "History" },
    { "id": 29, "name": "Health" },
    { "id": 30, "name": "Fitness" },
    { "id": 31, "name": "Alternative" },
    { "id": 32, "name": "Medicine" },
    { "id": 33, "name": "Mental" },
    { "id": 34, "name": "Nutrition" },
    { "id": 35, "name": "Sexuality" },
    { "id": 36, "name": "Kids" },
    { "id": 37, "name": "Family" },
    { "id": 38, "name": "Parenting" },
    { "id": 39, "name": "Pets" },
    { "id": 40, "name": "Animals" },
    { "id": 41, "name": "Stories" },
    { "id": 42, "name": "Leisure" },
    { "id": 43, "name": "Animation" },
    { "id": 44, "name": "Manga" },
    { "id": 45, "name": "Automotive" },
    { "id": 46, "name": "Aviation" },
    { "id": 47, "name": "Crafts" },
    { "id": 48, "name": "Games" },
    { "id": 49, "name": "Hobbies" },
    { "id": 50, "name": "Home" },
    { "id": 51, "name": "Garden" },
    { "id": 52, "name": "Video-Games" },
    { "id": 53, "name": "Music" },
    { "id": 54, "name": "Commentary" },
    { "id": 55, "name": "News" },
    { "id": 56, "name": "Daily" },
    { "id": 57, "name": "Entertainment" },
    { "id": 58, "name": "Government" },
    { "id": 59, "name": "Politics" },
    { "id": 60, "name": "Buddhism" },
    { "id": 61, "name": "Christianity" },
    { "id": 62, "name": "Hinduism" },
    { "id": 63, "name": "Islam" },
    { "id": 64, "name": "Judaism" },
    { "id": 65, "name": "Religion" },
    { "id": 66, "name": "Spirituality" },
    { "id": 67, "name": "Science" },
    { "id": 68, "name": "Astronomy" },
    { "id": 69, "name": "Chemistry" },
    { "id": 70, "name": "Earth" },
    { "id": 71, "name": "Life" },
    { "id": 72, "name": "Mathematics" },
    { "id": 73, "name": "Natural" },
    { "id": 74, "name": "Nature" },
    { "id": 75, "name": "Physics" },
    { "id": 76, "name": "Social" },
    { "id": 77, "name": "Society" },
    { "id": 78, "name": "Culture" },
    { "id": 79, "name": "Documentary" },
    { "id": 80, "name": "Personal" },
    { "id": 81, "name": "Journals" },
    { "id": 82, "name": "Philosophy" },
    { "id": 83, "name": "Places" },
    { "id": 84, "name": "Travel" },
    { "id": 85, "name": "Relationships" },
    { "id": 86, "name": "Sports" },
    { "id": 87, "name": "Baseball" },
    { "id": 88, "name": "Basketball" },
    { "id": 89, "name": "Cricket" },
    { "id": 90, "name": "Fantasy" },
    { "id": 91, "name": "Football" },
    { "id": 92, "name": "Golf" },
    { "id": 93, "name": "Hockey" },
    { "id": 94, "name": "Rugby" },
    { "id": 95, "name": "Running" },
    { "id": 96, "name": "Soccer" },
    { "id": 97, "name": "Swimming" },
    { "id": 98, "name": "Tennis" },
    { "id": 99, "name": "Volleyball" },
    { "id": 100, "name": "Wilderness" },
    { "id": 101, "name": "Wrestling" },
    { "id": 102, "name": "Technology" },
    { "id": 103, "name": "True Crime" },
    { "id": 104, "name": "TV" },
    { "id": 105, "name": "Film" },
    { "id": 106, "name": "After-Shows" },
    { "id": 107, "name": "Reviews" }
  ],
  "count": 107,
  "description": "Categories list."
}

My typescript client defines the endpoint return as:

  export interface Categories {
    status: ApiResponse.Status;
    feeds: Array<Category>;
    count: number;
    description: string;
  }

  export interface Category {
    id: number;
    name: string;
  }

from docs-api.

daveajones commented on July 20, 2024

Sorry about that. The documentation is lagging behind a bit during this category work. The index is the category id, and the value is the category name. I'm finishing this stuff up now, but I don't expect that to change unless everyone thinks it's a bad design. I figured exposing the category ids would allow calling with names or ids in the future.

from docs-api.

RyanHirsch commented on July 20, 2024

No worries, I was just wondering if there was a place I could look through in code to understand. It sounds like the appropriate action is to take the values (string) and treat them as a list of categories if my aim is to simply display them to a user. The ids would be used for any further querying by category id.

Thank you for all of this work.

from docs-api.

Capossito commented on July 20, 2024

in the meantime, what are the current categories? can we have a list with the respective ids?

from docs-api.

Categories documentation about docs-api HOT 5 CLOSED

Comments (5)

Related Issues (20)

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent