Research

Operations

• Research a niche

  POST/v1/research

  1,036 credits covering up to 50 enriched videos, then 20 credits each, whether the analysis is fresh or already stored, so at most 4,036 credits at max_videos 200. Failed videos are never charged. The 402 pre-check uses that worst case.

• Get a research

  GET/v1/research/{id}

  Free, forever. Collection is the only thing charged.

• List a research's videos

  GET/v1/research/{id}/videos

  Free, forever, filtered or not. Collection is the only thing charged.

• List a research's creators

  GET/v1/research/{id}/creators

  Free, forever, filtered or not. Collection is the only thing charged.

• List a research's hashtags

  GET/v1/research/{id}/hashtags

  Free, forever, filtered or not. Collection is the only thing charged.

• List a research's sounds

  GET/v1/research/{id}/sounds

  Free, forever, filtered or not. Collection is the only thing charged.

• Read a research's digest

  GET/v1/research/{id}/digest

  Free, forever. Collection is the only thing charged.

• Refresh a research's videos

  POST/v1/research/{id}/refresh

  3 credits per video that comes back.