출력 테이블에서 실제로 쓸 수 있는 필드는 무엇인가요?

Reddit Extract의 작은 PostgreSQL 응답을 살펴보세요. 제목과 본문을 구분하고 누락값을 보존한 뒤 로컬 출력 규칙을 정합니다.

요청 예제

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3"

가상 응답 예시 발췌

설명용 예시이며 실제 아카이브 레코드가 아닙니다.

{
  "data": [
    {
      "kind": "post",
      "subreddit": "PostgreSQL",
      "title": "Demo: checking an index",
      "text": "Fictional example for mapping available fields."
    }
  ]
}

data만 표시했습니다. 반환되는 필드는 다를 수 있으며 전체 응답이 아닙니다.

작은 PostgreSQL 요청으로 테이블의 전제를 확인하기

PostgreSQL 자료를 담는 테이블은 본문을 요구하지만 조회한 레코드에는 쓸 만한 제목만 있을 수 있습니다. 대량 조회 전에 이 차이를 어떻게 처리할지 정하세요. 작은 index 검색은 복사할 값, 누락 상태로 둘 값, 검토 대상으로 남길 레코드를 결정하는 출발점입니다.

Reddit Extract는 과거 Reddit 아카이브에 접근하는 독립 API입니다. Reddit의 공식 서비스나 제휴 서비스가 아니며 실시간 자료를 제공하지 않습니다. 데이터 변환 개발자는 작은 응답에서 실제 필드와 값을 확인한 다음 필요한 출력 열을 설계할 수 있습니다. 모든 레코드에 같은 필드나 자료형이 있다는 보장은 없습니다. 일관된 출력 구조는 서버가 아니라 여러분의 변환 규칙에서 정의합니다.

시작 예제는 GET https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3 입니다. q=index는 제목과 본문을 대상으로 하는 텍스트 검색 조건이고 subreddit은 커뮤니티를 선택하며 limit=3은 최대 세 개 레코드를 요청합니다. 더 적거나 빈 결과도 가능합니다. 이 주소는 특정 게시물의 존재나 실행한 응답을 제시하지 않습니다. Authorization: Bearer YOUR_API_KEY 또는 X-API-Key: YOUR_API_KEY를 사용하고 실제 키는 신뢰할 수 있는 서버에서만 설정하세요.

제목이 저절로 본문을 대신하지는 않습니다

title과 text가 있으면 먼저 별도로 살펴보세요. 나중에 한 열로 합친다면 가공한 내용임을 표시하고 어느 필드에서 왔는지 남깁니다. 제목이 index와 일치한다고 본문에도 그 단어가 있다는 뜻은 아닙니다. 제목을 대체값으로 쓰는 것은 애플리케이션의 선택이며, 이를 원래 본문이라고 표시해서는 안 됩니다.

반환된 레코드를 하나씩 살펴보며 필드 이름, 관찰한 자료형과 누락 여부를 적으세요. id, kind, 텍스트나 시각 항목이 실제로 있다면 필요한 출력 열에 연결할 수 있습니다. 첫 레코드만 보고 모든 자료가 같은 모양이라고 가정하면 안 됩니다. 작은 예제는 매핑 규칙을 시험하는 출발점이지 전체 아카이브의 스키마를 증명하는 표본이 아닙니다.

누락된 값의 처리 방법 결정하기

필드가 없는 상태, 명시적인 null, 빈 문자열과 숫자 0은 서로 다릅니다. 출력 열의 필수 여부와 각 상태를 어떻게 저장할지 먼저 정하세요. 없는 값을 빈 문자열로 모두 바꾸면 원래 차이를 잃습니다. 대상 시스템이 값을 요구하더라도 내용을 추측해서 채우지 마세요. 제외하거나 별도로 검토할 레코드와 그 이유를 남기는 방식도 선택할 수 있습니다.

식별자를 계산용 숫자로 바꾸면 표현을 잃을 수 있습니다. 시각 항목은 단위와 실제 자료형을 확인한 뒤 변환하고, 숫자처럼 보이는 문자열도 오류 처리 규칙을 정해 다루세요. 원래 값과 정규화된 값을 구분하면 어떤 변경을 했는지 확인할 수 있습니다. 공백 정리, 열 선택과 자료형 변환은 로컬 작업입니다. API가 출력 스키마를 내보내거나 품질 검사를 대신하지 않습니다.

대화를 만들어 내지 않고 참조 보존하기

응답은 플랫 레코드이며 서버가 대화 트리를 조립하지 않습니다. parent_id와 link_id가 실제로 있다면 관계 분석을 위한 로컬 그룹화는 선택 사항입니다. 단순히 텍스트를 읽거나 열을 고르는 작업에 트리가 필요한 것은 아닙니다. 그룹화는 빠진 부모나 대화 전체를 복원하지 않습니다. 출력 파일의 형식이 일정해도 원본 자료가 완전하다는 의미는 아닙니다.

요청당 최대 100개 레코드와 쿼리당 최대 100페이지라는 상한이 있습니다. _doc 문서 순서는 시간순, 관련도순이나 점수순이 아닙니다. min_score는 최소 점수 필터이며 정렬 기능이 아닙니다. 페이지를 반복하거나 날짜를 나누고 중복을 제거해도 모든 일치 자료를 받았다고 증명할 수 없습니다. 사용한 조건과 실제 저장 건수, 조회 시각 및 중단 이유를 별도로 기록하세요.

필드 검토를 실행 가능한 규칙으로 마무리하기

성공한 조회는 빈 결과도 한 크레딧입니다. 성공 요청 1,000건은 $1이고 최소 $50 충전은 유료 50,000크레딧입니다. 구독제가 아니며 유료 크레딧은 만료되지 않습니다. 시험용 100크레딧은 네트워크 전체의 남용 방지 자격 조건에 따릅니다. 저장한 응답을 다시 변환하는 일은 새 조회가 아니지만 같은 페이지를 API에서 성공적으로 다시 받으면 추가 비용이 듭니다.

첫 검토의 결과는 각 열의 출처, 허용 상태와 제외 방법을 정리한 짧은 규칙입니다. 가이드에서는 저장한 응답으로 그 결정을 시험합니다. 조회 매개변수는 문서에서 확인하고, 서버에서 요청할 준비가 되면 키 페이지에서 접근을 설정하세요.